Saltar al contenido principal
SSO está disponible en los planes Enterprise.
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 para configurar SSO.

​
Configurar SSO

​
Okta

1

Configurar Okta SSO en tu dashboard de Mintlify

  1. En tu dashboard de Mintlify, ve a la página Security.
  2. Haz clic en Configure.
  3. Selecciona Okta SAML.
  4. Copia la Single sign on URL y la Audience URI.
2

Crear 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:
3

Copiar la URL de metadatos de Okta

En Okta, ve a la pestaña Sign On de tu aplicación y copia la URL de metadatos.
4

Guardar en Mintlify

De vuelta en el dashboard de Mintlify, pega la URL de metadatos y haz clic en Save changes.

​
Microsoft Entra

1

Configurar Microsoft Entra SSO en tu dashboard de Mintlify

  1. En tu dashboard de Mintlify, ve a la página Security.
  2. Haz clic en Configure.
  3. Selecciona Microsoft Entra ID SAML.
  4. Copia la Single sign on URL y la Audience URI.
2

Crear una aplicación empresarial en Microsoft Entra

  1. En Microsoft Entra, ve a Enterprise applications.
  2. Haz clic en New application.
  3. Haz clic en Create your own application.
  4. Selecciona “Integrate any other application you don’t find in the gallery (Non-gallery).”
3

Configurar SAML en Microsoft Entra

  1. En Microsoft Entra, ve a Single Sign-On.
  2. Haz clic en 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 demás valores en blanco y haz clic en Save.
4

Configurar Attributes & Claims en Microsoft Entra

  1. En Microsoft Entra, ve 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:
5

Copiar la URL de metadatos de Microsoft Entra

En SAML Certificates, copia la App Federation Metadata URL.
6

Guardar en Mintlify

De vuelta en el dashboard de Mintlify, pega la URL de metadatos y haz clic en Save changes.
7

Asignar usuarios

En Microsoft Entra, ve a Users and groups. Asigna los usuarios que deben tener acceso a tu dashboard de Mintlify.

​
Aprovisionamiento JIT

Cuando habilitas el aprovisionamiento JIT (just-in-time), los usuarios que inician sesión a través de tu proveedor de identidad se agregan automáticamente a tu organización de Mintlify.
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.
Para habilitar el aprovisionamiento JIT, debes tener SSO habilitado. Ve a la página Security en tu dashboard, configura el SSO y luego habilita el aprovisionamiento JIT.

​
Dominios verificados

Verifica la propiedad de tus dominios de correo electrónico para que Mintlify pueda limitar el SSO y el aprovisionamiento de miembros a personas con direcciones de correo coincidentes. Cuando alguien inicia sesión con una dirección de correo en un dominio verificado, Mintlify lo enruta automáticamente a tu proveedor de identidad. El enrutamiento automático funciona tengas o no activada la exigencia de SSO, siempre que tu organización tenga una conexión SSO activa. Puedes añadir hasta 25 dominios verificados por organización. La sección Verified domains solo aparece cuando tu conexión SSO está activa. Configura SSO antes de añadir dominios.
  1. Ve a la página Security en tu dashboard.
  2. En la sección SSO, en Verified domains, introduce el dominio (por ejemplo, example.com) y haz clic en Add.
  3. Mintlify genera un token de verificación. En tu proveedor de DNS, crea un registro TXT con el nombre _mintlify-verification.example.com y el token como valor. Algunos proveedores de DNS agregan el dominio automáticamente. Si el tuyo lo hace, introduce solo _mintlify-verification como nombre del registro.
  4. Vuelve al dashboard y haz clic en Verify. El estado cambia de Pending a Verified una vez que el registro se propaga.
Para eliminar un dominio, haz clic en el botón de eliminar junto a él.

​
Requerir SSO

