Compartir por

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

  • Artigo

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

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

Requisitos previos

Para integrar Microsoft Entra ID con FTAPI, 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 FTAPI.

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.

  • FTAPI admite el inicio de sesión único iniciado porSP.
  • FTAPI admite aprovisionamiento de usuarios Just-In-Time.

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

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

Para configurar y probar el inicio de sesión único de Microsoft Entra con FTAPI, 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 ID para probar el inicio de sesión único de Microsoft Entra con B.Simon.
    2. Asigne el usuario de prueba de Microsoft Entra ID 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 FTAPI: para configurar los valores de inicio de sesión único en la aplicación.
    1. Crear un usuario de prueba de FTAPI: para tener un homólogo de B.Simon en FTAPI que esté vinculado a la representación del usuario en Microsoft Entra ID.
  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 Administrador de aplicaciones en la nube.

  2. Vaya a Identidad>Aplicaciones>Aplicaciones empresariales>FTAPI>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.

    Screenshot shows how to edit Basic SAML Configuration.

  5. En la sección Configuración básica de SAML, siga estos pasos:

    a. En el cuadro de texto Identificador (id. de entidad) , escriba una dirección URL con el siguiente patrón: https://<ENVIRONMENT>.<DOMAIN>.<EXTENSION>

    b. En el cuadro de texto URL de respuesta, escriba una dirección URL con el siguiente patrón: https://<ENVIRONMENT>.<DOMAIN>.<EXTENSION>

    c. En el cuadro de texto URL de inicio de sesión, escriba una dirección URL con el siguiente patrón: https://<ENVIRONMENT>.<DOMAIN>.<EXTENSION>

    Nota:

    Estos valores no son reales. Actualice estos valores con el identificador y las direcciones URL de inicio de sesión y de respuesta reales. Póngase en contacto con equipo de soporte técnico de FTAPI para obtener estos valores. También puede consultar los patrones que se muestran en la sección Configuración básica de SAML del centro de administración de Microsoft Entra.

  6. La aplicación FTAPI espera las aserciones de SAML en un formato específico, lo 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

  7. Además de lo anterior, la aplicación FTAPI 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
    phonenumber user.telephonenumber
    companyname user.companyname
    rol user.assignedroles

    Nota:

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

  8. En la página Configurar el inicio de sesión único con SAML, en la sección Certificado de firma de SAML, busque XML de metadatos de federación y seleccione Descargar para descargar el certificado y guardarlo en su equipo.

    Screenshot shows the Certificate download link.

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

    Screenshot shows to copy configuration URLs.

Creación de un usuario de prueba de Microsoft Entra ID

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 ID

En esta sección, va a permitir que B.Simon acceda a FTAPI 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>FTAPI.
  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 FTAPI

Para configurar el inicio de sesión único en FTAPI, debe enviar el XML de metadatos de federacióndescargado y las direcciones URL adecuadas y copiadas desde el centro de administración de Microsoft Entra al equipo de soporte técnico de FTAPI. Dicho equipo lo configura para establecer la conexión de SSO de SAML correctamente en ambos lados.

Creación de un usuario de prueba de FTAPI

En esta sección, se crea un usuario llamado Britta Simon en FTAPI. FTAPI 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 un usuario aún no existe en FTAPI, se crea uno 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 en el centro de administración de Microsoft Entra. Esta acción le redirigirá a la dirección URL de inicio de sesión de FTAPI, donde puede iniciar el flujo de inicio de sesión.

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

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