> ## 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 Microsoft Entra ID

> Connectez Microsoft Entra ID à Living Security pour l'activité relative aux identités, aux connexions, aux risques, aux appareils et aux simulations d'attaque.

export const EgressIpAllowlistBothSets = ({system}) => <Warning>
    <strong>{system} nécessite deux ensembles d'adresses, et non un seul.</strong> Living Security génère le jeton d'accès de cette
    intégration sur sa propre infrastructure et l'actualise en continu; le trafic de configuration et le trafic de synchronisation proviennent donc de réseaux différents. Ajoutez les deux ensembles à la liste d'autorisation dans {system}, et
    conservez-les tous les deux : cette exigence ne s'applique pas uniquement à la configuration.
    <br />
    <br />
    <strong>Trafic de synchronisation de l'intégration</strong> — identique dans toutes les régions :
    <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 />
    <strong>Trafic de la plateforme</strong> — utilisez uniquement la ligne correspondant à la région qui héberge votre
    organisation :
    <br />
    États-Unis : <code>98.91.60.249/32</code>, <code>13.216.91.102/32</code>
    <br />
    Union européenne : <code>34.246.236.210/32</code>, <code>52.31.102.238/32</code>
    <br />
    <br />
    Si vous n'autorisez que l'ensemble de synchronisation, la configuration ne se termine jamais. Si vous n'autorisez que l'ensemble de la plateforme, la configuration réussit, mais chaque synchronisation échoue. Consultez{' '}
    <a href="/fr-CA/integrations/managing/egress-ip-addresses">
      Configuration des adresses IP de sortie des intégrations
    </a>{' '}
    pour connaître les deux signatures d'échec et la politique de modification.
  </Warning>;

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 HandoffPaths = () => <Tabs>
    <Tab title="Configuration déléguée (recommandée pour les secrets)">
      Invitez l'administrateur système dans la plateforme avec des autorisations limitées. Il saisit
      directement les identifiants; vous n'avez jamais à manipuler le secret.
    </Tab>
    <Tab title="Transmission des identifiants">
      Envoyez à l'administrateur la page du fournisseur. Il crée les identifiants et vous les
      retourne; vous les saisissez ensuite dans la boîte de dialogue Connect.
    </Tab>
  </Tabs>;

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="Microsoft Entra ID" />

<HandoffPaths />

## Ce que cette intégration apporte

Microsoft Entra ID peut fournir une activité normalisée relative aux identités, aux connexions, aux risques, aux appareils et aux simulations d'attaque. Voici quelques exemples examinés :

* `account.compromised` — compte signalé comme compromis
* `auth.login.unusual` — connexions depuis des contextes inhabituels
* `phishing.simulation.clicked` — a cliqué sur une simulation sans la signaler

Il s'agit d'exemples représentatifs et non d'une garantie que tous les événements sont disponibles dans chaque locataire. Consultez [comment les données d'intégration deviennent des signaux](/fr-CA/signals/data-sources).

## Ce dont Living Security a besoin

| Identifiant | Description |
| - | - |
| **ID de locataire** | L'UUID du répertoire (locataire) provenant de votre centre d'administration Microsoft Entra |
| **ID client** | L'UUID de l'application (client) attribué lors de l'enregistrement de l'application |
| **Clé secrète client** | Une clé secrète générée dans l'enregistrement de votre application — la boîte de dialogue de connexion nomme ce champ **Clé d'API** |
| **Hôte de l'API Graph** | Le nom d'hôte de Microsoft Graph (cloud commercial : `graph.microsoft.com`) |
| **Hôte d'autorité** | Le nom d'hôte de l'autorité Microsoft Entra (cloud commercial : `login.microsoftonline.com`) |

