> ## 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 associées</h2>
    <ul>
      <li>
        <a href="/fr/signals/data-sources">Découvrez comment les données d'intégration deviennent des signaux de Human Risk Management</a>
      </li>
      <li>
        <a href="https://www.livingsecurity.com/integrations">Découvrir 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 d'elles 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 de ces 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/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 les conseils de dépannage.
  </Note>;

export const ConnectInPlatform = ({tile, children}) => <Step title="Saisissez les identifiants dans la Living Security Platform">
    <p>
      À effectuer par la personne disposant d'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 vignette{' '}
        <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 à votre administrateur {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 en est chargée. Celle-ci réalise la partie A et vous remet les identifiants
      (ou les saisit directement si vous l'avez invitée sur la plateforme).
      {recommendDelegated && <>
          {' '}Comme la configuration génère des clés sensibles, nous recommandons de privilégier la{' '}
          <strong>configuration déléguée</strong>, afin que le secret ne vous soit jamais transmis.
        </>}
    </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 quelques 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 [la manière dont les données d'intégration deviennent des signaux](/fr/signals/data-sources).

## Ce dont Living Security a besoin

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

**Portées :** aucune à configurer — les jetons de l'API Reporting de KnowBe4 sont en lecture seule par conception et ne sont associés à aucune portée. Le jeton donne un accès en lecture aux utilisateurs, aux inscriptions aux formations et aux résultats des tests de sécurité par hameçonnage, soit 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 Reporting et générer des jetons.

***

## Partie A — Dans KnowBe4

*Votre administrateur KnowBe4 effectue ces étapes.*

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

    Donnez au jeton une finalité descriptive (par exemple, `Living Security Platform`) si votre console vous le demande.

    <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é (par exemple, un coffre-fort de mots de passe ou un gestionnaire de secrets). Si vous quittez la page sans la copier, vous devrez générer un nouveau jeton.
    </Warning>

    <Note>
      L'API Reporting 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 le calcul des scores 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 permet de restreindre l'accès à l'API Reporting à 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/integrations/managing/egress-ip-addresses) à la liste d'autorisation. Les quatre mêmes 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 traduit généralement par `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 quelconque à cette liste, vous devez également y ajouter les plages de Living Security, faute de quoi 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 restent rares. Si les synchronisations de données se mettent à échouer alors qu'elles fonctionnaient auparavant, consultez [Configuration des adresses IP de sortie des intégrations](/fr/integrations/managing/egress-ip-addresses) et vérifiez que la liste Allowed IP Addresses correspond.
    </Note>
  </Step>

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

    | Région | Hôte de l'API Reporting |
    | - | - |
    | É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 contactez votre administrateur KnowBe4.

    <Note>
      Ces cinq régions sont celles que Living Security peut atteindre. Si votre compte KnowBe4 se trouve sur un autre serveur (par exemple une instance US Government), contactez l'assistance 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 Reporting obtenu à la partie A, étape 1 |
    | **Région du serveur de l'API Reporting** | La région identifiée à la partie A, étape 3 (par exemple, États-Unis) |
  </ConnectInPlatform>
</Steps>

Vous êtes désormais connecté à KnowBe4.

***

## Dépannage

<AccordionGroup>
  <Accordion title="401 Unauthorized">
    Le jeton d'API est invalide ou a 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 accès à l'API Reporting, soit l'adresse IP de la requête ne figure pas dans la liste Allowed IP Addresses. Vérifiez que l'API Reporting est activée et que les quatre [adresses IP de sortie de Living Security](/fr/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 Reporting 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.