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

> Connectez Netskope à Living Security pour l'activité Web, infonuagique, d'authentification, de protection des données et de menaces.

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="Netskope" />

## Ce que cette intégration apporte

Netskope peut fournir des données normalisées sur l'activité Web, infonuagique, d'authentification, de protection des données et de menaces. Voici quelques exemples examinés :

* `web.ai.visited` — Visite d'un site Web d'IA
* `data.bulk.uploaded` — Téléversement massif de données
* `geo.impossible` — Déplacement impossible entre deux connexions

La connexion actuelle utilise l'API REST v2; une variante REST héritée peut apparaître pour les clients existants. Consultez [la façon dont les données d'intégration deviennent des signaux](/fr-CA/signals/data-sources).

## Ce dont Living Security a besoin

| Identifiant | Description |
| - | - |
| **Jeton d'API** | Un jeton d'API REST v2 généré à partir de la console d'administration Netskope |
| **Sous-domaine du locataire** | Le sous-domaine de votre locataire Netskope (p. ex., `acme` à partir de `acme.goskope.com`) |

**Accès requis aux points de terminaison :**

| Point de terminaison | Objectif |
| - | - |
| `/api/v2/events/data/alert` | Alertes de menace, violations de politique, événements DLP, détections de maliciels |
| `/api/v2/events/data/page` | Activité Web — navigation, sites autorisés et bloqués, accès aux applications infonuagiques |

**Rôle requis :** **Tenant Admin** ou un rôle équivalent ayant accès à **Settings → Tools**

<Note>
  Cette intégration nécessite un **jeton d'API v2**, et non un jeton v1. Les jetons v1 utilisent l'authentification par paramètre de requête et ne fonctionneront pas avec le point de terminaison de l'API v2.
</Note>

### Prérequis

* Vous devez disposer d'un accès **Tenant Admin** dans Netskope pour gérer les jetons d'API REST.

***

## Partie A — Dans Netskope

*L'administrateur Netskope de votre organisation effectue ces étapes.*

