Comparteix a través de

Integración del inicio de sesión único de Microsoft Entra con Docker

  • Article

En este tutorial, aprenderá a integrar Docker con Microsoft Entra ID. Al integrar Docker con Microsoft Entra ID, puede:

  • Controlar en Microsoft Entra ID quién tiene acceso a Docker.
  • Permitir que los usuarios puedan iniciar sesión automáticamente en Docker con sus cuentas de Microsoft Entra.
  • Administre sus cuentas en una ubicación central.

Requisitos previos

Para integrar Microsoft Entra ID con Docker, necesita lo siguiente:

Descripción del escenario

En este tutorial va a configurar y probar el inicio de sesión único de Microsoft Entra en un entorno de prueba.

  • Docker solo admite SP inicio de sesión único iniciado.
  • Docker admite el aprovisionamiento de usuarios Just-In-Time.

Para configurar la integración de Docker en Microsoft Entra ID, debe agregar Docker desde la galería a la lista de aplicaciones SaaS administradas.

  1. Inicie sesión en el Centro de administración de Microsoft Entra como Administrador de aplicaciones en la nube.
  2. Vaya a Identidad>Aplicaciones>Aplicaciones empresariales>Nueva aplicación.
  3. En la sección Agregar desde la galería, escriba Docker en el cuadro de búsqueda.
  4. Seleccione Docker en el panel de resultados y agregue la aplicación. Espere unos segundos mientras la aplicación se agrega al inquilino.

Si lo desea, puede usar también el asistente para la configuración de aplicaciones empresariales. En este asistente puede agregar una aplicación al inquilino, agregar usuarios o grupos a la aplicación, asignar roles y recorrer la configuración de inicio de sesión único. Obtenga más información sobre los asistentes de Microsoft 365.

Configuración y prueba del inicio de sesión único de Microsoft Entra para Docker

Configure y pruebe el inicio de sesión único de Microsoft Entra con Docker mediante un usuario de prueba llamado B.Simon. Para que el inicio de sesión único funcione, es necesario establecer una relación de vínculo entre un usuario de Microsoft Entra y el usuario relacionado en Docker.

Para configurar y probar el inicio de sesión único de Microsoft Entra con Docker, siga estos pasos:

  1. Configure el inicio de sesión único de Microsoft Entra, para que los usuarios puedan usar esta característica.
    1. Cree un usuario de prueba de Microsoft Entra para probar el inicio de sesión único de Microsoft Entra con B.Simon.
    2. Asigne el usuario de prueba de Microsoft Entra, para permitir que B.Simon use el inicio de sesión único de Microsoft Entra.
  2. Configuración del SSO en Docker para configurar los valores del inicio de sesión único en la aplicación.
    1. Crear un usuario de prueba de Docker: para tener un homólogo de B.Simon en Docker que esté vinculado a la representación del usuario en Microsoft Entra ID.
  3. Prueba del inicio de sesión único : para comprobar si la configuración funciona.

Configuración del inicio de sesión único de Microsoft Entra

Siga estos pasos para habilitar el inicio de sesión único de Microsoft Entra en el centro de administración de Microsoft Entra.

  1. Inicie sesión en el Centro de administración de Microsoft Entra como Administrador de aplicaciones en la nube.

  2. Vaya a Identidad>Aplicaciones>Aplicaciones empresariales>Docker>Inicio de sesión único.

  3. En la página Seleccione un método de inicio de sesión único, elija SAML.

  4. En la página Configuración del inicio de sesión único con SAML, haga clic en el icono de lápiz de Configuración básica de SAML para editar la configuración.

    Captura de pantalla que muestra cómo editar una configuración básica de SAML.

  5. En la sección Configuración básica de SAML, siga estos pasos:

    a. En el cuadro de texto Identificador (id. de entidad) , escriba un valor con el siguiente patrón: urn:auth0:docker-prod:<Docker_SsoID>

    b. En el cuadro de texto URL de respuesta, escriba una dirección URL con el siguiente patrón: https://login.docker.com/login/callback?connection=<Docker_SsoID>

    c. En el cuadro de texto URL de inicio de sesión, escriba una dirección URL con el siguiente patrón: https://hub.docker.com/auth/start?connection=<Docker_SsoID>

    Nota:

    Estos valores no son reales. Actualice estos valores con el identificador y las direcciones URL de inicio de sesión y de respuesta reales. Obtendrá estos valores al configurar el inicio de sesión único de Docker. También puede consultar los patrones que se muestran en la sección Configuración básica de SAML del centro de administración de Microsoft Entra.

  6. La aplicación Docker espera identificador de usuario único asignado a una dirección de correo electrónico (user.mail) en lugar de user.userprincipalname y también admite givenname y apellidos para sincronizar el nombre completo de los usuarios en la aplicación Docker. La siguiente captura de muestra la lista de atributos predeterminados.

    Captura de pantalla que muestra la imagen de los atributos.

    Nota:

    Elimine name e emailaddress manualmente de los atributos predeterminados anteriores en el portal Entra según los requisitos de la aplicación.

  7. Además de lo anterior, la aplicación Docker admite atributos opcionales que se van a devolver en la respuesta de SAML, que se muestran a continuación. Estos atributos se pueden agregar para administrar el aprovisionamiento de usuarios en equipos específicos y sus roles dentro de la organización de Docker. Para más información sobre todos los atributos que admite Docker SSO, consulte el documento Docker SSO.

    Nombre de notificación Espacio de nombres Atributo de origen
    dockerOrg <empty> Nombre de la organización de Docker
    dockerTeam <empty> Nombre del equipo de Docker
    dockerRole <empty> Rol de usuario en la organización. Valores permitidos: “propietario”, “editor”, “miembro”.

    Nota:

    Si la organización requiere administrar usuarios en varios equipos, también se pueden habilitar las notificaciones de grupo. Para obtener más información sobre la administración de grupos de SSO de Docker, haga clic aquí.

  8. En la página Configurar el inicio de sesión único con SAML, en la sección Certificado de firma de SAML, busque Certificado (Base64) y seleccione Descargar para descargarlo y guardarlo en el equipo.

    Captura de pantalla del vínculo de descarga del certificado.

  9. En la sección Configurar Docker, copie las direcciones URL adecuadas según sus necesidades.

    Captura de pantalla que muestra la copia de las URL de configuración.

