> ## Documentation Index
> Fetch the complete documentation index at: https://ai-kb.automationanywhere.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Inicio de Sesión Único (SSO) con Okta

> Configure la Autenticación SSO con Okta

Este artículo proporciona una guía detallada sobre la configuración del Inicio de Sesión Único (SSO) utilizando Okta como su proveedor de identidad. Al integrar Okta con EKB, su organización puede optimizar la autenticación de usuarios, permitiendo a los empleados acceder a la plataforma utilizando sus credenciales de Okta existentes. Aprenderá los requisitos previos, las instrucciones de configuración paso a paso y los consejos de solución de problemas específicos para SSO con Okta.

Usar Okta SSO ofrece varias ventajas:

* **Autenticación Centralizada** - Un solo inicio de sesión para todas las aplicaciones empresariales.
* **Seguridad Mejorada** - Acceso controlado por la organización.
* **Gestión de Usuarios** - Aprovisionamiento y desaprovisionamiento centralizado de usuarios.
* **Cumplimiento** - Cumple con los requisitos de seguridad empresarial.
* **Experiencia de Usuario** - Experiencia de autenticación fluida.

## Configuración de SSO con Okta

En esta sección encontrará los pasos necesarios para configurar SSO con Okta para su instancia de EKB.

### Requisitos Previos

Antes de comenzar, asegúrese de tener:

* Acceso de administrador de Okta.
* URL de su instancia de EKB.

### Paso 1: Configuración de la Aplicación en Okta

1. **Inicie sesión en la Consola de Administración de Okta**\
   Visite su consola de administración de Okta y navegue a **Applications** > **Applications**.

2. **Cree una Nueva Aplicación**\
   Haga clic en **Create App Integration**, seleccione **SAML 2.0** como método de inicio de sesión y haga clic en **Next**.

3. **Configure los Ajustes Generales**\
   Ingrese un nombre de aplicación (por ejemplo, "EKB"), suba el logo de EKB si lo desea y haga clic en **Next**.

4. **Configure los Ajustes SAML**\
   En la sección **SAML Settings**, ingrese lo siguiente (para EKB Cloud use las URL a continuación):

   * **Single Sign On URL**: `https://api.getodin.ai/user/okta/sso/saml/acs/admin`
   * **Recipient URL**: `https://api.getodin.ai/user/okta/sso/saml/acs/admin`
   * **Destination URL**: `https://api.getodin.ai/user/okta/sso/saml/acs/admin`
   * **Audience Restriction**: `https://api.getodin.ai/user/okta/sso/saml/acs/admin`
   * **Default Relay State**: `default`

   También configure **Name ID format** en `EmailAddress`, **Application username** en `Email` y **Update application username on** en `Create and update`.

   <img src="https://mintcdn.com/automationanywhere/kF-djBDj55ijzQTq/img/authentication/okta-saml-settings.png?fit=max&auto=format&n=kF-djBDj55ijzQTq&q=85&s=3664648e821a3dcfbdf78560d1080a72" alt="Ajustes SAML de Okta" width="1024" height="785" data-path="img/authentication/okta-saml-settings.png" />

