Un point d’ancrage est un lien de rappel HTTP défini par l’utilisateur. Un point d’ancrage peut être déclenché par un événement dans une application Web et être utilisé pour envoyer des données ou des notifications à une interface de programmation (API) tierce.
Points d'ancrage dans Genetec ClearID™
Par exemple, une notification contenant un lien vers des informations détaillées concernant une identité peut être envoyée par e-mail lorsqu’un évènement Identité mise à jour se produit, ou si vous souhaitez que d’autres parties prenantes soient notifiées après un évènement Demandes d’identité créées ou Demandes d’identité mises à jour.
Traitement de point d’ancrage
Une fois que le point d'ancrage est créé, le service webhook reste à l'écoute d'un sous-ensemble d’événements spécifiés provenant d'autres services ClearID. Lorsque l’évènement spécifié se produit, le service point d’ancrage notifie l’API spécifiée dans le champ URL de la section Détails du point d’ancrage.
Schémas d’évènement du point d’ancrage
Le schéma décrit l’objet qui est envoyé via le point d’ancrage et le contenu du schéma varie en fonction du type d’évènement spécifié. Le schéma d’évènement du point d’ancrage peut être téléchargé à partir de la section Évènement du point d’ancrage pour vous aider à comprendre la structure de données des évènements afin qu’ils puissent être récupérés et traités correctement du côté utilisateur de l’intégration du point d’ancrage.
Pour en savoir plus sur le téléchargement de schéma, voir Créer des points d'ancrage dans ClearID.
Journaux du point d’ancrage
Les propriétaires d’API tierces peuvent utiliser les journaux de point d’ancrage pour vérifier l’état de chaque demande de rappel HTTP envoyée à l’URL tierce et résoudre les problèmes liés aux points d’ancrage non reçus ou autres problèmes associés. Il peut s’agir, par exemple, de problèmes d’expéditeur, de problèmes de destinataire, etc.
- Date de rappel
- Date à laquelle le rappel a été envoyé (inclut des filtres de plage de dates).
- URL
- URL utilisée pour transférer la notification d’évènement de point d’ancrage à l’API (programme ou application) tierce correspondante.
- Réponse
- L’état de la réponse indique si le rappel HTTP a été reçu avec succès ou non par l’API tierce. L’état peut, par exemple, être accepté, requête incorrecte, erreur de serveur interne, etc.