Compartir por

Tutorial: integración de Microsoft Entra con Heroku

  • Artigo

En este tutorial, obtendrá información sobre cómo integrar Heroku con Microsoft Entra ID. Al integrar Heroku con Microsoft Entra ID, puede:

  • Controlar en Microsoft Entra ID quién tiene acceso a Heroku.
  • Permitir que los usuarios puedan iniciar sesión automáticamente en Heroku 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 (SSO) en Heroku

Descripción del escenario

En este tutorial se configura y prueba el inicio de sesión único de Microsoft Entra en un entorno de prueba.

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

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

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

Para configurar y probar el inicio de sesión único de Microsoft Entra con Heroku, complete los siguientes pasos:

  1. Configuración del inicio de sesión único de Microsoft Entra, para que los usuarios puedan utilizar 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 Heroku , para configurar los valores de inicio de sesión único en la aplicación.
    1. Creación de un usuario de prueba en Heroku, para tener un homólogo de B.Simon en Heroku 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 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>Heroku>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, siga estos pasos:

    a. En el cuadro de texto URL de inicio de sesión, escriba una dirección URL con el siguiente patrón: https://sso.heroku.com/saml/<company-name>/init

    b. En el cuadro de texto Identificador (id. de entidad) , escriba una dirección URL con el siguiente patrón: https://sso.heroku.com/saml/<company-name>

    Nota:

    Estos valores no son reales. Debe actualizarlos con la dirección URL y el identificador reales de inicio de sesión. Estos valores se obtienen del equipo de soporte de Heroku, lo que se describe en secciones posteriores de este artículo.

  6. 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 Descargar para descargar el XML de metadatos de federación de las opciones proporcionadas según sus requisitos y guárdelo en el equipo.

    The Certificate download link

  7. En la sección Set up Heroku (Configurar Heroku), copie las direcciones URL adecuadas según sus necesidades.

    Copy configuration URLs

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 que utilice el inicio de sesión único concediendo acceso a Heroku.

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

  1. En otra ventana del explorador web, inicie sesión en el inquilino de Heroku como administrador.

  2. Haga clic en la pestaña Configuración .

  3. En la página de inicio de sesión único, haga clic en Cargar metadatos.

  4. Cargue el archivo de metadatos que ha descargado.

  5. Cuando la instalación se realice correctamente, los administradores ven un cuadro de diálogo de confirmación y se muestra la dirección URL de inicio de sesión único para los usuarios finales.

  6. Copie los valores de Heroku Login URL (Dirección URL de inicio de sesión de Heroku) y Heroku Entity ID (Id. de entidad de Heroku), vuelva a la sección Configuración básica de SAML de Azure Portal y pegue estos valores en los cuadros de texto URL de inicio de sesión e Identificador (id. de entidad) , respectivamente.

    Configure Single Sign-On

  7. Haga clic en Next.

Creación de un usuario de prueba en Heroku

En esta sección se crea un usuario llamado B.Simon en Heroku. Heroku admite el aprovisionamiento de usuarios Just-In-Time, que está 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 Heroku, se creará uno nuevo después de 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.

  • Haga clic en Probar esta aplicación; esto redirigirá a la dirección URL de Heroku de inicio de sesión donde se puede poner en marcha el flujo de inicio de sesión.

  • Vaya directamente a la dirección URL de inicio de sesión de Heroku e inicie el flujo de inicio de sesión desde allí.

  • Puede usar Mis aplicaciones de Microsoft. Al hacer clic en el icono de Heroku en Mis aplicaciones, se le redirigirá a la dirección URL de inicio de sesión de dicha aplicación. 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 Heroku, puede aplicar el control de sesión, que protege a 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.