> For the complete documentation index, see [llms.txt](https://wiki.datadike.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.datadike.com/es/sonar/administration/identities/sso.md).

# Single sign-on

Cómo inician sesión en SONAR las personas y las integraciones: cuentas de la consola con contraseña y código del autenticador, y claves de API. El single sign-on se trata con DataDike.

## Qué es esto y cuándo usarlo

Esta página responde a la pregunta "¿cómo inician sesión las personas en SONAR, y puede usar nuestro proveedor de identidad corporativo?". Enumera los métodos de inicio de sesión de la consola y los controles que tiene un administrador sobre cada uno.

SONAR autentica a las personas con sus propias cuentas de consola. Cada cuenta inicia sesión con un nombre de usuario, una contraseña y un código de una aplicación autenticadora. La pantalla de inicio de sesión no ofrece ningún botón para un proveedor de identidad externo. Una organización que necesite single sign-on, por ejemplo a través de Microsoft Entra ID, Okta u otro proveedor SAML u OpenID Connect, trata el requisito con el soporte de implantación de DataDike antes de hacer planes que dependan de él.

## Métodos de inicio de sesión

| Método               | Quién lo usa                                | Cómo se autentica                                                                        | Dónde se gestiona                                                                                                                  |
| -------------------- | ------------------------------------------- | ---------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| Cuenta de la consola | Las personas que operan la consola          | **Username**, **Password** y después un código de autenticador de seis dígitos           | [Usuarios](/es/sonar/administration/identities/users.md) y [Autenticación multifactor](/es/sonar/administration/identities/mfa.md) |
| Clave de API         | Scripts e integraciones que llaman a la API | Una clave enviada en la cabecera `X-API-KEY`, que actúa como el usuario al que pertenece | [Claves de API](/es/sonar/administration/settings/api-keys.md)                                                                     |

Los agentes instalados en los endpoints tienen sus propias credenciales, creadas al instalar el agente. No son cuentas de usuario y no aparecen en **Admin Center › Users**.

## Antes de empezar

* Para gestionar las cuentas de la consola: **List Accounts** y **Manage Accounts**.
* Para gestionar las claves de API: **View Core Settings**, **List API Keys** y **Manage API Keys**.

## Pasos

### Dar acceso a una persona

1. Cree su cuenta en **Admin Center › Users** con **Add User** y elija su rol. Consulte [Usuarios](/es/sonar/administration/identities/users.md).
2. Envíele el nombre de usuario y la contraseña inicial por un canal de confianza.
3. En su primer inicio de sesión, la persona registra una aplicación autenticadora en la pantalla **Setup 2-Factor Auth**. Consulte [Autenticación multifactor](/es/sonar/administration/identities/mfa.md).

### Dar acceso a una integración

1. Cree una cuenta de consola para la integración con un rol que conceda solo lo que la integración necesita.
2. Marque **Block Dashboard Logins** en esa cuenta, para que no pueda iniciar sesión en la consola. Sus claves de API siguen funcionando.
3. Cree una clave de API para la cuenta en **Admin Center › Settings › API Keys**. Consulte [Claves de API](/es/sonar/administration/settings/api-keys.md).

### Retirar el acceso

| Para                                                                                     | Haga esto                                                                                                                |
| ---------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
| Bloquear por completo a una persona o una integración                                    | Desmarque **Active** en la cuenta. El inicio de sesión en la consola y las claves de API de la cuenta dejan de funcionar |
| Conservar las claves de API de una cuenta pero impedir el inicio de sesión en la consola | Marque **Block Dashboard Logins**                                                                                        |
| Cerrar las sesiones abiertas en este momento                                             | Use el icono de cierre de sesión de la fila del usuario y **Disconnect All**                                             |
| Bloquear una sola integración                                                            | Elimine su clave de API, o fije una fecha en **Expiration**                                                              |

## Lo que debería ver

La pantalla de inicio de sesión, titulada **Welcome to SONAR**, muestra **Username**, **Password**, **Remember me** y **Sign in**. Una vez aceptada la contraseña, la consola pide el código del autenticador en **Identity Verification**.

## Cómo verificar que funcionó

1. En una ventana privada del navegador, inicie sesión con una cuenta nueva. La consola pide la contraseña y después lleva al usuario a **Setup 2-Factor Auth**.
2. Inicie sesión con una cuenta que tenga marcada **Block Dashboard Logins**. La consola responde `Bad credentials`, mientras que una llamada a la API con la clave de esa cuenta sigue funcionando. Consulte [API](/es/sonar/reference/api.md) para una llamada de prueba.
3. Abra **Reports & Audits › Audits** y filtre **Action** por **Login** o **Failed Login** para ver quién inició sesión y a quién se le denegó.

## Errores comunes

| Síntoma                                            | Causa                                                                          | Solución                                                                                                    |
| -------------------------------------------------- | ------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------- |
| `Bad credentials` con la contraseña correcta       | La cuenta está desactivada o tiene bloqueado el inicio de sesión en la consola | Revise **Active?** y **Block Dashboard Logins** en [Usuarios](/es/sonar/administration/identities/users.md) |
| Una integración recibe `User inactive or deleted.` | La cuenta a la que pertenece la clave está desactivada                         | Active la cuenta, o cree la clave para una cuenta activa                                                    |
| Una integración recibe `Invalid token.`            | La clave se eliminó o se escribió mal                                          | Cree una clave nueva y actualice la integración                                                             |
| Una integración recibe `The token has expired.`    | La fecha de **Expiration** de la clave ya pasó                                 | Cambie o borre la fecha de caducidad, o cree una clave nueva                                                |

## Páginas relacionadas

* [Usuarios](/es/sonar/administration/identities/users.md): cree y desactive cuentas de la consola
* [Autenticación multifactor](/es/sonar/administration/identities/mfa.md): el código del autenticador al iniciar sesión
* [Claves de API](/es/sonar/administration/settings/api-keys.md): credenciales para integraciones
* [Roles y permisos](/es/sonar/administration/identities/roles.md): lo que puede hacer una cuenta una vez iniciada la sesión
