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

> Sincronice usuarios de PingOne, ingeste actividades de auditoría y remedie cuentas

## Requisitos previos

Antes de conectar PingOne, asegúrese de disponer de:

1. Acceso a la consola de administración de PingOne del entorno que desea supervisar
2. Una aplicación worker de PingOne que pueda usar la concesión `client_credentials`
3. El ID de entorno de PingOne del entorno que desea que Wirespeed gestione
4. Roles asignados a la aplicación worker que le permitan gestionar usuarios del directorio y leer actividades de auditoría

## Paso 1: Crear una aplicación Worker

1. Inicie sesión en la consola de administración de PingOne
2. Abra el entorno que desea que Wirespeed supervise
3. Vaya a **Applications**
4. Cree una nueva aplicación **Worker**
5. Habilite el tipo de concesión `client_credentials`
6. Asegúrese de que el **Token Endpoint Auth Method** esté establecido en **Client Secret Basic** (este es el valor predeterminado)
7. Guarde la aplicación

## Paso 2: Asignar el acceso necesario

1. Abra la aplicación worker que ha creado
2. Asigne los roles necesarios para:
   * Gestionar usuarios del directorio mediante el rol **Identity Data Admin** a nivel de entorno
   * Leer actividades de auditoría del entorno
3. Guarde las asignaciones de roles

> [!TIP]
>
> Puede asignar **Identity Data Read Only** en su lugar si solo desea que Wirespeed
> sincronice usuarios del directorio. Seleccione **Read Only** en las opciones avanzadas al añadir la
> integración.

## Paso 3: Recopilar los detalles de conexión

Desde la consola de administración de PingOne, copie los siguientes valores:

* **Environment ID**
* **Client ID**
* **Client Secret**
* **Region** del entorno

Use uno de estos códigos de región en Wirespeed:

| Región | Código | Dominio de API | Dominio de autenticación |
| - | - | - | - |
| América del Norte | `NA` | `api.pingone.com` | `auth.pingone.com` |
| Canadá | `CA` | `api.pingone.ca` | `auth.pingone.ca` |
| Unión Europea | `EU` | `api.pingone.eu` | `auth.pingone.eu` |
| Australia | `AU` | `api.pingone.com.au` | `auth.pingone.com.au` |
| Singapur | `SG` | `api.pingone.sg` | `auth.pingone.sg` |
| Asia-Pacífico | `AP` | `api.pingone.asia` | `auth.pingone.asia` |

## Paso 4: Añadir la integración en Wirespeed

1. Inicie sesión en **Wirespeed**
2. Vaya a **Integraciones** > **Añadir integración**
3. Seleccione **PingOne**
4. Introduzca lo siguiente:
   * **Región de PingOne**: `NA`, `CA`, `EU`, `AU`, `SG` o `AP`
   * **ID de entorno**
   * **ID de cliente**
   * **Secreto de cliente**
5. Haga clic en **Integrar**

Wirespeed intercambiará las credenciales de su aplicación worker por un access token y
comenzará a consultar PingOne en busca de datos nuevos.

> [!TIP]
>
> Durante la configuración, Wirespeed valida que la aplicación worker pueda leer usuarios del
> directorio y actividades de auditoría del entorno seleccionado. Si falla alguna de las
> comprobaciones requeridas, la integración no se habilitará.

## Qué recopila Wirespeed

Wirespeed actualmente ingesta lo siguiente desde PingOne:

* Usuarios del directorio
* Actividades de auditoría de las API de informes de auditoría de PingOne

## Acciones de remediación

Con acceso de **Identity Data Admin**, Wirespeed puede:

* Deshabilitar usuarios para impedir la autenticación
* Volver a habilitar usuarios para restaurar la autenticación
* Forzar a los usuarios con contraseñas gestionadas por PingOne a cambiar su contraseña en el siguiente inicio de sesión
* Terminar las sesiones retenidas por PingOne para un usuario

Deshabilitar un usuario no termina las sesiones existentes. La revocación de sesiones termina
las sesiones que devuelve PingOne, pero no garantiza la revocación de todos los tokens OAuth.

## Solución de problemas

* Si la autenticación falla durante la configuración, confirme que la aplicación worker está configurada para `client_credentials` con el **Token Endpoint Auth Method** establecido en **Client Secret Basic** (no Client Secret Post)
* Si la configuración falla al validar el acceso a las actividades de auditoría, confirme que la región y el ID de entorno seleccionados son correctos y que la aplicación worker puede leer datos de auditoría en el entorno de destino
* Si la configuración falla al validar el acceso a los usuarios del directorio, asigne **Identity Data Admin** o **Identity Data Read Only** a la aplicación worker a nivel de entorno
* Si una acción de remediación falla con un error de permisos, confirme que la aplicación worker tiene acceso de **Identity Data Admin** para el entorno o la population del usuario
* Si no está seguro de qué región usar, verifique el dominio regional del entorno de PingOne en la consola de administración y hágalo coincidir con la tabla anterior


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