> ## 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.

# Configuration de l'intégration KnowBe4

> Connectez KnowBe4 à la Living Security Platform pour importer les utilisateurs, les inscriptions aux formations et les résultats des tests de sécurité par hameçonnage.

export const PublicIntegrationNextSteps = () => <>
    <hr />
    <h2>Ressources connexes</h2>
    <ul>
      <li>
        <a href="/fr-CA/signals/data-sources">Découvrez comment les données d'intégration deviennent des signaux de gestion des risques humains</a>
      </li>
      <li>
        <a href="https://www.livingsecurity.com/integrations">Découvrez les intégrations de Living Security</a>
      </li>
      <li>
        <a href="https://app.livingsecurity.ai/">Ouvrir la Living Security Platform</a>
      </li>
      <li>
        <a href="https://www.livingsecurity.com/request-demo/">Demander une démonstration de Living Security</a>
      </li>
    </ul>
  </>;

export const EgressIpSafelist = ({system}) => <Note>
    <strong>Ajoutez les quatre adresses IP de sortie de synchronisation de Living Security</strong> à la liste d'autorisation dans{' '}
    {system}. Saisissez chacune comme un hôte unique avec <code>/32</code> si {system} attend la notation CIDR :
    <br />
    <code>52.34.139.153/32</code>, <code>54.69.127.183/32</code>, <code>44.247.133.183/32</code>,{' '}
    <code>52.26.211.56/32</code>
    <br />
    <br />
    Le trafic peut provenir de n'importe laquelle des quatre adresses; n'en autoriser que certaines entraîne donc des échecs de
    synchronisation intermittents. Ces quatre adresses sont les mêmes dans toutes les régions de Living Security. Consultez{' '}
    <a href="/fr-CA/integrations/managing/egress-ip-addresses">
      Configuration des adresses IP de sortie des intégrations
    </a>{' '}
    pour obtenir la liste complète, la politique de modification et des conseils de dépannage.
  </Note>;

export const ConnectInPlatform = ({tile, children}) => <Step title="Saisissez les identifiants dans la Living Security Platform">
    <p>
      Cette étape est réalisée par la personne qui détient un accès à Living Security — le responsable du programme, ou l’administrateur système
      s’il a été invité (configuration déléguée).
    </p>
    <ol>
      <li>
        Accédez à <strong>Paramètres → Intégrations → Catalogue</strong>, repérez la tuile{' '}
        <strong>{tile}</strong>, puis cliquez sur <strong>Connecter</strong>.
      </li>
      <li>
        Renseignez les champs ci-dessous, puis cliquez sur <strong>Connecter</strong>.
      </li>
    </ol>
    {children}
  </Step>;

export const SystemAdminBanner = ({system, recommendDelegated}) => <Note>
    <p>
      <strong>Ce guide s'adresse à l'administrateur ou à l'administratrice de {system}.</strong> Il explique comment créer des identifiants d'API dans {system}, ce qui nécessite un accès administrateur à {system}, et non à la
      Living Security Platform.
    </p>
    <p>
      Si vous êtes le <strong>responsable du programme</strong> Living Security et que vous n'administrez pas {system},
      transmettez cette page à la personne qui s'en charge. Cette personne effectue la partie A et vous remet les identifiants
      (ou les saisit directement si vous l'avez invitée dans la plateforme).
      {recommendDelegated && <>
          {' '}Comme la configuration produit du matériel de clés sensible, nous recommandons la procédure{' '}
          <strong>de configuration déléguée</strong>, afin que le secret ne vous soit jamais retransmis.
        </>}
    </p>
  </Note>;

<SystemAdminBanner system="KnowBe4" />

## Ce que cette intégration apporte

KnowBe4 peut fournir des résultats relatifs à l'effectif, à la formation et aux simulations d'hameçonnage. Voici des exemples examinés :

* `training.completed` — termine une formation en sécurité
* `training.past.due` — a une formation en retard
* `phishing.simulation.clicked` — a cliqué sur une simulation sans la signaler

Ces exemples illustrent les types d'activité normalisée que Living Security peut utiliser. Consultez [comment les données d'intégration deviennent des signaux](/fr-CA/signals/data-sources).

## Ce dont Living Security a besoin

| Identifiant | Description |
| - | - |
| **Clé API** | Un jeton porteur de l'API de rapports généré sous **Account Settings → API**. Il est envoyé avec chaque requête dans l'en-tête `Authorization: Bearer`. |
| **Région du serveur de l'API de rapports** | La région dans laquelle votre compte KnowBe4 est provisionné, à sélectionner dans une liste (États-Unis, UE, Canada, Royaume-Uni, Allemagne). |

**Portées :** Aucune à configurer — les jetons de l'API de rapports de KnowBe4 sont en lecture seule par conception et n'ont pas de portée. Le jeton accorde un accès en lecture aux utilisateurs, aux inscriptions aux formations et aux résultats des tests de sécurité par hameçonnage, ce qui correspond exactement à ce que lit la synchronisation.

**Rôle requis :** **Account Admin** dans KnowBe4 (seuls les administrateurs de compte peuvent accéder à **Account Settings → API**)

### Prérequis

* Vous devez être connecté à votre console KnowBe4 avec le rôle **Account Admin**. Seuls les administrateurs de compte peuvent accéder à **Account Settings → API** pour activer l'API de rapports et générer des jetons.

***

## Partie A — Dans KnowBe4

*Votre administrateur KnowBe4 effectue ces étapes.*

