À propos des points d'ancrage

Points d'ancrage dans Genetec ClearID^MC

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.

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.

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.

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.