Abonnementen toevoegen¶
Om te kunnen beginnen met het definiëren van Abonnementen in Open Notificaties, zijn de volgende zaken nodig (naast Open Notificaties zelf):
Een Autorisaties API
Een component dat notificaties kan versturen naar Open Notificaties (in deze handleiding is dit de Autorisaties API)
Een component dat notificaties kan ontvangen via een webhook callback (beveiligd met JWT authenticatie)
Vastleggen credentials¶
Allereerst moeten de credentials van alle componenten vastgelegd zijn in de Autorisaties API. Het gaat om de volgende credentials:
Er moet een
Applicatie
zijn die Open Notificaties de scopes autorisaties.lezen, notificaties.consumeren en notificaties.publiceren geeft.Er moet een
Applicatie
zijn die de API die notificaties gaat versturen (in dit geval Autorisaties API) de scope notificaties.publiceren geeft.
In het geval dat de Autorisaties API van Open Zaak gebruikt wordt, moeten er ook
Services
aangemaakt worden die gebruik maken van de aangemaakte Applicaties
,
zie Open Zaak documentatie.
Aanmaken kanaal¶
Vervolgens moet het Kanaal
, waarvoor de notificaties verstuurd gaan worden, aangemaakt worden
in de API van Open Notificaties. In het geval van Autorisaties API heet dit kanaal autorisaties.
In Open Zaak is er een makkelijke manier om kanalen te registreren, zie Open Zaak documentatie over kanalen
Aanmaken abonnement¶
Het abonnement kan aangemaakt worden door in het admininterface van Open Notificaties te navigeren naar Configuratie > Webhook subscriptions > Toevoegen.
Vul vervolgens het formulier in:
Kies bij Config de enige optie, namelijk het endpoint van de Open Notificaties API zelf
Vul bij Callback url de callback URL in van het component dat notificaties moet gaan ontvangen (de abonnee)
Vul bij Client ID het client ID in waarmee het JWT gemaakt wordt dat gebruikt wordt om de callback URL aan te spreken
Vul bij Client secret het client secret in waarmee het JWT gemaakt wordt dat gebruikt wordt om de callback URL aan te spreken
Vul bij Channels de kanalen in waarop geabonneerd moet worden (bijv.
autorisaties
)
Klik vervolgens op de Opslaan knop. Tot slot moet de webhook geregistreerd worden, dit gaat als volgt:
Vink de aangemaakte Webhook subscription aan in de lijst,
Klik op het dropdown menu Acties en selecteer
Register the webhooks
Klik op Uitvoeren
Vanaf nu zullen alle notificaties voor het gekozen Kanaal
doorgestuurd worden naar de geconfigureerde webhook.