Puede asignar dominios a su proveedor de identidad para agilizar la experiencia de inicio de sesión de los usuarios de dominios específicos autenticándolos a través de un proveedor de identidad. La asignación de dominios garantiza que todos los usuarios con un dominio particular en su dirección de correo electrónico tengan la misma experiencia de inicio de sesión.
Importante
Cuando se asigna un único dominio a varios proveedores de identidad, los usuarios que inician sesión utilizando la consola de MongoDB Cloud son redirigidos automáticamente al proveedor de identidad asociado con la primera aplicación SAML proveedor de identidad que se configuró para Atlas.
Para utilizar un proveedor de identidad alternativo, los usuarios deben iniciar sesión a través de una URL de inicio de sesión iniciada por el SP o el proveedor de identidad.
Para mapear un dominio a tu proveedor de identidad, debes verificar que eres propietario del dominio. Puedes ver estas posibilidades:
Cargue un archivo HTML que contenga una clave de verificación a un host en su dominio o
Crear un DNS Registro TXT que contiene una clave de verificación.
Acceso requerido
Para gestionar la autenticación federada, debes tener
Organization Owner acceso a una o más organizaciones que están delegando la configuración de federación a la instancia.
Requisitos previos
Para completar este tutorial, primero debe haber vinculado un proveedor de identidad a Atlas. Para aprender a vincular un IdP a Atlas, consulte Administrar proveedores de identidad.
Mapea un dominio a tu proveedor de identidades
En Atlas, ve a Federation Management consola para su organización.
Si aún no se muestra, selecciona la organización deseada en el menú Organizations de la barra de navegación.
En la barra lateral, haz clic en Federation en la sección Identity & Access.
Haga clic en Open Federation Management App.
La página de Federación se muestra.
Ingresa la información de mapeo del dominio.
Haga clic en Add a Domain.
En la pantalla Domains, haz clic en Add Domain.
Ingresa la siguiente información para el mapeo de tu dominio:
CampoDescripciónDisplay Name
Nombre para identificar fácilmente el dominio.
Nombre de dominio
Nombre de dominio para asignar.
Haga clic en Next.
Elige cómo verificar tu dominio.
Nota
Puedes elegir el método de verificación una vez. No se puede modificar. Para seleccionar otro método de verificación, borra y recrea el mapeo de dominio.
Selecciona la pestaña adecuada en función de si cargarás un archivo HTML o crearás un registro DNS TXT para verificar tu dominio:
Se puede cargar un archivo HTML que contenga una clave de verificación para verificar que se es el propietario del dominio.
Haga clic en HTML File Upload.
Haga clic en Next.
Descarga el archivo
mongodb-site-verification.htmlque proporciona Atlas.Se puede cargar el archivo HTML en un sitio web del dominio. Se debe poder acceder al archivo en
<https://host.domain>/mongodb-site-verification.html.Haga clic en Finish.
Crea un registro TXT de DNS con tu proveedor de dominio para verificar que eres el propietario de tu dominio. Cada registro DNS asocia una organización de Atlas específica con un dominio específico.
Haga clic en DNS Record.
Haga clic en Next.
Copia el registro TXT proporcionado. El registro TXT tiene la siguiente forma:
mongodb-site-verification=<32-character string> Inicia sesión en tu proveedor de nombre de dominio (como GoDaddy.com o networksolutions.com).
Agrega el registro TXT que Atlas proporciona a tu dominio.
Regresa a Atlas y haz clic en Finish.
Verifica tu dominio.
En la pantalla Domains, se muestran los dominios verificados y no verificados que has asignado a tu proveedor de identidad. Para verificar tu dominio, haz clic en el botón Verify del dominio de destino. Atlas muestra si la verificación se ha realizado correctamente en un banner en la parte superior de la pantalla.
Asocia tu dominio con tu proveedor de identidad
Después de verificar correctamente tu dominio, asocia el dominio con tu proveedor de identidad:
Ir a la página Identity Providers.
En Atlas, ir a la consola Federation Management de la Organización.
Si aún no se muestra, selecciona la organización deseada en el menú Organizations de la barra de navegación.
En la barra lateral, haz clic en Federation en la sección Identity & Access.
Haga clic en Open Federation Management App.
La página de Federación se muestra.
En la barra lateral, haga clic en Identity Providers.
Prueba tu asignación de dominio
Importante
Antes de comenzar las pruebas, copia y guarda la URL del Modo de SAML de omisión para tu proveedor de identidad. Usa esta URL para omitir la autenticación federada si no puedes acceder a tu organización Atlas.
Durante las pruebas, mantén iniciada la sesión en la Federation Management Console para evitar bloqueos.
Para aprender más sobre Bypass SAML Mode, consulta Modo de SAML de omisión.
Para probar la integración entre su dominio y su IdP:
Haga clic en Next.
Si mapeaste tu dominio correctamente, serás redirigido a tu proveedor de identidad para autenticarte. Si la autenticación con tu proveedor de identidad tiene éxito, se te redirigirá nuevamente a Atlas.
Nota
Puedes evitar la página de inicio de sesión de Atlas navegando directamente al Login URL de tu proveedor de identidad. El Login URL lo lleva directamente a su proveedor de identidad para autenticarse.
Borrar un mapeo de dominio
Abierto el Federation Management Console
En Atlas, ir a la consola Federation Management de la Organización.
Si aún no se muestra, selecciona la organización deseada en el menú Organizations de la barra de navegación.
En la barra lateral, haz clic en Federation en la sección Identity & Access.
Haga clic en Open Federation Management App.
La página de Federación se muestra.
Borra el dominio
En Atlas, ir a la consola Federation Management de la Organización.
Si aún no se muestra, selecciona la organización deseada en el menú Organizations de la barra de navegación.
En la barra lateral, haz clic en Federation en la sección Identity & Access.
Haga clic en Open Federation Management App.
La página de Federación se muestra.
Borrar el dominio.
Importante
No se puede eliminar una asignación de dominio si está asociada a un IdP. Para desasociar un dominio de un IdP:
- Desde la consola de administración, haga clic en Identity Providers
- en la navegación a la izquierda.
- Para el IdP que desea disociar de su dominio, haga clic en
- Edit junto a Associated Domains.
Deselecciona el dominio deseado.
Haga clic en Confirm.
Para borrar un dominio de la instancia de Gestión de Federación:
Haga clic en Add a Domain.
Abra el menú Actions del dominio que desea eliminar.
Haga clic en Delete.
Haga clic en Confirm.