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

  • Artículo

En este tutorial, aprenderá a integrar Contentstack con Microsoft Entra ID. Al integrar Contentstack con Microsoft Entra ID, puede hacer lo siguiente:

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

Requisitos previos

Para integrar Microsoft Entra ID con Contentstack, necesita:

  • 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 (SSO) en Contentstack.

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.

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

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

Configure y pruebe el inicio de sesión único de Microsoft Entra con Contentstack mediante un usuario de prueba llamado B.Simon. Para que el inicio de sesión único funcione, es preciso establecer una relación de vinculación entre un usuario de Microsoft Entra y el usuario relacionado de Contentstack.

Para configurar y probar el inicio de sesión único de Microsoft Entra con Contentstack, 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 de Contentstack, para configurar los valores del inicio de sesión único en la aplicación.
    1. Cree un usuario de prueba de Contentstack: para tener un homólogo de B.Simon en Contentstack 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.

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 un Administrador de aplicaciones en la nube y, a continuación, vaya aIdentidad>Aplicaciones>Aplicaciones de empresa.

  2. Ahora haga clic en + Nueva aplicación y busque Contentstack y haga clic en Crear. Cuando se haya creado, vaya a Configurar inicio de sesión único o haga clic en el vínculo Inicio de sesión único en el menú de la izquierda.

    Screenshot shows the new application creation.

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

    Screenshot shows how to select a single sign-on method.

  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.

    Screenshot shows how to edit Basic SAML Configuration.

  5. En la sección Configuración básica de SAML, debe realizar algunos pasos. A fin de obtener la información necesaria para estos pasos, primero deberá ir a la aplicación Contentstack y crear el Nombre de SSO y la Dirección URL de ACS de la siguiente manera:

    a. Inicie sesión en la cuenta de Contentstack, vaya a la página Configuración de la organización y haga clic en la pestaña Inicio de sesión único.

    Screenshot shows the steps for Basic SAML Configuration.

    b. Escriba el Nombre de SSO que elija y haga clic en Crear.

    Screenshot shows how to enter or create name.

    Nota:

    Por ejemplo, si el nombre de la empresa es "Acme, Inc." escriba "acme" aquí. Los usuarios de la organización usarán este nombre como una de las credenciales de inicio de sesión al iniciar sesión. El nombre de inicio de sesión único solo puede contener alfabetos (en minúsculas), números (0-9) o guiones (-).

    c. Al hacer clic en Crear, se generará la URL del Servicio de consumidor de aserciones o la URL de ACS, y otros detalles, como Id. de entidad, Atributos y Formato de NameID.

    Screenshot shows generating the values to configure.

  6. De nuevo en la sección Configuración básica de SAML, pegue el Id. de entidad y la URL de ACS generadas en el conjunto anterior de pasos, en las secciones Identificador (id. de entidad) y URL de respuesta, respectivamente, y guarde las entradas.

    1. En el cuadro de texto Identificador, pegue el valor Id. de entidad que ha copiado de Contentstack.

      Screenshot shows how to paste the Identifier value.

    2. En el cuadro de texto URL de respuesta, pegue la URL de ACS que ha copiado de Contentstack.

      Screenshot shows how to paste the Reply URL.

  7. Este paso es opcional. Si quiere configurar la aplicación en modo iniciado por SP, escriba la URL de inicio de sesión en la sección URL de inicio de sesión:

    Screenshot shows how to paste the Sign on URL.

    Nota:

    Encontrará la URL de inicio de sesión único con un solo clic (es decir, la de inicio de sesión) cuando complete la configuración del inicio de sesión único de Contentstack. Screenshot shows how to enable the access page.

  8. La aplicación Contentstack 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.

    Screenshot shows the image of attributes configuration.

  9. Además de lo anterior, la aplicación Contentstack espera que se devuelvan algunos atributos más en la respuesta de SAML, que se muestran a continuación. Estos atributos también se rellenan previamente, pero puede revisarlos según sus requisitos. Este paso es opcional.

    Nombre Atributo de origen
    roles. user.assignedroles

    Nota:

    Haga clic aquí para saber cómo configurar el rol en Microsoft Entra ID.

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

    Screenshot shows the Certificate download link.

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

    Screenshot shows to copy configuration URLs.

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

  1. Inicie sesión en el sitio de la compañía de Contentstack como administrador.

  2. Vaya a la página Configuración de organización y haga clic en la pestaña Inicio de sesión único del menú izquierdo.

  3. En la página de inicio de sesión único, vaya a la sección de Configuración de SSO y realice los pasos siguientes:

    1. Escriba un Nombre de SSO válido que elija y haga clic en Crear.

      Screenshot shows settings of the configuration.

      Nota:

      Por ejemplo, si el nombre de la empresa es "Acme, Inc." escriba "acme" aquí. Los usuarios de la organización usarán este nombre como una de las credenciales de inicio de sesión al iniciar sesión. El nombre de inicio de sesión único solo puede contener alfabetos (en minúsculas), números (0-9) o guiones (-).

    2. Al hacer clic en Crear, se generará la URL del Servicio de consumidor de aserciones o la de ACS, y otros detalles, como Id. de entidad, Atributos y Formato de NameID, y haga clic en Siguiente.

      Screenshot shows the configuration values.

  4. Vaya a la pestaña Configuración de Idp y realice los pasos siguientes:

    Screenshot shows the login values from Identity.

    1. En el cuadro de texto Dirección URL de inicio de sesión único, pegue la URL de inicio de sesión que ha copiado del Centro de administración Microsoft Entra.

    2. Abra el certificado (Base64) descargado desde el Centro de administración Microsoft Entra y cárguelo en el campo Certificado.

    3. Haga clic en Next.

  5. A continuación, debe crear la asignación de roles en Contentstack.

    Nota:

    Solo podrá ver y realizar este paso si Asignación de roles IdP forma parte del plan de Contentstack.

  6. En la sección Administración de usuarios de la página Configuración de SSO de Contentstack, verá Modo estricto (autorizar el acceso a los usuarios de la organización solo a través del inicio de sesión único) y Tiempo de espera de sesión (definir la duración de la sesión para un usuario que ha iniciado sesión mediante SSO). Debajo de estas opciones, también verá la opción Configuración avanzada.

    Screenshot shows User Management section.

  7. Haga clic en Configuración avanzada para expandir la sección Asignación de roles de IdP y asignar roles de IdP a Contentstack. Este paso es opcional.

  8. En la sección Agregar asignación de roles, haga clic en el vínculo + AGREGAR ASIGNACIÓN DE ROLES para agregar los detalles de asignación de un rol de IdP, que incluye los detalles siguientes:

    Screenshot shows how to add the mapping details.

    1. En Identificador de rol de IdP, escriba el identificador de rol o grupo de IdP (por ejemplo, "desarrolladores"); puede usar el valor del manifiesto.

    2. En Roles de la organización, seleccione el rol Administrador o Miembro para el grupo o rol asignado.

    3. Para los Permisos de nivel de pila (opcional) asigne pilas y los roles de nivel de pila correspondientes a este rol. Del mismo modo, puede agregar más asignaciones de roles para la organización de Contentstack. Para agregar una nueva asignación de roles, haga clic en + AGREGAR ASIGNACIÓN DE ROLES y escriba los detalles.

    4. Mantenga Delimitador de roles en blanco, ya que Microsoft Entra ID normalmente devuelve los roles en una matriz.

    5. Por último, active la casilla Habilitar asignación de roles de IdP para habilitar la característica y haga clic en Siguiente.

    Nota:

    Para más información, consulte Guía de SSO de Contentstack.

  9. Antes de habilitar el inicio de sesión único, se recomienda probar los valores de SSO configurados hasta ahora. Para ello, lleve a cabo los siguientes pasos:

    1. Haga clic en el botón Probar SSO para acceder a la página Iniciar sesión mediante SSO de Contentstack, donde debe especificar el nombre de SSO de la organización.
    2. Después, haga clic en Continuar para ir a la página de inicio de sesión de IdP.
    3. Inicie sesión en la cuenta y, si puede iniciar sesión en la IdP, la prueba es correcta.
    4. Si la conexión se realiza correctamente, verá un mensaje de operación correcta como el siguiente.

    Screenshot shows the successful test connection.

  10. Una vez que haya probado la configuración de SSO, haga clic en Habilitar SSO a fin de habilitar el inicio de sesión único para la organización de Contentstack.

    Screenshot shows the enable testing section.

  11. Una vez habilitado, los usuarios pueden acceder a la organización a través del SSO. Si es necesario, también puede deshabilitar el SSO de esta página.

    Screenshot shows disabling the access page.

Creación de un usuario de prueba de Contentstack

En esta sección, se crea un usuario llamado Britta Simon en Contentstack. Contentstack admite el aprovisionamiento de usuarios Just-In-Time, habilitado de forma predeterminada. No hay ningún elemento de acción para usted en esta sección. Si el usuario no existe aún en Contentstack, se crea uno tras 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.

Iniciado por SP:

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

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

Iniciado por IDP:

  • Haga clic en Probar esta aplicación en el Centro de administración de Microsoft Entra y debería iniciar sesión automáticamente en la instancia de Contentstack 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 Contentstack en 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. Si, en cambio, se ha configurado en modo IDP, debería iniciar sesión automáticamente en la instancia de Contentstack 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.

Pasos siguientes

Una vez configurado Contentstack, puede aplicar el control de sesión, lo 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.