> ## Documentation Index
> Fetch the complete documentation index at: https://docs.livingsecurity.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Configurer une intégration

> Préparez les identifiants du fournisseur, connectez un système pris en charge, activez ses flux de données et vérifiez la première synchronisation réussie.

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

| Rôle | Responsabilité |
| - | - |
| [**Responsable du programme**](/fr-CA/reference/glossary#responsable-du-programme) | Sélectionne la source, la connecte dans Living Security, active les flux et vérifie le résultat |
| [**Administrateur système**](/fr-CA/reference/glossary#administrateur-syst%C3%A8me) | Crée ou approuve les identifiants et les portées dans le système source |

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.

<Warning>
  Ne copiez pas les autorisations d'un autre fournisseur et n'accordez pas
  un accès en écriture étendu « au cas où ». Des autorisations manquantes
  produisent normalement une erreur 401 ou 403 explicite qui peut être
  corrigée; des autorisations excessives créent un risque évitable.
</Warning>

## 2. Connecter le fournisseur

<Steps>
  <Step title="Ouvrir le Catalogue">
    Accédez à **Paramètres → Intégrations → Catalogue** et sélectionnez le fournisseur.
  </Step>

  <Step title="Démarrer la connexion">
    Sélectionnez **Connecter**. Effectuez le flux OAuth ou saisissez les champs
    demandés dans la boîte de dialogue de connexion. Le guide du fournisseur
    indique l'origine de chaque valeur.
  </Step>

  <Step title="Terminer l'authentification">
    Approuvez l'écran de consentement du fournisseur, le cas échéant. Une fois l'authentification réussie, Living Security ouvre la nouvelle connexion ou l'affiche sous **Connecté**.
  </Step>
</Steps>

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.

<Steps>
  <Step title="Vérifier l'état de la connexion">
    Confirmez que la connexion est saine et qu'elle ne demande pas de réautorisation.
  </Step>

  <Step title="Vérifier l'état du flux">
    Confirmez que le flux requis est activé et non suspendu.
  </Step>

  <Step title="Examiner la dernière exécution">
    Ouvrez le flux, le lien de synchronisation de la connexion ou **Paramètres** → **Intégrations** → **Synchronisations**. Attendez un résultat final réussi et examinez les erreurs du fournisseur et le nombre d'enregistrements, lorsqu'ils sont disponibles.
  </Step>

  <Step title="Confirmer les données en aval">
    Ouvrez la section Living Security concernée. Les données d'identité devraient générer les personnes et les identités attendues dans Effectif; les données des sources de sécurité devraient apparaître dans la fonctionnalité documentée par ce fournisseur.
  </Step>
</Steps>

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 :

| Section | Contenu |
| - | - |
| **En-tête** | Nom de la synchronisation, badge d'état et fournisseur de l'intégration |
| **Statistiques** | Modèle, dernière synchronisation, exécutions terminées et nombre total d'enregistrements |
| **Historique d'exécution** | Exécutions récentes avec état, durée et nombre d'enregistrements |
| **Activité d'action** | **Rafraîchir**, **Suspendre** / **CV** et **Synchroniser maintenant** |

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 :

| Opération | Effet |
| - | - |
| **Synchroniser maintenant** | Demande une exécution immédiate pour le flux sélectionné |
| **Suspendre le flux** | Arrête les nouvelles exécutions de ce flux tout en conservant la connexion |
| **Suspendre la connexion** | Arrête l'activité prise en charge de la connexion sans supprimer la configuration |
| **CV** | Redémarre un flux ou une connexion suspendu |
| **Réautoriser** | Répète l'authentification après une modification des identifiants ou du consentement |
| **Supprimer** | Supprime la configuration de la connexion après confirmation |

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](/fr-CA/integrations/custom-push-source). 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

| Symptôme | Vérification |
| - | - |
| `401 Unauthorized` | Valeur des identifiants, expiration, révocation, locataire du fournisseur et état de réautorisation |
| `403 Forbidden` | Rôle requis chez le fournisseur, portées, consentement de l'administrateur et politique d'accès du système source |
| La connexion échoue immédiatement | URL de redirection, région, URL source, exigences de réseau ou de liste d'autorisation d'adresses IP |
| La connexion est saine, mais aucune exécution n'a lieu | Le flux requis est activé et le fournisseur expose ce flux |
| Une exécution réussie ne renvoie aucun enregistrement | Le compte source voit la population attendue et les filtres côté fournisseur sont corrects |
| Les données apparaissent sous la mauvaise personne | Les attributs d'identité et les alias sont cohérents entre les sources connectées |
| Les données ne sont plus mises à jour | Le flux ou la connexion est suspendu, les identifiants ont expiré ou la dernière exécution a échoué |

Lorsque vous communiquez avec le [soutien de Living Security](mailto:support@livingsecurity.com), 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

<CardGroup cols={2}>
  <Card title="Aperçu des intégrations" icon="grid-2" href="/fr-CA/integrations/overview">
    Référence pour Connecté, Catalogue, Synchronisations, Activité d'action et Télécharger.
  </Card>

  <Card title="Mappage des données" icon="arrows-left-right" href="/fr-CA/integrations/managing/data-mapping">
    Comprendre les attributs et les mappages pris en charge, lorsqu'ils sont disponibles.
  </Card>

  <Card title="Cycle de vie d'une intégration" icon="route" href="/fr-CA/integrations/managing/lifecycle">
    Exploiter une intégration existante, de la réautorisation à la suppression.
  </Card>

  <Card title="Intégration initiale de l'administrateur" icon="circle-check" href="/fr-CA/getting-started/onboarding">
    Effectuer les tâches de vérification des données d'identité et de sécurité.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.