Configurar EasySSO para Jira para inicio de sesión único con Microsoft Entra ID

En este artículo, aprenderá a integrar EasySSO for Jira con Microsoft Entra ID. Al integrar EasySSO for Jira con Microsoft Entra ID, puede hacer lo siguiente:

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

Prerrequisitos

En el escenario descrito en este artículo se supone que ya tiene los siguientes requisitos previos:

• Una cuenta de usuario de Microsoft Entra con una suscripción activa. Si aún no tiene una, puede crear una cuenta de forma gratuita.
• Uno de los siguientes roles:
  • Administrador de aplicaciones
  • Administrador de aplicaciones en la nube
  • Propietario de la aplicación.

• Una suscripción habilitada para el inicio de sesión único de EasySSO para Jira.

Descripción del escenario

En este artículo, configura y prueba Microsoft Entra SSO en un entorno de prueba.

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

Incorporación de EasySSO para Jira desde la galería

Para configurar la integración de EasySSO for Jira en Microsoft Entra ID, es necesario agregar EasySSO for Jira 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 al menos un administrador de aplicaciones en la nube.
2. Vaya a Entra ID>Aplicaciones empresariales>Nueva aplicación.
3. En la sección Agregar desde la galería , escriba EasySSO for Jira en el cuadro de búsqueda.
4. Seleccione EasySSO for Jira en el panel de resultados y agregue la aplicación. Espere unos segundos mientras la aplicación se agrega a su arrendatario.

Como alternativa, también puede usar el Asistente para configuración de aplicaciones empresariales. En este asistente, puede agregar una aplicación a su cliente, agregar usuarios o grupos a la aplicación, asignar roles y completar la configuración de SSO. Obtenga más información sobre los asistentes de Microsoft 365.

Configuración y prueba del inicio de sesión único de Microsoft Entra ID para EasySSO for Jira

Configure y pruebe el inicio de sesión único de Microsoft Entra con EasySSO for Jira 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 de EasySSO for Jira.

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

1. Configuración del inicio de sesión único de Microsoft Entra: para que los usuarios puedan utilizar esta característica.
   1. Creación de 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. Configure EasySSO for Jira SSO - para configurar los ajustes de inicio de sesión único en el lado de la aplicación.
   1. Creación de un usuario de prueba de EasySSO for Jira: para tener un homólogo de B.Simon en EasySSO for Jira que esté vinculado a la representación del usuario en Microsoft Entra.
3. Prueba del inicio de sesión único: para comprobar si la configuración funciona.

Configurar el SSO de Microsoft Entra

Siga estos pasos para activar el SSO de Microsoft Entra.

1. Inicie sesión en el Centro de administración de Microsoft Entra como al menos un administrador de aplicaciones en la nube.

2. Vaya a Entra ID>Enterprise apps>EasySSO para Jira>Inicio de sesión único.

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

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

   

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

   a) En el cuadro de texto Identificador , escriba una dirección URL con el siguiente patrón: 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. Seleccione Establecer direcciones URL adicionales y realice el paso siguiente si desea configurar la aplicación en 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 el identificador real, la dirección URL de respuesta y la dirección URL de inicio de sesión. Póngase en contacto con el equipo de soporte técnico de EasySSO para obtener estos valores si tiene dudas. 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 Jira 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. En la captura de pantalla siguiente se muestra la lista de atributos predeterminados.

   

8. Además de lo anterior, la aplicación EasySSO for Jira 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	apellido de usuario
   urn:oid:2.5.4.42	user.givenname

   En caso de que los usuarios de Microsoft Entra tengan configurado el atributo sAMAccountName, tendrían que asignar urn:oid:0.9.2342.19200300.100.1.1 al 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, seleccione los enlaces de Descargar para las opciones Certificado (Base64) o XML de metadatos de federación y guarde uno, varios o todos en su equipo. Lo necesitará más adelante para configurar Jira EasySSO.

   

   Si tiene previsto realizar la configuración de EasySSO para Jira manualmente con el certificado, también debe copiar la dirección URL de inicio de sesión y el identificador de Microsoft Entra de la sección siguiente y guardarlas en el equipo.

