Configurar Microsoft Entra ID usando WS-Federation en Jitterbit App Builder

App Builder se integra con Microsoft Entra ID mediante el protocolo WS-Federation, lo que habilita el inicio de sesión único. Cada instancia de App Builder debe configurarse individualmente para funcionar con Microsoft Entra ID y viceversa. Para lograr esto, asegúrate de cumplir con los requisitos y luego sigue las instrucciones de esta página, que se dividen en tres pasos generales:

• Paso 1: Registrar App Builder como una aplicación de Microsoft Entra ID

• Paso 2: Configurar Microsoft Entra ID como proveedor de seguridad de App Builder

• Paso 3: Asignar usuarios y grupos de App Builder a identidades de Azure

Requisitos

Para configurar Microsoft Entra ID con WS-Federation en App Builder, debes cumplir con los siguientes requisitos:

• Debes tener acceso de administrador a una cuenta de Azure con un servicio de Microsoft Entra ID.

• Debes tener acceso de administrador a App Builder.

• App Builder debe estar disponible a través de HTTPS con un certificado TLS válido.

Terminología

La tabla siguiente define algunos de los términos utilizados en esta página.

Paso 1: Registrar App Builder como una aplicación de Microsoft Entra ID

La instancia de App Builder debe registrarse como una aplicación de Microsoft Entra ID. La documentación de Microsoft ofrece un tutorial detallado del proceso. A continuación, se puede ver un resumen de los pasos:

1. Inicia sesión en el Portal de Microsoft Azure.

2. Ve al centro de administración de Azure Active Directory.

3. Haz clic en Azure Active Directory desde la navegación.

4. Haz clic en App Registrations.

5. Crea un New Registration y proporciona el Name como App Builder.

6. Ingresa tu Redirect URI como https://<your-domain>/signin-<Provider-Name>, reemplazando <your-domain> con tu dominio real y <Provider-Name> con el nombre que usarás dentro de los proveedores de seguridad de App Builder.

   

7. Haz clic en Register.

8. Abre la aplicación que acabas de registrar, y en la barra lateral Manage, selecciona Manifest:

   1. Anota la cadena appId, con formato GUID (por ejemplo, 012a3b4c-d567-89ef-g012-3hi456jklm7n).

   2. Anota tu dominio principal, que aparece en la Tenant information de Microsoft Entra ID.

   3. Edita las siguientes líneas de la siguiente manera:

      En lugar de:

      "groupMembershipClaims": null,
          "identifierUris": [],
      

      Cámbialo a:

      "groupMembershipClaims": "SecurityGroup",
          "identifierUris": [
              "https://<your-primary-domain>/<app-id>"
          ],
      

      Ejemplo: Si el dominio principal del inquilino de Azure es zudy.com:

      

9. Haz clic en Save.

10. Haz clic en Overview en la navegación.

11. Haz clic en la pestaña Endpoints.

12. Donde se lee Federation metadata document, haz clic en el icono Copy to clipboard y pégalo en un archivo de texto temporal para usarlo en pasos posteriores.

Paso 2: Conecta y configura el nuevo proveedor de seguridad en App Builder

En este paso, definirás el nuevo proveedor de seguridad para Microsoft Entra ID. Esto incluye configurar el Entity ID (que actúa como Audience o Wtrealm) usando valores proporcionados por Microsoft.

1. Selecciona IDE > Security Providers.

2. Haz clic en + Security Provider. Se abre la página Provider.

3. Configura las opciones de la siguiente manera:

   • Settings:

     • Name: Ingresa un nombre que coincida con lo que usaste para configurar el Redirect URI. Por ejemplo: Azure.

     • Type: Elige WS-Federation.

     • Enabled: Marca esta casilla.

   • Tokens:

     • Entity ID: Esto es lo que Microsoft denomina App ID URI o Wtrealm. Ingresa el URI que contiene tu dominio principal de Azure y el ID de aplicación anotado en el Paso 1, siguiendo este formato: https://<your-primary-domain>/<app-id>. (Nota: El campo Audience se establecerá automáticamente para que coincida con el Entity ID).

   • Provisioning:

     • User Provisioning: Marca esta casilla. Esto permitirá que Azure cree usuarios en App Builder.

     • Supplies Group Membership: Marca esta casilla.

