> ## Documentation Index
> Fetch the complete documentation index at: https://smartac-mintlify-b54f69e3.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Inicio de sesión único (SSO)

> Configura el inicio de sesión único con proveedores de identidad SAML u OIDC como Okta, Azure AD y Google Workspace para la autenticación segura del equipo.

<Info>
  SSO está disponible en los [planes Enterprise](https://mintlify.com/pricing?ref=sso).
</Info>

Los administradores de planes Enterprise pueden configurar SAML SSO para Okta o Microsoft Entra directamente desde el Dashboard de Mintlify. Para otros proveedores como Google Workspace u Okta OIDC, [contáctanos](mailto:support@mintlify.com) para configurar SSO.

<div id="configure-sso">
  ## Configurar SSO
</div>

<div id="okta">
  ### Okta
</div>

<Steps>
  <Step title="Configura Okta SSO en tu Dashboard de Mintlify">
    1. En tu Dashboard de Mintlify, navega a la página de [Single Sign-On](https://dashboard.mintlify.com/settings/organization/sso).
    2. Haz clic en **Configure**.
    3. Selecciona **Okta SAML**.
    4. Copia la **Single sign on URL** y la **Audience URI**.
  </Step>

  <Step title="Crea una aplicación SAML en Okta">
    1. En Okta, en **Applications**, crea una nueva integración de aplicación usando SAML 2.0.

    2. Ingresa lo siguiente desde Mintlify:
       * **Single sign on URL**: la URL que copiaste desde tu Dashboard de Mintlify
       * **Audience URI**: la URI que copiaste desde tu Dashboard de Mintlify
       * **Name ID Format**: `EmailAddress`

    3. Añade estas declaraciones de atributos:

       | Name        | Name format | Value            |
       | ----------- | ----------- | ---------------- |
       | `firstName` | Basic       | `user.firstName` |
       | `lastName`  | Basic       | `user.lastName`  |
  </Step>

  <Step title="Copia la URL de metadata de Okta">
    En Okta, ve a la pestaña **Sign On** de tu aplicación y copia la URL de metadata.
  </Step>

  <Step title="Guarda en Mintlify">
    De vuelta en el Dashboard de Mintlify, pega la URL de metadata y haz clic en **Guardar cambios**.
  </Step>
</Steps>

<div id="microsoft-entra">
  ### Microsoft Entra
</div>

<Steps>
  <Step title="Configurar Microsoft Entra SSO en el Dashboard de Mintlify">
    1. En el Dashboard de Mintlify, navega a la página de [Single Sign-On](https://dashboard.mintlify.com/settings/organization/sso).
    2. Haz clic en **Configurar**.
    3. Selecciona **Microsoft Entra ID SAML**.
    4. Copia la **Single sign on URL** y la **Audience URI**.
  </Step>

  <Step title="Crear una aplicación empresarial en Microsoft Entra">
    1. En Microsoft Entra, navega a **Enterprise applications**.
    2. Selecciona **New application**.
    3. Selecciona **Create your own application**.
    4. Selecciona "Integrate any other application you don't find in the gallery (Non-gallery)."
  </Step>

  <Step title="Configurar SAML en Microsoft Entra">
    1. En Microsoft Entra, navega a **Single Sign-On**.
    2. Selecciona **SAML**.
    3. En **Basic SAML Configuration**, introduce lo siguiente:
       * **Identifier (Entity ID)**: la Audience URI de Mintlify
       * **Reply URL (Assertion Consumer Service URL)**: la Single sign on URL de Mintlify

    Deja los otros valores en blanco y selecciona **Guardar**.
  </Step>

  <Step title="Configurar Attributes & Claims en Microsoft Entra">
    1. En Microsoft Entra, navega a **Attributes & Claims**.
    2. Selecciona **Unique User Identifier (Name ID)** en «Required Claim».
    3. Cambia el atributo Source a `user.primaryauthoritativeemail`.
    4. En **Additional claims**, crea lo siguiente:
       | Name        | Value            |
       | ----------- | ---------------- |
       | `firstName` | `user.givenname` |
       | `lastName`  | `user.surname`   |
  </Step>

  <Step title="Copiar la URL de metadatos de Microsoft Entra">
    En **SAML Certificates**, copia la **App Federation Metadata URL**.
  </Step>

  <Step title="Guardar en Mintlify">
    De vuelta en el Dashboard de Mintlify, pega la URL de metadatos y haz clic en **Guardar cambios**.
  </Step>

  <Step title="Asignar usuarios">
    En Microsoft Entra, navega a **Users and groups**. Asigna los usuarios que deberían tener acceso a tu Dashboard de Mintlify.
  </Step>
</Steps>

<div id="jit-provisioning">
  ## Aprovisionamiento JIT
</div>

Cuando habilites el aprovisionamiento JIT (just-in-time), los usuarios que inicien sesión a través de tu proveedor de identidad se agregarán automáticamente a tu organización de Mintlify.

<Note>
  El aprovisionamiento JIT solo funciona para inicios de sesión iniciados por el IdP. Los usuarios deben iniciar sesión desde tu proveedor de identidad (dashboard de Okta o portal de Microsoft Entra) en lugar de hacerlo desde la página de inicio de sesión de Mintlify.
</Note>

Para habilitar el aprovisionamiento JIT, debes tener SSO habilitado. Ve a la página de [Single Sign-On](https://dashboard.mintlify.com/settings/organization/sso) en tu dashboard, configura el SSO y luego habilita el aprovisionamiento JIT.

<div id="map-rbac-roles-with-saml-groups">
  ## Mapear roles RBAC con grupos SAML
</div>

Asigna [roles](/es/dashboard/roles) a los usuarios en función de su pertenencia a grupos en el proveedor de identidad. Cuando un usuario inicia sesión a través de SSO, Mintlify lee el atributo `groups` de la aserción SAML y mapea esos grupos a roles del dashboard.

<div id="configure-group-attribute-statements">
  ### Configurar declaraciones de atributos de grupo
</div>

Añade una declaración de atributo `groups` a la configuración de tu proveedor de identidad SAML. El atributo debe usar el formato de nombre `unspecified`.

La aserción SAML resultante debe incluir un `AttributeStatement`.

```xml Example SAML assertion theme={null}
<saml2:AttributeStatement xmlns:saml2="urn:oasis:names:tc:SAML:2.0:assertion">
    <saml2:Attribute Name="groups" NameFormat="urn:oasis:names:tc:SAML:2.0:attrname-format:unspecified">
        <saml2:AttributeValue xmlns:xs="http://www.w3.org/2001/XMLSchema"
                              xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
                              xsi:type="xs:string">Everyone</saml2:AttributeValue>
        <saml2:AttributeValue xmlns:xs="http://www.w3.org/2001/XMLSchema"
                              xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
                              xsi:type="xs:string">Engineering</saml2:AttributeValue>
        <saml2:AttributeValue xmlns:xs="http://www.w3.org/2001/XMLSchema"
                              xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
                              xsi:type="xs:string">Admins</saml2:AttributeValue>
    </saml2:Attribute>
</saml2:AttributeStatement>
```

**Requisitos clave:**

* El nombre del atributo debe ser `groups` (distingue entre mayúsculas y minúsculas)
* El formato de nombre debe ser `urn:oasis:names:tc:SAML:2.0:attrname-format:unspecified`
* Cada grupo al que pertenece el usuario debe ser un elemento `AttributeValue` separado

<Tabs>
  <Tab title="Okta">
    En la configuración de tu aplicación SAML de Okta, añade una declaración de atributo de grupo:

    | Name     | Name format | Filter        | Value |
    | -------- | ----------- | ------------- | ----- |
    | `groups` | Unspecified | Matches regex | `.*`  |

    Ajusta el filtro para que coincida con los grupos específicos que deseas enviar a Mintlify.
  </Tab>

  <Tab title="Microsoft Entra">
    En tu aplicación empresarial de Microsoft Entra:

    1. Navega a **Single Sign-On** > **Attributes & Claims**.
    2. Selecciona **Add a group claim**.
    3. Selecciona qué grupos incluir (todos los grupos o grupos específicos).
    4. En **Advanced options**, marca **Customize the name of the group claim** y establece el nombre como `groups`.
  </Tab>
</Tabs>

Una vez configurado, Mintlify mapea los nombres de los grupos de la aserción SAML a los roles de tu organización. Para configurar o modificar los mapeos de grupo a rol, contacta a tu representante de cuenta de Mintlify.

<div id="change-or-remove-sso-provider">
  ## Cambiar o eliminar el proveedor de SSO
</div>

1. Ve a la página [Single Sign-On](https://dashboard.mintlify.com/settings/organization/sso) en tu dashboard.
2. Haz clic en **Configure**.
3. Selecciona tu proveedor de SSO preferido o desactiva el SSO.

Si eliminas el SSO, los usuarios deberán autenticarse con una contraseña, un enlace mágico o con Google OAuth en su lugar.

<div id="other-providers">
  ## Otros proveedores
</div>

Para proveedores distintos de Microsoft Entra u Okta SAML, [contáctanos](mailto:support@mintlify.com) para configurar SSO.

<div id="google-workspace-with-saml">
  ### Google Workspace con SAML
</div>

<Steps>
  <Step title="Crear una aplicación">
    1. En Google Workspace, ve a **Web and mobile apps**.
    2. En el menú desplegable **Add app**, selecciona **Add custom SAML app**.

    <Frame>
      <img src="https://mintcdn.com/smartac-mintlify-b54f69e3/2d1wfQxoR9-a-wJ3/images/gsuite-add-custom-saml-app.png?fit=max&auto=format&n=2d1wfQxoR9-a-wJ3&q=85&s=75c4b735974026af9a5527717107c266" alt="Captura de pantalla de la página de creación de la aplicación SAML de Google Workspace con el elemento del menú &#x22;Add custom SAML app&#x22; resaltado" width="3804" height="1860" data-path="images/gsuite-add-custom-saml-app.png" />
    </Frame>
  </Step>

  <Step title="Envíanos la información de tu IdP">
    Copia la SSO URL, el Entity ID y el certificado x509 proporcionados y envíalos al equipo de Mintlify.

    <Frame>
      <img src="https://mintcdn.com/smartac-mintlify-b54f69e3/2d1wfQxoR9-a-wJ3/images/gsuite-saml-metadata.png?fit=max&auto=format&n=2d1wfQxoR9-a-wJ3&q=85&s=c22616cdfba06487d7aaa662a9014709" alt="Captura de pantalla de la página de la aplicación SAML de Google Workspace con la SSO URL, el Entity ID y el certificado x509 resaltados. Los valores específicos de cada uno están difuminados." width="3800" height="1850" data-path="images/gsuite-saml-metadata.png" />
    </Frame>
  </Step>

  <Step title="Configurar la integración">
    En la página Service provider details, introduce lo siguiente:

    * ACS URL (proporcionado por Mintlify)
    * Entity ID (proporcionado por Mintlify)
    * Name ID format: `EMAIL`
    * Name ID: `Basic Information > Primary email`

    <Frame>
      <img src="https://mintcdn.com/smartac-mintlify-b54f69e3/2d1wfQxoR9-a-wJ3/images/gsuite-sp-details.png?fit=max&auto=format&n=2d1wfQxoR9-a-wJ3&q=85&s=29dda7dadc54b194c5701ee710d0009f" alt="Captura de pantalla de la página Service provider details con los campos de entrada ACS URL y Entity ID resaltados." width="3788" height="1864" data-path="images/gsuite-sp-details.png" />
    </Frame>

    En la página siguiente, introduce las siguientes declaraciones de atributos:

    | Google Directory Attribute | App Attribute |
    | -------------------------- | ------------- |
    | `First name`               | `firstName`   |
    | `Last name`                | `lastName`    |

    Cuando completes este paso y los usuarios estén asignados a la aplicación, avísanos y habilitaremos el SSO para tu cuenta.
  </Step>
</Steps>

<div id="okta-oidc">
  ### Okta (OIDC)
</div>

<Steps>
  <Step title="Create an application">
    En Okta, en **Applications**, crea una nueva integración de aplicación con OIDC. Elige el tipo de aplicación **Web Application**.
  </Step>

  <Step title="Configure integration">
    Selecciona el tipo de concesión Authorization Code y proporciona el Redirect URI indicado por Mintlify.
  </Step>

  <Step title="Send us your IdP information">
    Ve a la pestaña **General** y localiza el Client ID y el client secret. Envíanos estos de forma segura, junto con la URL de tu instancia de Okta (por ejemplo, `<your-tenant-name>.okta.com`). Puedes enviarlos mediante un servicio como 1Password o SendSafely.
  </Step>
</Steps>