Creación y asignación de un usuario de prueba de Microsoft Entra

Siga las instrucciones de creación y asignación de una cuenta de usuario de inicio rápido para crear una cuenta de usuario de prueba llamada B.Simon.

Configuración del inicio de sesión único en EasySSO for Jira

1. Inicie sesión en la instancia de Atlassian Jira con privilegios de administrador y vaya a la sección Administrar aplicaciones .

   

2. En el lado izquierdo, busque EasySSO y selecciónelo.

   

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

   

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

   

5. Ahora, localice el Certificate (Base64) o el Archivo de metadatos que guardó en los pasos anteriores de la configuración de SSO 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 botón de opción Cargar y siga el cuadro de diálogo de carga de archivos específico para su sistema operativo.

   O

   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 Entrada y pegue el contenido del Portapapeles en el campo de texto.

   O

   c. Configuración totalmente manual. Abra el certificado de federación de aplicaciones (Base64) para ver el contenido (en cualquier editor de texto sin formato) del archivo y copiarlo en el Portapapeles. Pégalo en el campo de texto Certificados de firma de tokens de IdP. Luego navegue a la pestaña General y llene los campos POST Binding URL y Entity ID con los valores respectivos para URL de inicio de sesión y el Identificador de Microsoft Entra que guardó previamente.

6. Seleccione el botón Guardar en la parte inferior de la página. Verá que el contenido de los archivos de metadatos o certificados se analiza en los campos de configuración. La configuración de EasySSO for Jira se ha completado.

7. Para obtener la mejor experiencia de prueba, vaya a la pestaña Aspecto y sensación y active la opción Botón de inicio de sesión de SAML. Esto habilitará un botón independiente en la pantalla de inicio de sesión de Jira para probar específicamente la integración de SAML de Microsoft Entra de un extremo a otro. 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.

   

   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 Jira

En esta sección, se crea el usuario B.Simon en Jira. EasySSO para Jira admite el aprovisionamiento de usuarios Just-In-Time, que está deshabilitado de forma predeterminada. Para habilitar el aprovisionamiento de usuarios, debe comprobar explícitamente la opción Crear usuario al iniciar sesión correctamente en la sección General de la configuración del complemento EasySSO. Si aún no existe el usuario en Jira, se crea uno después de 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 usuario back-end de los que la instancia de Jira use, como LDAP o Atlassian Crowd.

Prueba del inicio de sesión único

Flujo de trabajo iniciado por IDP

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

• Seleccione Probar esta aplicación. Se debería iniciar sesión automáticamente en la instancia de EasySSO para Jira para la que configuró el inicio de sesión único.

También puedes usar Mis aplicaciones de Microsoft para probar la aplicación en cualquier modo. Al seleccionar el icono de EasySSO for Jira en Mis Aplicaciones, si se ha configurado en modo SP, se le redirigirá a la página de inicio de sesión de la aplicación para comenzar el flujo de inicio de sesión y, si se ha configurado en modo IDP, debería iniciar sesión automáticamente en la instancia de EasySSO for Jira para la que configuró el inicio de sesión único. Para obtener más información sobre Mis aplicaciones, vea Introducción a mis aplicaciones.

Flujo de trabajo iniciado por SP

En esta sección, probará la configuración de inicio de sesión único de Microsoft Entra mediante el botón SAML Login de Jira.

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

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

En este caso, debe seguir las instrucciones de esta página para obtener acceso al archivo atlassian-jira.log . Los detalles del error están disponibles mediante el identificador de referencia que se encuentra en la página de error easySSO.

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

Contenido relacionado

Una vez configurado EasySSO for Jira, puede aplicar el control de sesión, que protege la exfiltración y la infiltración de la información confidencial de la organización en tiempo real. El control de sesión se extiende desde el acceso condicional. Obtenga información sobre cómo aplicar el control de sesión con Microsoft Defender for Cloud Apps.