<Steps>
  <Step title="Activer l'API de rapports et générer un jeton">
    1. Connectez-vous à votre console KnowBe4.
    2. Cliquez sur le nom de votre compte dans le coin supérieur droit, puis sélectionnez **Account Settings**.
    3. Dans la navigation de gauche, sélectionnez **API**.
    4. Activez la **Reporting API** si elle ne l'est pas déjà, puis générez un nouveau jeton d'API.

    Donnez au jeton un objet descriptif (p. ex. `Living Security Platform`) si votre console vous en demande un.

    <Warning>
      KnowBe4 affiche la valeur du jeton d'API **une seule fois**, au moment de sa génération. Copiez-la immédiatement et conservez-la dans un emplacement sécurisé (p. ex. un coffre-fort de mots de passe ou un gestionnaire de secrets). Si vous quittez la page sans l'avoir copiée, vous devrez générer un nouveau jeton.
    </Warning>

    <Note>
      L'API de rapports est en lecture seule. Elle expose les utilisateurs, les inscriptions aux formations et les résultats des tests de sécurité par hameçonnage — les données que Living Security ingère pour la notation et la production de rapports. Aucun accès en écriture n'est requis.
    </Note>
  </Step>

  <Step title="Ajouter les adresses IP de sortie de Living Security à la liste Allowed IP Addresses">
    KnowBe4 vous permet de restreindre l'accès à l'API de rapports à un ensemble précis d'adresses IP sources. Ce paramètre se trouve au même endroit que le jeton :

    1. Dans votre console KnowBe4, accédez à **Account Settings → API → Allowed IP Addresses**.
    2. Ajoutez chaque [adresse IP de sortie de Living Security](/fr-CA/integrations/managing/egress-ip-addresses) à la liste d'autorisation. Les mêmes quatre adresses s'appliquent dans toutes les régions.

    <EgressIpSafelist system="KnowBe4" />

    <Warning>
      **Si la liste Allowed IP Addresses est configurée, elle est appliquée au niveau du réseau.** La boîte de dialogue de connexion réussira au moment de l'authentification, mais les synchronisations de données échoueront (bloquées au niveau du réseau, ce qui se manifeste généralement par un `403`) tant que les adresses IP de sortie de Living Security n'auront pas été ajoutées à la liste d'autorisation. Si vous ajoutez une adresse à cette liste, vous devez également y ajouter les plages de Living Security; sinon, nos requêtes seront rejetées même si votre jeton est valide.
    </Warning>

    <Note>
      Les adresses IP de sortie de Living Security peuvent changer lors de mises à jour de l'infrastructure, bien que ces changements demeurent rares. Si les synchronisations de données se mettent à échouer après avoir fonctionné, consultez [Configuration des adresses IP de sortie des intégrations](/fr-CA/integrations/managing/egress-ip-addresses) et vérifiez que la liste Allowed IP Addresses correspond.
    </Note>
  </Step>

  <Step title="Identifier votre région de serveur KnowBe4">
    KnowBe4 fournit l'API de rapports à partir d'un hôte propre à chaque région. Vous sélectionnez votre région dans la boîte de dialogue de connexion plutôt que de saisir un nom d'hôte :

    | Région | Hôte de l'API de rapports |
    | - | - |
    | États-Unis | `us.api.knowbe4.com` |
    | Europe | `eu.api.knowbe4.com` |
    | Canada | `ca.api.knowbe4.com` |
    | Royaume-Uni | `uk.api.knowbe4.com` |
    | Allemagne | `de.api.knowbe4.com` |

    Si vous ne savez pas quelle région votre compte utilise, vérifiez le domaine de l'URL de votre console KnowBe4 ou communiquez avec votre administrateur KnowBe4.

    <Note>
      Ces cinq régions sont celles que Living Security peut joindre. Si votre compte KnowBe4 se trouve sur un autre serveur (par exemple une instance US Government), communiquez avec le soutien de Living Security avant de commencer la connexion.
    </Note>
  </Step>
</Steps>

***

## Partie B — Dans la Living Security Platform

*Le responsable du programme effectue cette étape, ou l'administrateur système en cas de configuration déléguée.*

<Steps>
  <ConnectInPlatform tile="KnowBe4">
    | Champ | Valeur |
    | - | - |
    | **Clé API** | Le jeton de l'API de rapports obtenu à la partie A, étape 1 |
    | **Région du serveur de l'API de rapports** | La région déterminée à la partie A, étape 3 (p. ex. États-Unis) |
  </ConnectInPlatform>
</Steps>

Vous êtes maintenant connecté à KnowBe4.

***

## Dépannage

<AccordionGroup>
  <Accordion title="401 Unauthorized">
    Le jeton d'API est invalide ou expiré. Vérifiez que le jeton est correct et qu'il n'a pas été régénéré sous **Account Settings → API**.
  </Accordion>

  <Accordion title="403 Forbidden">
    Soit le jeton n'a pas d'accès à l'API de rapports, soit l'adresse IP de la requête ne figure pas dans la liste Allowed IP Addresses. Vérifiez que l'API de rapports est activée et que les quatre [adresses IP de sortie de Living Security](/fr-CA/integrations/managing/egress-ip-addresses) figurent dans la liste d'autorisation.
  </Accordion>

  <Accordion title="Résultats vides (200 OK, mais aucune donnée)">
    L'API de rapports n'a peut-être pas encore de données à renvoyer, ou le compte associé au jeton n'a pas de visibilité sur les utilisateurs et les campagnes que Living Security ingère. Vérifiez que le jeton a été généré par un Account Admin.
  </Accordion>
</AccordionGroup>

<PublicIntegrationNextSteps />


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