Inhoud
Voorbeeld inrichting OpenWave voor ontvangen ZGW-berichten
Inleiding
Hieronder een voorbeeld hoe OpenWave in te richten om ZGW-berichten om te kunnen zetten naar een zaak, een adres, een contact, extra eigenschappen en een geregistreerd document
Whitelist
De zender die de ZGW api gebruikt om berichten naar OpenWave te versturen moet gewhitelist worden op de juiste endpoints.
Zie Endpoints whitelist.
Achter de tegel Endpoints Whitelist op het beheerportaal (onder kolom gebruikers) zal minimaal een regel met het endpoint /api/zgw gedefinieerd moeten worden.
Bij dat endpoint kunnen vervolgens één of meer ip-adressen worden genoteerd waarvandaan de zender de berichten gaat versturen,
Robot medewerker
In de medewerkerstabel moet een (robot) medewerker worden aangemaakt met:
- Loginnaam (dvloginnaam) = de uit te reiken Username aan de zender
- Client secret bij loginnaam t.b.v. accesstoken (dvclientsecret) in het blok Login = het uit te reiken Password aan de zender. Let op: De ingetoetste waarde kan door OpenWave automatisch gecrypt worden opgeslagen indien Getal1 van de instelling Sectie: Encryption en Item: Method de waarde 3 heeft. Zie 2-way encryptie van externe wachtwoorden. Aan de zender moet dus de ongecrypte versie worden uitgereikt.
Met deze twee gegevens kan de zender een token opvragen aan OpenWave die de zender met elk bericht dient mee te sturen als authenticatie.
Bij de medewerkerskaart:
- vul de organisatienaam (dvorganisatie) met een benaming voor de ontvangende instantie (bijvoorbeeld OD Rommeldam e.o.)
- vul de achternaam van de robot (dvomschrijving) met een benaming voor de zendende instantie (bijvoorbeeld milieuklachten Gelderland)
- vul de kolom 1=robot, 2=browser, 3=beide (dnmaginapp) met 3 (beide)
- Voeg de robot toe aan een rechtengroep die minimaal het insertrecht op omgevingzaken heeft (tbomgrechten.dlomgins) indien de aangebracht zaken in tbomgvergunning kunnen worden opgeslagen.
- Voeg de robot (ook) toe aan een rechtengroep die minimaal het insertrecht op APV/Overige zaken heeft (tbovrechten.dlovvins) indien de aangebracht zaken in tbovvergunningen kunnen worden opgeslagen.
- kies bij de dropdownkolom Endpoint (robotmedewerker is gedefinieerd voor binnenkomende berichten op endpoint) (dnkeyendpointlist) in het blok Login voor de whitelist met de waarde /api/zgw
- De (robot)-medewerker moet in dienst zijn (vervaldatum leeg of > vandaag)