Webhooks authentifiés - configuration



Introduction

La plateforme Intent dispose d'un système de notification par appel de page distante, aussi appelé système de webhook. Le principe est qu'un tiers créé et déploie une page accessible

La configuration se fait via Forest pour chaque environnement.

Oauth2

Exemple de configuration Oauth2:

{
"client": {
"id": "b81a935f-XXXX-XXXX-XXXX-88fbdc6fe6fd",
"secret": "9e0029d1-XXXX-XXXX-XXXX-10338bdd52a5"
},
"auth": {
"tokenHost": "https://url.to.auth.provider.com",
"tokenPath": "/oauth2/token"
},
"grantType": "client_credentials",
"scope": "read"
}

BearerToken

Exemple de BearerToken
Lt4nF&f0PuVxv*30

BasicAuth

Exemple de BasicAuth:
d0098765337ef7757988d4b0df61a18f5a6da7d1=

Le BasicAuth est une version Base64 de la concaténation username:password du client. Il faut donc demander à ce que le client nous fournisse la version Base64 de son username:password (ce qui nous évite de le connaître en clair), ou alors le convertir nous même avec un outils existant ( https://www.base64encode.org/ ).

Donc par exemple, si le client nous fourni "aW50ZW50OnBhc3N3b3Jk" en username et "UHEEAIBJHSDBIAZEHUAB" en mot de passe, il faut donc renseigner YVc1MFpXNTBPbkJoYzNOM2IzSms6VUhFRUFJQkpIU0RCSUFaRUhVQUI= dans le champ basic auth de forest.

Transverse


Possibilité d'ajouter des headers à la requête de notification (pas celle d'authentification), dans le champ "headers" de Forest. Par exemple:
{
"x-api-key": "API_KEY"
}