Para exigir que todos los miembros de tu organización inicien sesión a través de tu proveedor de identidad, activa Require SSO. Cuando Require SSO está activado, Mintlify rechaza los inicios de sesión con contraseña, enlace mágico y Google OAuth.
  1. Ve a la página Security en tu dashboard.
  2. Confirma que el SSO funciona de extremo a extremo. En una ventana de navegación privada, inicia sesión en tu dashboard de Mintlify desde el catálogo de aplicaciones de tu proveedor de identidad (iniciado por el IdP) y desde la página de inicio de sesión de Mintlify con un correo electrónico de un dominio verificado (iniciado por el SP). Ambos flujos deben redirigirte a través de tu proveedor de identidad y llevarte al dashboard.
  3. En la sección SSO, activa Require SSO.
Solo puedes requerir SSO después de configurar una conexión SSO. Requerir SSO no comprueba si los miembros pueden seguir iniciando sesión, así que añade acceso de emergencia (break-glass) para al menos un administrador antes de activarlo.
Para dejar de requerir SSO, desactiva la opción. Los demás métodos de inicio de sesión vuelven a estar disponibles de inmediato.

​
Acceso de emergencia (break-glass)

Designa a los miembros que pueden omitir el SSO e iniciar sesión con contraseña o enlace mágico. Usa el acceso de emergencia (break-glass) para recuperar el acceso si tu proveedor de identidad sufre una interrupción o una configuración incorrecta deja a los miembros sin acceso.
  1. Ve a la página Security en tu dashboard.
  2. En la sección SSO, en Break-glass emails, introduce la dirección de correo electrónico de un miembro que deba conservar el acceso sin SSO y haz clic en Add.
Cada correo de emergencia (break-glass) debe pertenecer a un miembro existente de tu organización. El acceso de emergencia (break-glass) solo surte efecto mientras Require SSO esté activado.
Añade acceso de emergencia (break-glass) para cuentas de administrador que no estén vinculadas a tu proveedor de identidad principal. Guarda las credenciales en un gestor de contraseñas seguro y revisa la lista cada vez que cambie la composición del equipo.

​
Mapear roles RBAC con grupos SAML

Asigna 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 asigna esos grupos a roles del dashboard.

​
Configurar declaraciones de atributos de grupo

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.
Example SAML assertion
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
En la configuración de tu aplicación SAML de Okta, añade una declaración de atributo de grupo:Ajusta el filtro para que coincida con los grupos específicos que deseas enviar a Mintlify.
Una vez configurado, Mintlify asigna los nombres de los grupos de la aserción SAML a los roles de tu organización. Para configurar o modificar las asignaciones de grupo a rol, contacta a tu representante de cuenta de Mintlify.

​
Cambiar o eliminar el proveedor de SSO

  1. Ve a la página Security en tu dashboard.
  2. Haz clic en Configure.
  3. Selecciona tu proveedor de SSO preferido o ningún SSO.
Si eliminas el SSO, los usuarios deberán autenticarse con una contraseña, un enlace mágico o Google OAuth en su lugar.

​
Otros proveedores

Para proveedores distintos de Microsoft Entra u Okta SAML, contáctanos para configurar SSO.

​
Google Workspace con SAML

1

Crear una aplicación

  1. En Google Workspace, ve a Web and mobile apps.
  2. Haz clic en Add custom SAML app en el menú desplegable Add app.
2

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.
3

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
En la página siguiente, introduce las siguientes declaraciones de atributos:Cuando completes este paso y los usuarios estén asignados a la aplicación, avísanos y habilitaremos el SSO para tu cuenta.

​
Okta (OIDC)

1

Crear una aplicación

En Okta, en Applications, crea una nueva integración de aplicación usando OIDC. Selecciona el tipo Web Application.
2

Configurar la integración

Selecciona el tipo de concesión Authorization Code e introduce el Redirect URI proporcionado por Mintlify.
3

Envíanos la información de tu IdP

Ve a la pestaña General y localiza el client ID y el client secret. Envíanoslos 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.

Temas relacionados

VisibilityInicio rápidoRoles