<Steps>
  <Step title="Accéder à la gestion des jetons d'API REST v2">
    1. Connectez-vous à votre console d'administration Netskope à l'adresse `https://<tenant>.goskope.com`.
    2. Dans le menu de navigation de gauche, cliquez sur **Settings**.
    3. Sous **Tools**, sélectionnez **REST API v2**.
  </Step>

  <Step title="Créer un jeton">
    1. Cliquez sur **New Token**.
    2. Saisissez un nom descriptif (p. ex., `Living Security Platform`).
    3. Sous l'accès aux points de terminaison, activez l'accès à :

    | Point de terminaison | Accès requis |
    | - | - |
    | `/api/v2/events/data/alert` | Lecture |
    | `/api/v2/events/data/page` | Lecture |

    <Warning>
      Accordez l'accès aux **deux** points de terminaison. Ils alimentent deux flux distincts — `alerts` et
      `events` — et un jeton limité à un seul d'entre eux se connecte tout de même avec succès.
      Le flux associé au point de terminaison manquant ne renvoie alors aucune donnée, sans aucune erreur
      pour vous en indiquer la raison.
    </Warning>

    <Note>
      Ces deux points de terminaison sont les seuls dont Living Security a besoin. Ne rien accorder
      de plus respecte le principe du moindre privilège.
    </Note>

    4. Cliquez sur **Save** (ou sur **Generate Token**).
  </Step>

  <Step title="Copier et conserver votre jeton">
    **Copiez le jeton immédiatement** et conservez-le en lieu sûr.

    <Warning>
      Netskope affiche la valeur du jeton **une seule fois**, lors de sa création. Si vous quittez la page sans la copier, vous devrez supprimer le jeton et en créer un nouveau.
    </Warning>
  </Step>

  <Step title="Configurer la liste d'adresses IP autorisées (le cas échéant)">
    Si la liste d'adresses IP autorisées est activée sur votre locataire Netskope, vous devez ajouter les plages d'adresses IP de sortie de Living Security.

    1. Dans la console d'administration Netskope, accédez à **Settings → Administration → IP Allowlist**.
    2. Si la liste d'adresses IP autorisées est activée, ajoutez chaque [adresse IP de sortie de Living Security](/fr-CA/integrations/managing/egress-ip-addresses) à la liste **Custom IP**.

    <EgressIpSafelist system="Netskope" />

    <Warning>
      Si la liste d'adresses IP autorisées est activée, la boîte de dialogue de connexion réussira, mais les synchronisations de données échoueront avec l'erreur `401 Unauthorized` tant que les bonnes adresses IP n'auront pas été ajoutées.
    </Warning>
  </Step>

  <Step title="Repérer le sous-domaine de votre locataire">
    Le sous-domaine de votre locataire est le préfixe de l'URL de votre console d'administration Netskope.

    Si l'URL de votre console est `https://acme.goskope.com`, votre sous-domaine est `acme`.

    Saisissez uniquement le sous-domaine seul — sans `https://`, sans `.goskope.com` et sans barre oblique finale.

    <Note>
      La boîte de dialogue de connexion accepte plusieurs formats de saisie (sous-domaine seul, nom d'hôte complet ou URL complète) et les normalise automatiquement. Il est toutefois recommandé de saisir uniquement le sous-domaine.
    </Note>
  </Step>
</Steps>

***

## Partie B — Dans Living Security Platform

*Le responsable du programme effectue cette étape, ou l'administrateur système si la configuration déléguée est utilisée.*

<Steps>
  <ConnectInPlatform tile="Netskope (v2 API)">
    | Champ | Valeur |
    | - | - |
    | **Clé API** | Le jeton obtenu à la partie A, étape 3 |
    | **Sous-domaine du locataire** | Le sous-domaine de la partie A, étape 5 (p. ex., `acme`) |

    <img src="https://mintcdn.com/livingsecurity/oVkrOMkYmNevekTI/integrations/images/netskope-v2-api/connect-dialog.png?fit=max&auto=format&n=oVkrOMkYmNevekTI&q=85&s=89b64e78a14c51a0977c3a2a28418988" alt="Boîte de dialogue de connexion de Living Security pour l'API v2 de Netskope" style={{maxWidth: "450px"}} width="576" height="356" data-path="integrations/images/netskope-v2-api/connect-dialog.png" />
  </ConnectInPlatform>
</Steps>

Vous êtes maintenant connecté à Netskope (API v2).

***

## Dépannage

<AccordionGroup>
  <Accordion title="401 Unauthorized">
    Causes courantes :

    1. **Jeton révoqué ou expiré** — générez un nouveau jeton
    2. **Utilisation d'un jeton v1** — les jetons v1 s'authentifient par paramètre de requête et ne fonctionnent pas avec les points de terminaison v2. Générez un nouveau jeton v2 à partir de **Settings → Tools → REST API v2**
    3. **Requêtes bloquées par la liste d'adresses IP autorisées** — si la liste d'adresses IP autorisées est activée sur votre locataire, vérifiez que les quatre [adresses IP de sortie de Living Security](/fr-CA/integrations/managing/egress-ip-addresses) figurent dans la liste
  </Accordion>

  <Accordion title="403 Forbidden">
    Le jeton a été créé sans accès à `/api/v2/events/data/alert` ou à `/api/v2/events/data/page`. Les autorisations des points de terminaison d'un jeton ne peuvent pas être modifiées après sa création — créez un nouveau jeton avec un accès en lecture aux deux, puis reconnectez-vous.
  </Accordion>

  <Accordion title="Les alertes arrivent, mais l'activité Web est absente (ou l'inverse)">
    Il manque l'un des deux points de terminaison requis au jeton. Un jeton limité à
    `/api/v2/events/data/alert` seulement ou à `/api/v2/events/data/page` seulement se connecte tout de même,
    et le flux associé au point de terminaison manquant reste vide sans avertissement.

    Les autorisations des points de terminaison ne peuvent pas être modifiées après la création d'un jeton — générez un nouveau
    jeton avec un accès en lecture aux deux, puis reconnectez-vous.
  </Accordion>

  <Accordion title="Les synchronisations fonctionnaient, mais échouent maintenant avec l'erreur 401">
    Si la liste d'adresses IP autorisées est activée, les adresses IP de sortie de Living Security ont peut-être changé. Consultez [Configuration des adresses IP de sortie des intégrations](/fr-CA/integrations/managing/egress-ip-addresses) et mettez à jour la liste **Custom IP** en conséquence.
  </Accordion>

  <Accordion title="Utilisation d'un jeton v1 au lieu d'un jeton v2">
    Les jetons v1 et v2 utilisent des mécanismes d'authentification différents :

    * **v1** : paramètre de requête (`token=...`)
    * **v2** : en-tête (`Netskope-Api-Token: ...`)

    Living Security utilise l'authentification v2. Générez un nouveau jeton à partir de **Settings → Tools → REST API v2** (et non de la page des jetons v1 héritée).
  </Accordion>
</AccordionGroup>

<PublicIntegrationNextSteps />


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