5. **Declaraciones de Atributos** (Opcional)\
   Agregue los mapeos de atributos según sea necesario (por ejemplo, `email` → `user.email`, `firstName` → `user.firstName`, `lastName` → `user.lastName`).

   **Cómo agregar declaraciones de atributos**

   1. En Okta, vaya a **Applications** > **Your App**.
   2. Haga clic en la pestaña **General** > **SAML Settings** > **Edit**.
   3. Abra la sección **Configure SAML**.
   4. Desplácese hasta **Attribute Statements** (donde agrega email, firstName, lastName).
   5. Haga clic en **Add Another** para agregar más atributos.

   <img src="https://mintcdn.com/automationanywhere/kF-djBDj55ijzQTq/img/authentication/okta-attribute-statements.png?fit=max&auto=format&n=kF-djBDj55ijzQTq&q=85&s=77b0f756bd775a11c97691ed10310ea9" alt="Declaraciones de Atributos de Okta" width="1024" height="496" data-path="img/authentication/okta-attribute-statements.png" />

   **Agregar atributos de usuario personalizados a SAML (opcional)**

   Para enviar atributos personalizados (por ejemplo, `userTags`) en la afirmación SAML:

   **1. Cree el atributo en Okta**

   * Vaya a **Directory** → **Profile Editor** → **User (default)**.
   * Haga clic en **Add Attribute**.
   * Configure **Variable name** (por ejemplo, `userTags`) — use camelCase, sin espacios.
   * Configure **Data type**: string (valor único) o string array (múltiples valores).
   * Haga clic en **Save**.

   **2. Asigne valores a todos los usuarios (requerido)**

   * Vaya a **Directory** → **People** → seleccione un usuario.
   * Haga clic en **Edit** en su perfil.
   * Complete el campo de atributo personalizado con un valor.
   * Haga clic en **Save**.
   * Repita para cada usuario que usará SSO.

   Okta solo envía atributos que tienen valores; los campos vacíos no se incluyen en la respuesta SAML.

   **3. Asigne el atributo en su aplicación SAML**

   * Vaya a **Applications** → \[Your SAML App] → **SAML Settings** → **Edit**.
   * En **Attribute Statements**, haga clic en **Add Another** y agregue:
     * **Name**: `userTags` (o el nombre de su atributo).
     * **Value**: `user.userTags` (debe coincidir con el nombre de la variable del paso 1).
   * Haga clic en **Save**.

6. **Declaraciones de Atributos de Grupo** (Opcional)\
   Configure los mapeos de grupo si es necesario.

7. **Comentarios** (Opcional)\
   Seleccione las opciones de comentarios y haga clic en **Finish**.

### Paso 2: Obtenga la Configuración de Okta

**Obtenga la URL de Metadatos**\
Inicie sesión en Okta como administrador, vaya a **Applications** → \[Your App] → pestaña **Sign On**. Luego vaya a **Settings** → **SAML 2.0** → **Metadata details** → **Metadata URL**. Copie la URL (use el botón Copiar).

<img src="https://mintcdn.com/automationanywhere/kF-djBDj55ijzQTq/img/authentication/okta-metadata-url.png?fit=max&auto=format&n=kF-djBDj55ijzQTq&q=85&s=2e68cdcb209217186e186f382ddfd140" alt="Okta Sign On – URL de Metadatos" width="1024" height="940" data-path="img/authentication/okta-metadata-url.png" />

### Paso 3: Envíe la Configuración a EKB

El equipo de soporte de EKB configurará y probará su configuración de SSO. Proporcione la siguiente información:

1. **Envíe los Detalles de la Configuración**\
   Envíe un correo electrónico a [**Soporte**](mailto:support@automationanywhere.com) con la siguiente información:
   * **Provider**: Okta
   * **Enterprise ID**: El dominio de su organización (por ejemplo, `company.com`)
   * **Metadata URL**: La URL de metadatos de Okta del Paso 2
   * **SSO Sign-In Only** (Opcional): Especifique si desea requerir SSO para todos los usuarios con este dominio.

2. **Configuración de EKB**\
   El equipo de soporte de EKB configurará SSO en su instancia y probará la conexión. Se le notificará cuando la configuración esté completa.

3. **Pruebas**\
   El equipo de EKB probará la conexión SSO y se le puede solicitar que verifique que funciona. Una vez confirmado, SSO se habilitará para su organización.

### Solución de Problemas de SSO con Okta

En esta sección encontrará problemas comunes y soluciones relacionadas con SSO de Okta.

**Problema**: Bucle de redirección o fallo de autenticación\
**Soluciones**:

* Verifique que Single Sign On URL, Recipient URL, Destination URL y Audience Restriction coincidan todos con `https://api.getodin.ai/user/okta/sso/saml/acs/admin`.
* Asegúrese de que Default Relay State esté configurado en `default`.
* Asegúrese de que Name ID format esté configurado en EmailAddress.
* Verifique que la URL de metadatos sea accesible.
* Compruebe que la aplicación de Okta esté activa.

**Problema**: Usuario no encontrado después del inicio de sesión SSO\
**Soluciones**:

* Verifique el mapeo de atributos de correo electrónico en Okta.
* Compruebe que el usuario exista en EKB.
* Asegúrese de que el aprovisionamiento de usuarios esté configurado.
* Verifique que el ID de empresa coincida con el dominio de correo electrónico.

## Contacto

Para preguntas o problemas sobre la configuración de SSO, contacte a [Soporte](mailto:support@automationanywhere.com).
