Configurer une intégration

Ce guide décrit la procédure de configuration commune aux intégrations répertoriées sous Paramètres → Intégrations → Catalogue. Les champs, les autorisations et les étapes d’authentification propres à chaque fournisseur figurent dans le guide de configuration accessible depuis la carte du fournisseur dans le Catalogue.

​

Prérequis

Ces rôles peuvent être attribués à la même personne. La personne qui saisit les identifiants dans Living Security doit disposer d’un rôle d’administrateur autorisant la gestion des intégrations ; n’invitez pas un administrateur du système source dans Living Security en supposant simplement qu’il existe un rôle de configuration à portée restreinte. Avant de commencer :

• Choisissez l’organisation et l’environnement Living Security auxquels la connexion doit appartenir.
• Ouvrez le guide du fournisseur dans le Catalogue et relevez les périmètres d’autorisation requis, les URL de redirection et les exigences de liste d’autorisation.
• Utilisez le processus de partage de secrets approuvé par votre organisation si les identifiants sont créés et saisis par des personnes différentes.
• N’envoyez jamais de mots de passe, de secrets client, de clés privées ou de valeurs de clés d’accès par e-mail ou dans un ticket d’assistance.

​

1. Préparer les identifiants du fournisseur

Ouvrez Paramètres → Intégrations → Catalogue, repérez le fournisseur et lisez son guide de configuration avant de créer les identifiants. L’authentification auprès du fournisseur peut reposer sur un consentement OAuth, un jeton d’API, un identifiant client et un secret, un compte de service ou une autre méthode prise en charge par le fournisseur. Créez uniquement les identifiants et les périmètres d’autorisation mentionnés dans le guide du fournisseur.

​

2. Connecter le fournisseur

Si le fournisseur rejette l’authentification, arrêtez-vous et corrigez l’identifiant, le tenant, la région, l’URL de redirection ou les autorisations du système source avant de poursuivre.

​

3. Activer les flux de données

Ouvrez la connexion sous Paramètres → Intégrations → Connecté. Living Security détecte les modèles de synchronisation disponibles pour ce fournisseur et les répertorie sous forme de flux.

1. Examinez le nom et l’objectif de chaque flux.
2. Activez uniquement les flux dont votre programme a besoin.
3. Laissez les flux sans rapport suspendus.
4. Utilisez Synchroniser maintenant, lorsque l’option est disponible, pour demander la première exécution.

Tous les fournisseurs ne proposent pas les mêmes flux ni les mêmes commandes de planification. Suivez les commandes affichées sur la connexion plutôt que d’attendre un assistant universel de fréquence, de périmètre, de mappage de champs, de brouillon ou d’activation.

​

4. Vérifier la première exécution

L’authentification de la connexion ne suffit pas à prouver que les données circulent. Pour l’intégration initiale, les tâches Verify Identity Data Flowing et Verify Integration Data Flowing de la Journey Map se terminent à partir des données ingérées. Ne substituez pas une connexion enregistrée à ces résultats de vérification.

​

Page de détail d’une synchronisation

Depuis Paramètres → Intégrations → Synchronisations, ouvrez n’importe quelle synchronisation pour afficher au même endroit sa configuration et son historique d’exécution. La page de détail affiche : Utilisez Synchroniser maintenant pour déclencher une exécution immédiate lorsque la synchronisation est active. Les synchronisations suspendues doivent être reprises avant que de nouvelles exécutions planifiées ou manuelles ne démarrent. Vous pouvez également ouvrir une synchronisation depuis la page de détail de sa connexion lorsque l’intégration répertorie des flux actifs.

​

Opérations sur les connexions

La page de détail de la connexion expose les opérations prises en charge par l’intégration concernée : Supprimer une connexion n’équivaut pas à supprimer les données déjà ingérées depuis celle-ci. Consultez le guide du fournisseur ou contactez l’assistance si le comportement de conservation des données influe sur votre décision.

​

Sources Custom Push

Utilisez Custom Push Source lorsqu’un système envoie des données à Living Security au lieu d’être interrogé via un connecteur du Catalogue.

1. Créez la source depuis le bas du Catalogue.
2. Ouvrez sa page de détail dans la zone Custom Push.
3. Sélectionnez le flux de destination.
4. Utilisez Télécharger CSV pour un lot manuel ou Push via API pour un expéditeur automatisé.
5. Prévisualisez le fichier ou la charge utile, puis examinez l’historique d’exécution de la source après l’envoi.

Pour connaître l’ensemble des spécifications relatives au point de terminaison, à l’authentification, à la charge utile, aux nouvelles tentatives et à la vérification, consultez Custom Push Source API. Ne déduisez pas ces détails d’un ancien guide d’intégration Unify. Le module de téléchargement de la page de détail de la source accepte un fichier CSV source d’une taille maximale de 100 MB. Avant le téléchargement, le Tableau de bord le divise côté client en requêtes de 10 MB et 10,000 lignes au maximum chacune. Ce module de téléchargement propre à la source est distinct de la page générale Intégrations → Télécharger destinée aux modèles d’identité et d’activité.

​

Dépannage

Lorsque vous contactez l’assistance Living Security, indiquez l’organisation, le fournisseur, le nom de la connexion, le flux, l’heure de la dernière exécution et l’erreur affichée. N’incluez aucun secret.

​

Voir aussi