Compartir a través de

Tutorial: Integración del inicio de sesión único (SSO) de Microsoft Entra con EasySSO para Bamboo

  • Artículo

En este tutorial, aprenderá a integrar EasySSO para Bamboo con Microsoft Entra ID. Al integrar EasySSO para Bamboo con Microsoft Entra ID, podrá:

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

Requisitos previos

Para empezar, necesita los siguientes elementos:

  • Una suscripción a Microsoft Entra. Si no tiene una suscripción, puede obtener una cuenta gratuita.
  • Una suscripción habilitada para el inicio de sesión único de EasySSO for Bamboo.

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.

  • EasySSO for Bamboo admite el inicio de sesión único iniciado por SP e IDP.
  • EasySSO for Bamboo admite el aprovisionamiento de usuarios Just-In-Time.

Para configurar la integración de EasySSO para Bamboo en Microsoft Entra ID, debe agregar EasySSO para Bamboo desde la galería a su 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 EasySSO for Bamboo en el cuadro de búsqueda.
  4. Seleccione EasySSO for Bamboo en el panel de resultados y, a continuación, 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 y asignar roles, así como recorrer la configuración de SSO. Obtenga más información sobre los asistentes de Microsoft 365.

Configurar y probar Microsoft Entra SSO para EasySSO para Bamboo

Configurar y probar Microsoft Entra SSO con EasySSO para Bamboo utilizando un usuario de prueba llamado B.Simon. Para que el SSO funcione, es necesario establecer una relación de enlace entre un usuario de Microsoft Entra y el usuario relacionado en EasySSO para Bamboo.

Para configurar y probar Microsoft Entra SSO con EasySSO para Bamboo, realice los siguientes 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 inicio de sesión único en EasySSO for Bamboo : para configurar los valores de inicio de sesión único en la aplicación.
    1. Cree usuario de prueba EasySSO para Bamboo para tener un homólogo de B.Simon en EasySSO para Bamboo que esté vinculado a la representación Microsoft Entra del usuario.
  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 SSO 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>EasySSO for Bamboo>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.

    Edit Basic SAML Configuration

  5. En la sección Configuración básica de SAML, si desea configurar la aplicación en modo iniciado por IDP, realice los siguientes pasos:

    a. En el cuadro de texto Identificador, escriba una dirección URL con el patrón siguiente: https://<SERVER_BASE_URL>/plugins/servlet/easysso/saml

    b. En el cuadro de texto URL de respuesta, escriba una dirección URL con el siguiente patrón: https://<SERVER_BASE_URL>/plugins/servlet/easysso/saml

  6. Haga clic en Establecer direcciones URL adicionales y siga este paso si desea configurar la aplicación en el modo iniciado por SP:

    En el cuadro de texto URL de inicio de sesión, escriba una dirección URL con el siguiente patrón: https://<SERVER_BASE_URL>/login.jsp

    Nota:

    Estos valores no son reales. Actualice estos valores con los valores reales de Identificador, URL de respuesta y URL de inicio de sesión. Póngase en contacto con el equipo de soporte técnico de EasySSO para obtener estos valores en caso de duda. También puede consultar los patrones que se muestran en la sección Configuración básica de SAML.

  7. La aplicación EasySSO for Bamboo espera las aserciones de SAML en un formato específico, que requiere que se agreguen asignaciones de atributos personalizados a la configuración de los atributos del token de SAML. La siguiente captura de muestra la lista de atributos predeterminados.

    image

  8. Además de lo anterior, la aplicación EasySSO for Bamboo espera que se devuelvan algunos atributos más, que se muestran a continuación, en la respuesta de SAML. Estos atributos también se rellenan previamente, pero puede revisarlos según sus requisitos.

    Nombre Atributo de origen
    urn:oid:0.9.2342.19200300.100.1.1 user.userprincipalname
    urn:oid:0.9.2342.19200300.100.1.3 user.mail
    urn:oid:2.16.840.1.113730.3.1.241 user.displayname
    urn:oid:2.5.4.4 user.surname
    urn:oid:2.5.4.42 user.givenname

    En caso de que los usuarios de Microsoft Entra tengan sAMAccountName configurado, tendría que asignar urn:oid:0.9.2342.19200300.100.1.1 en el atributo sAMAccountName.

  9. En la página Configurar el inicio de sesión único con SAML, en la sección Certificado de firma de SAML, haga clic en los vínculos Descargar de las opciones Certificado (Base64) o XML de metadatos de federación y guarde los archivos que desee en su equipo. Los necesitará más adelante para configurar EasySSO para Bamboo.

    The Certificate download link

    Si planea realizar la configuración de EasySSO para Bamboo manualmente con certificado, también necesita copiar la URL de inicio de sesión y el Identificador de Microsoft Entra de la sección de abajo y guardarlos en su ordenador.

Cree un usuario de prueba de Microsoft Entra

