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

# PingOne

> Synchronisez les utilisateurs PingOne, ingérez les activités d’audit et remédiez aux comptes

## Prérequis

Avant de connecter PingOne, assurez-vous de disposer des éléments suivants :

1. Un accès à la console d’administration PingOne de l’environnement que vous souhaitez superviser
2. Une application worker PingOne pouvant utiliser l’octroi `client_credentials`
3. L’ID de l’environnement PingOne que Wirespeed doit gérer
4. Des rôles attribués à l’application worker qui lui permettent de gérer les utilisateurs de l’annuaire et de lire les activités d’audit

## Étape 1 : créer une application worker

1. Connectez-vous à la console d’administration PingOne
2. Ouvrez l’environnement que Wirespeed doit superviser
3. Accédez à **Applications**
4. Créez une nouvelle application **Worker**
5. Activez le type d’octroi `client_credentials`
6. Vérifiez que **Token Endpoint Auth Method** est défini sur **Client Secret Basic** (valeur par défaut)
7. Enregistrez l’application

## Étape 2 : attribuer les accès requis

1. Ouvrez l’application worker que vous avez créée
2. Attribuez les rôles nécessaires pour :
   * Gérer les utilisateurs de l’annuaire à l’aide du rôle **Identity Data Admin** au niveau de l’environnement
   * Lire les activités d’audit de l’environnement
3. Enregistrez les attributions de rôles

> [!TIP]
>
> Vous pouvez attribuer **Identity Data Read Only** à la place si vous souhaitez uniquement que Wirespeed
> synchronise les utilisateurs de l’annuaire. Sélectionnez **Lecture seule** dans les options avancées lors de l’ajout de
> l’intégration.

## Étape 3 : rassembler les informations de connexion

Dans la console d’administration PingOne, copiez les valeurs suivantes :

* **Environment ID**
* **Client ID**
* **Client Secret**
* **Région** de l’environnement

Utilisez l’un de ces codes de région dans Wirespeed :

| Région | Code | Domaine API | Domaine d’authentification |
| - | - | - | - |
| Amérique du Nord | `NA` | `api.pingone.com` | `auth.pingone.com` |
| Canada | `CA` | `api.pingone.ca` | `auth.pingone.ca` |
| Union européenne | `EU` | `api.pingone.eu` | `auth.pingone.eu` |
| Australie | `AU` | `api.pingone.com.au` | `auth.pingone.com.au` |
| Singapour | `SG` | `api.pingone.sg` | `auth.pingone.sg` |
| Asie-Pacifique | `AP` | `api.pingone.asia` | `auth.pingone.asia` |

## Étape 4 : ajouter l’intégration dans Wirespeed

1. Connectez-vous à **Wirespeed**
2. Accédez à **Intégrations** > **Ajouter une intégration**
3. Sélectionnez **PingOne**
4. Saisissez les éléments suivants :
   * **Région PingOne** : `NA`, `CA`, `EU`, `AU`, `SG` ou `AP`
   * **ID d’environnement**
   * **ID client**
   * **Secret client**
5. Cliquez sur **Intégrer**

Wirespeed échange les identifiants de votre application worker contre un jeton d’accès et
commence à interroger PingOne pour récupérer les nouvelles données.

> [!TIP]
>
> Pendant la configuration, Wirespeed vérifie que l’application worker peut lire les utilisateurs
> de l’annuaire et les activités d’audit de l’environnement sélectionné. Si l’une de ces
> vérifications obligatoires échoue, l’intégration n’est pas activée.

## Données collectées par Wirespeed

Wirespeed ingère actuellement les éléments suivants depuis PingOne :

* Les utilisateurs de l’annuaire
* Les activités d’audit issues des API de rapports d’audit PingOne

## Actions de remédiation

Avec l’accès **Identity Data Admin**, Wirespeed peut :

* Désactiver des utilisateurs pour empêcher leur authentification
* Réactiver des utilisateurs pour rétablir leur authentification
* Obliger les utilisateurs dont le mot de passe est géré par PingOne à le changer lors de leur prochaine connexion
* Mettre fin aux sessions conservées par PingOne pour un utilisateur

La désactivation d’un utilisateur ne met pas fin aux sessions existantes. La révocation des sessions met fin
aux sessions renvoyées par PingOne, mais ne garantit pas la révocation de tous les jetons OAuth.

## Dépannage

* Si l’authentification échoue pendant la configuration, vérifiez que l’application worker est configurée pour `client_credentials` avec **Token Endpoint Auth Method** défini sur **Client Secret Basic** (et non Client Secret Post)
* Si la configuration échoue lors de la validation de l’accès aux activités d’audit, vérifiez que la région et l’ID d’environnement sélectionnés sont corrects et que l’application worker peut lire les données d’audit dans l’environnement cible
* Si la configuration échoue lors de la validation de l’accès aux utilisateurs de l’annuaire, attribuez **Identity Data Admin** ou **Identity Data Read Only** à l’application worker au niveau de l’environnement
* Si une action de remédiation échoue avec une erreur d’autorisation, vérifiez que l’application worker dispose de l’accès **Identity Data Admin** pour l’environnement ou la population de l’utilisateur
* Si vous ne savez pas quelle région utiliser, vérifiez le domaine régional de l’environnement PingOne dans la console d’administration et faites-le correspondre au tableau ci-dessus


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