Configurer une intégration

Ce guide décrit la procédure de configuration courante pour les 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 fiche Catalogue de ce fournisseur.

​

Prérequis

Ces rôles peuvent être assumés par 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 présumant 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 portées requises, les URL de redirection et les exigences de liste d’autorisation.
• Si les identifiants sont créés et saisis par des personnes différentes, utilisez le processus de partage de secrets approuvé par votre organisation.
• N’envoyez jamais de mots de passe, de secrets client, de clés privées ni de valeurs de clés d’accès par courriel ou dans une demande de soutien.

​

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 le 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 portées indiqués dans le guide du fournisseur.

​

2. Connecter le fournisseur

Si le fournisseur rejette l’authentification, arrêtez-vous et corrigez les identifiants, le locataire, 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 la finalité de chaque flux.
2. Activez uniquement les flux dont votre programme a besoin.
3. Laissez suspendus les flux sans rapport.
4. Utilisez Synchroniser maintenant, lorsque l’option est offerte, pour demander la première exécution.

Les fournisseurs n’offrent pas tous les mêmes flux ni les mêmes contrôles de planification. Suivez les contrôles affichés sur la connexion plutôt que de vous attendre à un assistant universel de fréquence, de portée, de mappage de champs, de brouillon ou d’activation.

​

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

L’authentification de la connexion ne prouve pas à elle seule que les données circulent. Pour l’intégration initiale, les tâches Vérifier la circulation des données d’identité et Vérifier la circulation des données d’intégration de la carte de parcours se terminent à partir des données ingérées. Ne remplacez pas ces résultats de vérification par une simple connexion enregistrée.

​

Page de détails d’une synchronisation

Depuis Paramètres → Intégrations → Synchronisations, ouvrez une synchronisation pour afficher au même endroit sa configuration et son historique d’exécution. La page de détails présente les éléments suivants : 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étails de sa connexion lorsque l’intégration répertorie des flux actifs.

​

Opérations sur la connexion

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

​

Sources d’envoi personnalisées

Utilisez Source d’envoi personnalisée lorsqu’un système envoie des données à Living Security plutôt que d’être interrogé par un connecteur du Catalogue.

1. Créez la source au bas du Catalogue.
2. Ouvrez sa page de détails dans la zone des envois personnalisés.
3. Sélectionnez le flux de destination.
4. Utilisez Télécharger CSV pour un lot manuel ou Envoyer par API pour un expéditeur automatisé.
5. Prévisualisez le fichier ou la charge utile et examinez l’historique d’exécution de la source après l’envoi.

Pour le contrat complet concernant le point de terminaison, l’authentification, la charge utile, les nouvelles tentatives et la vérification, consultez API de source d’envoi personnalisée. N’en déduisez pas ces détails à partir d’un ancien guide d’intégration Unify. Le module de téléchargement de la page de détails de la source accepte un fichier CSV source d’au plus 100 Mo. Avant le téléchargement, le Tableau de bord le divise côté client en requêtes d’au plus 10 Mo et 10 000 lignes chacune. Ce module propre à la source est distinct de la page générale Intégrations → Télécharger pour les modèles d’identité et d’activité.

​

Dépannage

Lorsque vous communiquez avec le soutien de 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