En esta sección, se crea un usuario 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, habilitará a B.Simon para utilizar el inicio de sesión único concediendo acceso a EasySSO para Bamboo.

  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>EasySSO for Bamboo.
  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 en EasySSO for Bamboo

  1. En otra ventana del explorador web, inicie sesión como administrador en el sitio de la compañía Zoom

  2. Vaya a la sección Manage Apps (Administrar aplicaciones).

    Manage Apps

  3. En el lado izquierdo, busque EasySSO y haga clic en él.

    Easy SSO

  4. Seleccione la opción SAML. Esto le llevará a la sección de configuración de SAML.

    SAML

  5. Seleccione la pestaña Certificados en la parte superior y aparecerá la siguiente pantalla:

    Metadata URL

  6. Ahora, busque el certificado (Base64) o el archivo de metadatos que ha guardado en los pasos anteriores de configuración del inicio de sesión único de Microsoft Entra. Dispone de las siguientes opciones para continuar:

    a. Use el archivo de metadatos de federación de la aplicación que descargó en un archivo local del equipo. Seleccione el botón de radio Upload (Cargar) y siga el cuadro de diálogo de carga de archivos específico del sistema operativo.

    OR

    b. Abra el archivo de metadatos de federación de la aplicación para ver el contenido del archivo (en cualquier editor de texto sin formato) y cópielo en el Portapapeles. Seleccione la opción Input (Entrada) y pegue el contenido del Portapapeles en el campo de texto.

    OR

    c. Configuración totalmente manual. Abra el certificado (Base 64) de federación de la aplicación para ver el contenido del archivo (en cualquier editor de texto sin formato) y cópielo en el Portapapeles. Péguelo en el campo de texto IdP Token Signing Certificates (Certificado de firma de tokens del IdP). Después, vaya a la pestaña General y rellene los campos POST Binding URL (Dirección URL de enlace POST) y Entity ID (Identificador de entidad) con los valores respectivos de Dirección URL de inicio de sesión e Identificador de Microsoft Entra que ha guardado antes.

  7. Haga clic en el botón Save (Guardar) en la parte inferior de la página. Verá que el contenido de los archivos de metadatos o del certificado se analiza en los campos de configuración. La configuración de EasySSO for Bamboo se ha completado.

  8. Para obtener la mejor experiencia de prueba, vaya a la pestaña Look & Feel (Apariencia y aspecto) y active la opción SAML Login Button (Botón de inicio de sesión de SAML). Esto habilitará un botón separado en la pantalla de inicio de sesión de Bamboo específicamente para probar su integración de Microsoft Entra SAML de extremo a extremo. También puede dejar este botón activo y configurar su selección de ubicación, color y traducción para el modo de producción.

    Look & Feel

    Nota:

    Si tiene algún problema, póngase en contacto con el equipo de soporte técnico de EasySSO.

Creación de un usuario de prueba de EasySSO for Bamboo

En esta sección se crea una usuaria llamada Britta Simon en Bamboo. EasySSO for Bamboo admite el aprovisionamiento de usuarios Just-In-Time, que está deshabilitado de forma predeterminada. Para habilitar el aprovisionamiento de usuarios, debe marcar explícitamente la opción Create user on successful login (Crear usuario después de un inicio de sesión correcto) en la sección General de la configuración del complemento de EasySSO. Si el usuario no existe en Bamboo, se crea uno tras la autenticación.

Sin embargo, si no desea habilitar el aprovisionamiento automático de usuarios en el primer inicio de sesión del usuario, los usuarios deben existir en los directorios de usuarios de back-end para que la instancia de Bamboo los utilice, como LDAP o Atlassian Crowd.

User provisioning

Prueba de SSO

Flujo de trabajo iniciado por IDP

En esta sección, probará la configuración de inicio de sesión único de Microsoft Entra mediante Aplicaciones.

Al hacer clic en el icono de EasySSO for Bamboo en Aplicaciones, debería iniciar sesión automáticamente en la instancia de EasySSO for Bamboo para la que configurara el inicio de sesión único. Para más información acerca de Aplicaciones, consulte Inicio de sesión e inicio de aplicaciones desde el portal Aplicaciones.

Flujo de trabajo iniciado por SP

En esta sección, probará su configuración de inicio de sesión único de Microsoft Entra utilizando el botón de inicio de sesión SAML de Bamboo.

User SAML login

En este escenario se supone que ha habilitado el botón de inicio de sesión de SAML en Look & Feel (Apariencia y aspecto) en la página de configuración de EasySSO de Bamboo (consulte más arriba). Abra la dirección URL de inicio de sesión de Bamboo en el modo incógnito del explorador para evitar interferencias con las sesiones existentes. Haga clic en el botón Inicio de sesión de SAML y se le redirigirá al flujo de autenticación de usuarios de Microsoft Entra. Una vez completada correctamente, se le redirigirá de nuevo a la instancia de Bamboo como usuario autenticado mediante SAML.

Existe la posibilidad de que aparezca la siguiente pantalla después de que se le redirija de nuevo desde Microsoft Entra ID.

EasySSO failure screen

En este caso, tiene que seguir las instrucciones de esta página para acceder al archivo atlassian-bamboo.log. Los detalles del error estarán disponibles mediante el identificador de referencia que se encuentra en la página de error de EasySSO.

Si tiene algún problema con la síntesis de los mensajes de registro, póngase en contacto con el equipo de soporte técnico de EasySSO.

Pasos siguientes

Una vez configurado EasySSO for Bamboo, puede aplicar el control de sesión, que protege la información confidencial de la organización de la filtración y la infiltración en tiempo real. 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.