4. Haz clic en Save. Una vez que guardes, App Builder emitirá un valor Identifier único para este proveedor.

Después de crear el proveedor, también debes configurar algunos otros parámetros que representen valores proporcionados por Microsoft Azure. Para hacerlo, sigue estos pasos:

1. Encuentra tu proveedor de seguridad en IDE > Security Providers y haz doble clic en su fila.

2. En el panel Endpoints, haz clic en + Endpoint. Configura las siguientes opciones:

   • Endpoint Type: Selecciona Metadata Endpoint.

   • URL: Ingresa la siguiente URL: https://login.microsoftonline.com/<your-tenant-id>/federationmetadata/2007-06/federationmetadata.xml, reemplazando <your-tenant-id> con tu ID de inquilino de Entra.

3. Haz clic en Save.

4. Luego, en el panel Claims, haz clic en + Claim. Configura lo siguiente:

   • Identifier: Selecciona: http://schemas.microsoft.com/ws/2008/06/identity/claims/groups.

   • Usage: Selecciona Group.

   • Name: Ingresa un nombre para identificar esta reclamación.

5. Haz clic en Save.

6. (Opcional) En el panel Claims, haz clic en Discover. Al seleccionar la casilla Store Claims, puedes indicarle a App Builder que registre todas las reclamaciones extraídas del token de seguridad para propósitos de solución de problemas.

Paso 3: Asigna usuarios y grupos de App Builder a identidades de Azure

Si visitas IDE > User Management y abres la pestaña Identities, verás que el panel Providers contiene una entrada para el proveedor de seguridad que has creado.

Con aprovisionamiento de usuarios

Si has habilitado el aprovisionamiento de usuarios e intentas iniciar sesión, es posible que se te redirija nuevamente a la página de inicio de sesión de App Builder con un mensaje similar a:

Aunque App Builder logró aprovisionar al usuario correctamente, debes asignar los grupos de seguridad de Microsoft Entra ID a los grupos de seguridad de App Builder para otorgar acceso:

1. Inicia sesión en App Builder como administrador.

2. Ve a IDE > Administración de usuarios.

3. Haz clic en la pestaña Identidades.

4. En el panel Proveedores, selecciona tu nuevo proveedor de seguridad de Microsoft Entra ID.

5. En el panel Grupos de proveedores, haz clic en + Grupo:

   • Nombre: Introduce el nombre de un grupo que tengas en Microsoft Entra ID.

   • Identificador: Introduce el Object Id del grupo que se encuentra en el Portal de Microsoft Entra ID.

   • Grupo: Utiliza el menú desplegable para seleccionar el grupo de App Builder al que deben unirse los usuarios.

6. Haz clic en el botón Guardar.

Sin aprovisionamiento de usuarios

Si no has habilitado el aprovisionamiento de usuarios, la autenticación fallará con un mensaje similar al siguiente:

Hay dos formas de solucionar esto:

• Método 1: Permitir que App Builder haga coincidir usuarios existentes:

  1. Ve a IDE > Proveedores de seguridad.

  2. En el panel Proveedores de seguridad, localiza el proveedor de seguridad que has creado y selecciónalo.

  3. En el panel Proveedor, haz clic en Editar.

  4. En Aprovisionamiento, habilita la casilla Coincidir usuario existente.

• Método 2: Asignar manualmente un nuevo usuario:

  1. Ve a IDE > Administración de usuarios.

  2. Abre la pestaña Usuarios.

  3. En el panel Usuarios, selecciona el usuario que deseas asignar.

  4. En el panel Identidades, haz clic en el botón + Identidad. Se abrirá un cuadro de diálogo. Proporciona lo siguiente:

     • Nombre: El nombre de usuario de Azure. En el mensaje de error mostrado arriba, es la parte fuera del paréntesis.

     • Identificador: El identificador del nombre de usuario de Azure. En el mensaje de error mostrado arriba, es la parte entre paréntesis.

     • Proveedor: Utiliza el menú desplegable para seleccionar el proveedor de seguridad que has creado.

  5. Haz clic en Guardar.

Verificar el nuevo método de inicio de sesión

Cierra sesión en App Builder para verificar que la página de inicio de sesión ahora tiene un botón Iniciar sesión con ... :