Compartir a través de

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

  • Artículo

En este tutorial, 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.

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

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 Jira admite el inicio de sesión único iniciado por SP e IDP.
  • EasySSO for Jira admite el aprovisionamiento de usuarios Just-In-Time.

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

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. 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 Jira , para configurar los valores de inicio de sesión único en la aplicación.
    1. Cree un usuario de prueba de EasySSO for Jira, para tener un homólogo de B.Simon en EasySSO for Jira 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.

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 Jira para JIRA>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 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. La siguiente captura de muestra la lista de atributos predeterminados.

    image

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

    The Certificate download link

    Si va a realizar la configuración de EasySSO for Jira manualmente con certificado, también necesitará copiar la dirección URL de inicio de sesión y el identificador de Microsoft Entra en la siguiente sección y guardarlos en el equipo.

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 va a permitir que B.Simon acceda a EasySSO for Jira mediante el inicio de sesión único.

  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 Jira para JIRA.
  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 Jira

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

    Manage Apps

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

    Easy SSO

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

    SAML

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

    Metadata URL

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

  6. 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 Jira se ha completado.

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

    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 Jira

En esta sección, se crea el usuario B.Simon en Jira. EasySSO for Jira 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 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 usuarios de back-end para que la instancia de Jira los utilice, como LDAP o Atlassian Crowd.

User provisioning

Prueba de SSO

Flujo de trabajo iniciado por IDP

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. Se debería iniciar sesión automáticamente en la instancia de EasySSO for Jira para la que configuró el inicio de sesión único.

También puede usar Aplicaciones de Microsoft para probar la aplicación en cualquier modo. Al hacer clic en 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, se debería iniciar sesión automáticamente en la instancia de EasySSO for Jira para la que ha configurado 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á la configuración de inicio de sesión único de Microsoft Entra mediante el botón SAML Login (Inicio de sesión de SAML) de Jira.

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 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. 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 Jira 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-jira.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 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 procede del acceso condicional. Aprenda a aplicar el control de sesión con Microsoft Defender para aplicaciones en la nube.