À propos des points d'ancrage

2022-08-22Dernière mise à jour

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 ClearIDMC

Dans ClearID, les points d'ancrage peuvent être créés et utilisés pour notifier les API tierces qu'un événement particulier est survenu.
Page Points d'ancrage dans ClearID affichant le nom, l’URL, l’événement, la description et l'état de points d’ancrage Web.

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.

Page Informations de point d'ancrage dans ClearID affichant un événement Identité créée avec le bouton Télécharger le schéma.

Pour en savoir plus sur le téléchargement de schéma, voir Créer des points d'ancrage.

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.

Les journaux de point d’ancrage incluent les éléments suivants :
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.
Section Journaux de la page Informations sur le point d’ancrage dans ClearID affichant la date de callback, l’URL et l’état de la réponse.
REMARQUE : La section Journaux du point d’ancrage s’affiche uniquement à la fin des détails du point d’ancrage après le premier rappel.