Compartir por

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

  • Artigo

En este tutorial, aprenderá a integrar EasySSO para Confluence con Microsoft Entra ID. Al integrar Kantega SSO para Confluence con Microsoft Entra ID, puede hacer lo siguiente:

  • Controlar en Microsoft Entra ID quién tiene acceso a Confluence.
  • Permitir que sus usuarios inicien sesión automáticamente en Confluence 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.
  • Suscripción de EasySSO for Confluence con el inicio de sesión único habilitado.

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

Para configurar la integración de EasySSO para Confluence en Microsoft Entra ID, debe agregar EasySSO para Confluence 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 Confluence en el cuadro de búsqueda.
  4. Seleccione EasySSO for Confluence 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.

Configurar y probar Microsoft Entra SSO para EasySSO para Confluence

Configure y pruebe Microsoft Entra SSO con EasySSO para Confluence 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 Confluence.

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

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

    The Certificate download link

    Si tiene previsto realizar la configuración de EasySSO para Confluence manualmente con certificado, también deberá copiar la URL de inicio de sesión y el Identificador de Microsoft Entra de la sección siguiente 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, permitirá que B.Simon use el inicio de sesión único para conceder acceso a EasySSO for Confluence.

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

  1. En otra ventana del explorador web, inicie sesión como administrador en el sitio de la compañía EasySSO for Confluence y vaya a la sección Administrar aplicaciones.

    Manage Apps

  2. En el lado izquierdo, busque EasySSO y haga clic en él. A continuación, haga clic en el botón Configurar.

    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. Se ha completado la configuración de EasySSO for Confluence.

  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 separado en la pantalla de inicio de sesión de Confluence 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 Confluence

En esta sección, se crea un usuario llamado Britta Simon en Confluence. EasySSO for Confluence 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 un usuario deja de existir en Confluence, se crea otro 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 Confluence 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 Confluence en Mis aplicaciones, se debería iniciar sesión automáticamente en la instancia de Confluence para la que configuró 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, se prueba la configuración de inicio de sesión único de Microsoft Entra mediante el botón de Inicio de sesión SAML de Confluence.

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 Confluence EasySSO (consulte más arriba). Abra la dirección URL de inicio de sesión de Confluence 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 Confluence como usuario autenticado mediante SAML.

Existe la posibilidad de que aparezca la siguiente pantalla después de ser redirigido desde Microsoft Entra ID

EasySSO failure screen

En este caso, tiene que seguir las instrucciones de esta página para acceder al archivo atlassian-confluence.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 que haya configurado EasySSO for Confluence, puede aplicar el control de sesión, que protege su organización en tiempo real frente a la filtración e infiltración de información confidencial. 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.