Cree un usuario de prueba de Microsoft Entra

En esta sección, creará un usuario de prueba en el centro de administración de Microsoft Entra llamado B.Simon.

  1. Inicie sesión en el Centro de administración de Microsoft Entra al menos como Administrador de usuario.
  2. Vaya aIdentidad>Usuarios>Todos los usuarios.
  3. Seleccione Nuevo usuario>Crear nuevo usuario, en la parte superior de la pantalla.
  4. En las propiedades del usuario, siga estos pasos:
    1. En el campo Nombre para mostrar, escriba B.Simon.
    2. En el campo Nombre principal de usuario, escriba username@companydomain.extension. Por ejemplo, B.Simon@contoso.com.
    3. Active la casilla Show password (Mostrar contraseña) y, después, anote el valor que se muestra en el cuadro Contraseña.
    4. Seleccione Revisar + crear.
  5. Seleccione Crear.

Asignación del usuario de prueba de Microsoft Entra

En esta sección, va a permitir que B.Simon acceda a Docker mediante el inicio de sesión único de Microsoft Entra.

  1. Inicie sesión en el Centro de administración de Microsoft Entra como Administrador de aplicaciones en la nube.
  2. Vaya a Identidad>Aplicaciones>Aplicaciones empresariales>Docker.
  3. En la página de información general de la aplicación, seleccione Usuarios y grupos.
  4. Seleccione Agregar usuario o grupo. A continuación, en el cuadro de diálogo Agregar asignación, seleccione Usuarios y grupos.
    1. En el cuadro de diálogo Usuarios y grupos, seleccione B.Simon de la lista de usuarios y haga clic en el botón Seleccionar de la parte inferior de la pantalla.
    2. Si espera que se asigne un rol a los usuarios, puede seleccionarlo en la lista desplegable Seleccionar un rol. Si no se ha configurado ningún rol para esta aplicación, verá seleccionado el rol "Acceso predeterminado".
    3. En el cuadro de diálogo Agregar asignación, haga clic en el botón Asignar.

Configuración del inicio de sesión único de Docker

  1. Inicie sesión en el sitio empresarial de Docker como administrador.

  2. Seleccione su organización o empresa en el menú desplegable izquierdo y haga clic en SSO & SCIM.

  3. En la tabla conexiones de SSO, seleccione Crear conexión y cree un nombre para la conexión.

    Nota:

    Debe comprobar al menos un dominio antes de crear las conexiones.

  4. Seleccione SAML como método de autenticación y realice los pasos siguientes:

    Captura de pantalla que muestra la configuración.

    1. Copie el valor de Id. de entidad y péguelo en el cuadro de texto Identificador (id. de entidad) de la sección Configuración básica de SAML en el Centro de administración de Microsoft Entra.

    2. Copie el valor URL de ACS y péguelo en el cuadro de texto URL de respuesta de la sección Configuración básica de SAML del centro de administración de Microsoft Entra.

    3. En el campo dirección URL de inicio de sesión de SAML, pegue el valor dirección URL de inicio de sesión, que copió del Centro de administración de Microsoft Entra.

    4. Abra el certificado (Base64) descargado en el Bloc de notas y pegue el contenido en el cuadro de texto Certificado clave x509.

    5. Haga clic en Siguiente y Guardar conexión.

Creación de un usuario de prueba de Docker

En esta sección, se crea un usuario llamado Britta Simon en Docker. Docker admite el aprovisionamiento de usuarios Just-In-Time, que está habilitado de forma predeterminada. No hay ningún elemento de acción para usted en esta sección. Si un usuario no existe en Docker, se crea otro después de la autenticación.

Prueba de SSO

En esta sección va a probar la configuración de inicio de sesión único de Microsoft Entra con las siguientes opciones.

  • Haga clic en Probar esta aplicación en el centro de administración de Microsoft Entra. Esta acción le redirigirá a la dirección URL de inicio de sesión en Docker, donde puede iniciar el flujo de inicio de sesión.

  • Vaya directamente a la dirección URL de inicio de sesión en Docker y comience el flujo de inicio de sesión desde allí.

  • Puede usar Mis aplicaciones de Microsoft. Al hacer clic en el icono de Docker en Aplicaciones, se le redirigirá a la URL de inicio de sesión de la aplicación. Para más información acerca de Aplicaciones, consulte Inicio de sesión e inicio de aplicaciones desde el portal Aplicaciones.

Pasos siguientes

Una vez configurado Docker, puede aplicar el control de sesión, que protege a su organización, en tiempo real, frente a la filtración e infiltración de datos confidenciales. El control de sesión procede del acceso condicional. Aprenda a aplicar el control de sesión con Microsoft Defender para aplicaciones en la nube.