> ## Documentation Index
> Fetch the complete documentation index at: https://wiki.another-horizon.eu/llms.txt
> Use this file to discover all available pages before exploring further.

# Inicio de sesión único (SSO)

> Configura SAML u OIDC con proveedores de identidad para la autenticación del equipo.

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

Usa el inicio de sesión único en tu dashboard mediante SAML y OIDC. Si utilizas Okta, Google Workspace o Microsoft Entra, contamos con documentación específica del proveedor para configurar SSO. Si utilizas otro proveedor, [contáctanos](mailto:support@mintlify.com).

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

<Tabs>
  <Tab title="SAML">
    <Steps>
      <Step title="Create an application">
        En `Applications`, haz clic para crear una nueva integración de aplicación con SAML 2.0.
      </Step>

      <Step title="Configure integration">
        Ingresa lo siguiente:

        * Single sign-on URL (proporcionada por Mintlify)
        * Audience URI (proporcionada por Mintlify)
        * Name ID Format: `EmailAddress`
        * Attribute Statements:
          | Name        | Name format | Value            |
          | ----------- | ----------- | ---------------- |
          | `firstName` | Basic       | `user.firstName` |
          | `lastName`  | Basic       | `user.lastName`  |
      </Step>

      <Step title="Send us your IdP information">
        Una vez que la aplicación esté configurada, ve a la pestaña de inicio de sesión y envíanos la URL de metadata.
        Habilitaremos la conexión por nuestra parte usando esta información.
      </Step>
    </Steps>
  </Tab>

  <Tab title="OIDC">
    <Steps>
      <Step title="Create an application">
        En `Applications`, haz clic para crear una nueva integración de aplicación con OIDC.
        Debes elegir 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">
        Una vez que la aplicación esté configurada, 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>
  </Tab>
</Tabs>

<div id="google-workspace">
  ## Google Workspace
</div>

<Tabs>
  <Tab title="SAML">
    <Steps>
      <Step title="Crear una aplicación">
        En `Web and mobile apps`, selecciona `Add custom SAML app` en el menú desplegable `Add app`.

        <Frame>
          <img src="https://mintcdn.com/anotherhorizon/JcCuRMYxa7xgY0h0/images/gsuite-add-custom-saml-app.png?fit=max&auto=format&n=JcCuRMYxa7xgY0h0&q=85&s=cf2c3bd5c84708e39d18f593363a27ef" 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/anotherhorizon/JcCuRMYxa7xgY0h0/images/gsuite-saml-metadata.png?fit=max&auto=format&n=JcCuRMYxa7xgY0h0&q=85&s=24453fa68cb7b32b3422018c99135719" 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/anotherhorizon/JcCuRMYxa7xgY0h0/images/gsuite-sp-details.png?fit=max&auto=format&n=JcCuRMYxa7xgY0h0&q=85&s=7c49c0b77e8bf54fad4053052e28d847" 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>
  </Tab>
</Tabs>

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

<Tabs>
  <Tab title="SAML">
    <Steps>
      <Step title="Crear una aplicación">
        1. En "Enterprise applications", selecciona **New application**.
        2. Selecciona **Create your own application** y elige "Integrate any other application you don't find in the gallery (Non-gallery)."
      </Step>

      <Step title="Configurar SAML">
        Ve a la página de configuración de inicio de sesión único y selecciona **SAML**. En "Basic SAML Configuration", ingresa lo siguiente:

        * Identifier (Entity ID): el Audience URI proporcionado por Mintlify.
        * Reply URL (Assertion Consumer Service URL): la URL de ACS proporcionada por Mintlify.

        Deja los demás valores en blanco y selecciona **Save**.
      </Step>

      <Step title="Configurar Attributes & Claims">
        Edita la sección de Attributes & Claims:

        1. Selecciona **Unique User Identifier (Name ID)** en "Required Claim".
        2. Cambia el atributo Source para usar `user.primaryauthoritativeemail`.
        3. En Additional claims, crea las siguientes claims:
           | Name        | Value            |
           | ----------- | ---------------- |
           | `firstName` | `user.givenname` |
           | `lastName`  | `user.surname`   |
      </Step>

      <Step title="Enviar a Mintlify tu información de IdP">
        Una vez que la aplicación esté configurada, ve a la sección "SAML Certificates" y envíanos el App Federation Metadata URL.
        Habilitaremos la conexión por nuestra parte con esta información.
      </Step>

      <Step title="Asignar usuarios">
        Ve a "Users and groups" en tu aplicación de Entra y agrega a los usuarios que deban tener acceso a tu dashboard.
      </Step>
    </Steps>
  </Tab>
</Tabs>