**Étendues (autorisations d'application) :**

| Autorisation | Utilisation |
| - | - |
| `User.Read.All` | Répertoire des utilisateurs |
| `SecurityAlert.Read.All` | Alertes de sécurité |
| `AuditLog.Read.All` | Journaux de connexion et détails d'inscription à l'AMF |
| `Policy.Read.ConditionalAccess` | Détails de l'accès conditionnel pour chaque connexion — quelles politiques ont été appliquées et quels contrôles d'octroi elles ont imposés. La détection de l'AMF en dépend |
| `AttackSimulation.Read.All` | Résultats d'Attack Simulation Training |
| `Device.Read.All` | Objets d'appareil Entra ID, y compris les appareils qu'Intune ne gère pas |
| `DeviceManagementManagedDevices.Read.All` | Appareils gérés par Intune |
| `IdentityRiskEvent.Read.All` | Détections de risques d'Identity Protection, y compris les identifiants divulgués |
| `GroupMember.ReadWrite.All` | **En option.** Actions d'appartenance aux groupes — permet à un guide d'intervention d'ajouter une personne à un groupe Microsoft Entra ID ou de l'en retirer |

### Vous décidez de ce que cette connexion peut faire

Cette connexion lit des données. Elle peut également *effectuer des actions* dans votre répertoire, mais uniquement si vous
choisissez de l'autoriser.

Toutes les autorisations ci-dessus, sauf la dernière, sont en lecture seule. Si vous n'accordez que celles-ci, la
connexion ne pourra jamais rien modifier dans votre locataire — la plateforme le détecte et
n'offre alors aucune action sur les groupes.

Ajoutez `GroupMember.ReadWrite.All` et les actions d'appartenance aux groupes deviennent disponibles dans
les guides d'intervention. Rien ne se déclenche de lui-même : vous devez encore choisir les groupes que la
plateforme peut modifier (voir ci-dessous) et créer un guide d'intervention qui les utilise.

Vous pouvez changer d'avis à tout moment. Il suffit d'ajouter ou de retirer une autorisation dans Microsoft Entra ID
et d'accorder de nouveau le consentement de l'administrateur — il n'est pas nécessaire de saisir de nouveau les identifiants dans la
plateforme, et vos synchronisations de données continuent de fonctionner pendant ce temps. Le changement prend effet en environ
une heure.

<Note>
  **Les actions d'appartenance aux groupes sont en outre limitées aux groupes que vous désignez.** Après
  la connexion, un administrateur choisit une liste d'autorisation explicite de groupes pour la connexion.
  Tant que cette liste n'existe pas, les actions sur les groupes ne sont pas disponibles, même si l'autorisation est accordée —
  par conséquent, `GroupMember.ReadWrite.All` ne signifie jamais « n'importe quel groupe du locataire ».

  Choisissez ces groupes avec soin : évitez tout groupe qui confère des rôles d'administration,
  un accès privilégié ou des droits de licence.
</Note>

**Rôle requis :** **Administrateur d'applications** ou **Administrateur général** dans Microsoft Entra ID

<Note>
  **Deux de ces autorisations ont été ajoutées récemment.** Si vous avez connecté Microsoft Entra ID avant qu'elles
  figurent dans cette liste, ajoutez-les à votre enregistrement d'application existant et **accordez de nouveau le consentement de l'administrateur** —
  Microsoft exige que le consentement soit accordé de nouveau chaque fois que des autorisations changent. Tous les autres flux de données
  continuent de fonctionner normalement entre-temps.

  `Policy.Read.ConditionalAccess` — sans cette autorisation, Microsoft retire les détails de l'accès
  conditionnel de chaque enregistrement de connexion. L'enregistrement indique toujours qu'une politique d'accès conditionnel a été
  respectée, mais la liste des politiques est vide. Rien n'échoue et aucun avertissement n'est émis : les données
  de connexion continuent d'arriver et la connexion reste saine. La plateforme ne peut tout simplement pas déterminer quelles connexions
  ont été satisfaites par l'authentification multifacteur; l'activité d'AMF provenant de cette connexion reste donc vide.

  `IdentityRiskEvent.Read.All` — la lecture des détections de risques exige également une licence **Microsoft Entra ID P1 ou
  P2**. La détection des identifiants divulgués est disponible à tous les niveaux, y compris P1; les
  détections premium sont signalées comme `generic` en dessous de P2.
</Note>

### Prérequis

* Vous devez disposer d'un accès **Administrateur d'applications** ou **Administrateur général** dans Microsoft Entra ID pour enregistrer des applications et accorder le consentement de l'administrateur.

***

## Partie A — Dans Microsoft Entra ID

*Votre administrateur Microsoft Entra ID effectue ces étapes.*

<Steps>
  <Step title="Enregistrer une nouvelle application">
    1. Connectez-vous au [centre d'administration Microsoft Entra](https://entra.microsoft.com).
    2. Dans la navigation de gauche, accédez à **Entra ID** → **App registrations**.
    3. Cliquez sur **New registration**.
    4. Saisissez un nom explicite pour l'application, par exemple `Living Security Platform`.
    5. Sous **Supported account types**, sélectionnez **Accounts in this organizational directory only**.
    6. Laissez **Redirect URI** vide — cette intégration utilise le flux des informations d'identification du client.
    7. Cliquez sur **Register**.

    Après l'enregistrement, notez les valeurs suivantes à partir de la page **Overview** :

    * **Application (client) ID**
    * **Directory (tenant) ID**
  </Step>

  <Step title="Ajouter les autorisations d'application Microsoft Graph">
    1. Sur la page **Overview** de votre application, cliquez sur **API permissions** dans le menu de gauche.
    2. Cliquez sur **Add a permission**.
    3. Sélectionnez **Microsoft Graph**.
    4. Sélectionnez **Application permissions**.
    5. Recherchez et sélectionnez chacune des autorisations ci-dessous, puis cliquez sur **Add permissions** :
       * `User.Read.All`
       * `SecurityAlert.Read.All`
       * `AuditLog.Read.All`
       * `Policy.Read.ConditionalAccess`
       * `AttackSimulation.Read.All`
       * `Device.Read.All`
       * `DeviceManagementManagedDevices.Read.All`
       * `IdentityRiskEvent.Read.All`
    6. Ajoutez `GroupMember.ReadWrite.All` **uniquement si** vous souhaitez que les guides d'intervention puissent modifier l'appartenance aux groupes. Omettez-la pour que cette connexion reste en lecture seule.

    <Note>
      Il s'agit des autorisations minimales pour tous les flux de données. Si vous prévoyez d'activer seulement certains flux, vous pouvez omettre les autorisations des flux que vous n'utiliserez pas.
    </Note>
  </Step>

  <Step title="Accorder le consentement de l'administrateur">
    Les autorisations d'application exigent le consentement explicite d'un administrateur.

    1. Sur la page **API permissions**, cliquez sur **Grant admin consent for \<your tenant name>**.
    2. Dans la boîte de dialogue de confirmation, cliquez sur **Yes**.
    3. Vérifiez que chaque autorisation affiche **Granted** dans la colonne **Status**.

    <Note>
      Si le bouton **Grant admin consent** est grisé, vous devez disposer des privilèges **Privileged Role Administrator** ou **Global Administrator**. Le consentement de l'administrateur doit être accordé de nouveau chaque fois que vous ajoutez de nouvelles autorisations.
    </Note>
  </Step>

  <Step title="Créer une clé secrète client">
    1. Sur la page **Overview** de votre application, cliquez sur **Certificates & secrets** dans le menu de gauche.
    2. Cliquez sur l'onglet **Client secrets**, puis sur **New client secret**.
    3. Saisissez une description (p. ex. `Living Security Platform`).
    4. Choisissez une date d'expiration conforme à votre politique de rotation.
    5. Cliquez sur **Add**.

    <Warning>
      **Copiez immédiatement la valeur de la clé secrète.** Microsoft Entra ID n'affiche la clé secrète client complète qu'une seule fois. Si vous quittez la page avant de la copier, vous devrez supprimer la clé secrète et en créer une nouvelle.
    </Warning>

    Conservez la clé secrète en lieu sûr. Définissez un rappel dans votre calendrier pour la renouveler avant son expiration — une clé secrète expirée entraîne l'échec des synchronisations avec `401 Unauthorized`.
  </Step>

  <Step title="Déterminer l'hôte de l'API Graph et l'hôte d'autorité">
    Pour la plupart des organisations utilisant le cloud commercial, utilisez les valeurs par défaut :

    | Champ | Valeur pour le cloud commercial |
    | - | - |
    | **Hôte de l'API Graph** | `graph.microsoft.com` |
    | **Hôte d'autorité** | `login.microsoftonline.com` |

    Pour les clouds gouvernementaux ou souverains, utilisez les points de terminaison appropriés à votre environnement.

    <Note>
      L'hôte de l'API Graph et l'hôte d'autorité doivent correspondre — les jetons émis par l'autorité d'un cloud ne sont pas valides pour le point de terminaison Graph d'un autre cloud.
    </Note>
  </Step>
</Steps>

***

## Partie B — Dans Living Security Platform

*Le responsable du programme effectue cette étape, ou l'administrateur système s'il a été invité dans la plateforme.*

<Steps>
  <ConnectInPlatform tile="Microsoft Entra ID (Client Credentials)">
    | Champ | Valeur |
    | - | - |
    | **Clé d'API** | La clé secrète client de la partie A, étape 4 |
    | **ID de locataire Azure** | Le Directory (tenant) ID de la partie A, étape 1 |
    | **ID client** | L'Application (client) ID de la partie A, étape 1 |
    | **Hôte de l'API Graph** | `graph.microsoft.com` (ou le point de terminaison de votre cloud) |
    | **Hôte d'autorité** | `login.microsoftonline.com` (ou le point de terminaison de votre cloud) |

    <img src="https://mintcdn.com/livingsecurity/oVkrOMkYmNevekTI/integrations/images/microsoft-entra-id-cc/connect-dialog.png?fit=max&auto=format&n=oVkrOMkYmNevekTI&q=85&s=2a192b0a28e753ad0e0bc0b640508136" alt="Boîte de dialogue de connexion de Living Security pour Microsoft Entra ID" style={{maxWidth: "450px"}} width="576" height="692" data-path="integrations/images/microsoft-entra-id-cc/connect-dialog.png" />
  </ConnectInPlatform>
</Steps>

Vous êtes maintenant connecté à Microsoft Entra ID (Client Credentials).

***

## Dépannage

<AccordionGroup>
  <Accordion title="401 Unauthorized">
    Les identifiants sont invalides ou expirés. Vérifiez les points suivants :

    1. La clé secrète client n'a pas expiré et n'a pas fait l'objet d'une rotation
    2. L'ID de locataire et l'ID client sont corrects
    3. L'hôte d'autorité correspond à votre environnement cloud
  </Accordion>

  <Accordion title="403 Forbidden">
    Il manque des autorisations à l'enregistrement de l'application, ou le consentement de l'administrateur n'a pas été accordé. Vérifiez les points suivants :

    1. Toutes les autorisations requises figurent sous **API permissions**
    2. Chaque autorisation affiche le statut **Granted** (coche verte)
    3. Le consentement de l'administrateur a été accordé après l'ajout des autorisations

    <Note>
      Si vous avez ajouté de nouvelles autorisations après le consentement initial, vous devez accorder de nouveau le consentement de l'administrateur.
    </Note>
  </Accordion>

  <Accordion title="Résultats vides pour certains flux de données">
    Il est possible que l'application n'ait pas l'autorisation propre à ce flux :

    * Aucun utilisateur → `User.Read.All` manquante
    * Aucune alerte de sécurité → `SecurityAlert.Read.All` manquante
    * Aucun journal de connexion → `AuditLog.Read.All` manquante
    * Aucun résultat de simulation d'attaque → `AttackSimulation.Read.All` manquante
    * Aucun appareil Entra ID → `Device.Read.All` manquante
    * Aucun appareil géré par Intune → `DeviceManagementManagedDevices.Read.All` manquante
    * Aucune détection de risque → `IdentityRiskEvent.Read.All` manquante, consentement de l'administrateur non accordé de nouveau
      après son ajout, ou le locataire est en dessous du niveau de licence minimal Microsoft Entra ID P1
  </Accordion>

  <Accordion title="La demande de jeton échoue avec invalid_client">
    L'hôte de l'API Graph et l'hôte d'autorité ne correspondent peut-être pas. Les deux doivent correspondre au même environnement cloud (commercial, gouvernemental, etc.).
  </Accordion>

  <Accordion title="Les actions sur les groupes n'apparaissent pas dans un guide d'intervention">
    Les actions d'appartenance aux groupes ne sont offertes que si ces trois conditions sont réunies :

    1. `GroupMember.ReadWrite.All` figure dans l'enregistrement de l'application, avec le consentement de l'administrateur accordé. Si vous l'avez ajoutée récemment, prévoyez jusqu'à une heure.
    2. Un administrateur a désigné une liste d'autorisation de groupes pour la connexion.
    3. La connexion est active et saine.

    Si vous avez accordé l'autorisation et que les actions demeurent indisponibles, accordez de nouveau le consentement de l'administrateur — Microsoft l'exige chaque fois que des autorisations changent.
  </Accordion>

  <Accordion title="L'accès conditionnel bloque la connexion ou ses actions">
    Si votre locataire applique une politique d'accès conditionnel limitée par adresse IP, elle peut bloquer les requêtes
    qui portent l'identifiant de cette connexion. La plupart des locataires ne sont pas touchés — Microsoft Graph ne
    restreint pas par adresse IP par défaut. Si vous appliquez une politique limitée par adresse IP aux principaux
    de service, cette intégration exige que **deux** ensembles d'adresses soient autorisés, car la configuration et la
    synchronisation des données proviennent de réseaux différents.

    Living Security génère lui-même le jeton d'accès de cette connexion et le renouvelle en continu; les
    demandes de jeton proviennent donc des adresses propres à la plateforme, et non des adresses utilisées par vos
    synchronisations de données.

    Les actions sur les groupes sont distinctes. Par défaut, elles sont acheminées de la même manière que vos synchronisations de données et
    proviennent des adresses de synchronisation. Elles ne passent aux adresses de la plateforme que si un administrateur
    configure la connexion pour une sortie directe.

    <EgressIpAllowlistBothSets system="Microsoft Entra ID" />

    Ajoutez les deux ensembles à l'**emplacement nommé** que votre politique d'accès conditionnel approuve ou
    exclut. Les demandes de jeton atteignent `login.microsoftonline.com` et les demandes de données atteignent
    `graph.microsoft.com`; les deux doivent être autorisées.

    Si seules les adresses de synchronisation sont autorisées, la configuration échoue lors de l'obtention du jeton et aucune
    connexion n'est créée. Si seules les adresses de la plateforme sont autorisées, la configuration réussit et
    chaque synchronisation ne renvoie aucun enregistrement.
  </Accordion>
</AccordionGroup>

<PublicIntegrationNextSteps />


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