Ir para o conteúdo

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

O App Builder integra-se com o Microsoft Entra ID usando o protocolo WS-Federation, permitindo logon único. Cada instância do App Builder deve ser configurada individualmente para funcionar com o Microsoft Entra ID e vice-versa. Para isso, certifique-se de atender aos requisitos e siga as instruções nesta página, que são divididas em três etapas gerais:

Requisitos

Para configurar o Microsoft Entra ID com WS-Federation para o App Builder, você deve atender aos seguintes requisitos:

  • Ter acesso de administrador a uma conta do Azure com um serviço Microsoft Entra ID.

  • Ter acesso de administrador ao App Builder.

  • O App Builder deve estar disponível via HTTPS com um certificado TLS válido.

Terminologia

A tabela abaixo define alguns dos termos usados nesta página.

Exemplo Notas
URL do App Builder https://example.com/Vinyl/ O App Builder deve estar acessível via HTTPS. A URL deve incluir a barra final. O caminho diferencia maiúsculas de minúsculas.
Nome do Provedor Azure Normalmente, o nome do provedor deve corresponder ao nome do domínio do Active Directory. Como o nome do provedor será exibido na URL de Logon (veja abaixo), evite espaços, pontuação e caracteres especiais.
URL de Logon Diretório raiz do App Builder/signin-<Provider-Name>

https://example.com/Vinyl/signin-Azure
URL de retorno automaticamente provisionada ao criar o provedor de segurança Microsoft Entra ID dentro do App Builder.

O exemplo fornecido aqui assume que: example.com é o nome do host, https://example.com/Vinyl/ é o diretório raiz da aplicação App Builder e que Azure é o nome do Provedor de Segurança do Azure.

Etapa 1: Registrar o App Builder como uma aplicação Microsoft Entra ID

A instância do App Builder deve ser registrada como uma aplicação Microsoft Entra ID. A documentação da Microsoft oferece um tutorial detalhado do processo. Uma visão geral das etapas pode ser vista abaixo:

  1. Faça login no Portal do Microsoft Azure.

  2. Navegue até o centro de administração do Azure Active Directory.

  3. Clique em Azure Active Directory na navegação.

  4. Clique em App Registrations.

  5. Crie um New Registration e forneça o Name como App Builder.

  6. Digite seu Redirect URI como https://<your-domain>/signin-<Provider-Name>, substituindo <your-domain> pelo seu domínio real e <Provider-Name> pelo nome que você usará nos provedores de segurança do App Builder.

    activedirectoryredirect.png

  7. Clique em Register.

  8. Abra a aplicação recém-criada que você registrou e, na barra lateral Manage, selecione Manifest:

    1. Anote a string appId, formatada como um GUID (por exemplo, 012a3b4c-d567-89ef-g012-3hi456jklm7n).

    2. Anote seu domínio primário, exibido nas Tenant information do seu Microsoft Entra ID.

    3. Edite as seguintes linhas conforme indicado:

      Em vez de:

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

      Altere para:

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

      Exemplo: se o domínio primário do Azure Tenant for zudy.com:

      admanifest.png

  9. Clique em Save.

  10. Clique em Overview na navegação.

  11. Clique na aba Endpoints.

  12. Onde consta Federation metadata document, clique no ícone Copy to clipboard e cole o conteúdo em um arquivo de texto temporário para usar em etapas posteriores.

Etapa 2: Conectar e configurar novo provedor de segurança no App Builder

Nesta etapa, você definirá o novo provedor de segurança para o Microsoft Entra ID. Isso inclui configurar o Entity ID (que funciona como Audience ou Wtrealm) usando valores fornecidos pela Microsoft.

  1. Selecione IDE > Security Providers.

  2. Clique em + Security Provider. A página Provider abre.

  3. Configure as opções da seguinte forma:

    • Settings:

      • Name: Digite um nome que corresponda ao que você usou para configurar o Redirect URI. Por exemplo: Azure.

      • Type: Escolha WS-Federation.

      • Enabled: Marque esta caixa de seleção.

    • Tokens:

      • Entity ID: É o que a Microsoft chama de App ID URI ou Wtrealm. Digite a URI contendo seu domínio primário do Azure e o ID do app anotado na Etapa 1, seguindo este formato: https://<your-primary-domain>/<app-id>. (Nota: o campo Audience será automaticamente definido para corresponder ao Entity ID).
    • Provisioning:

      • User Provisioning: Marque esta caixa de seleção. Isso permitirá que o Azure crie usuários no App Builder.

      • Supplies Group Membership: Marque esta caixa de seleção.

  4. Clique em Save. Depois de salvar, o App Builder emitirá um valor Identifier único para este provedor.

Após a criação do provedor, você também deve configurar alguns outros parâmetros que representam valores fornecidos pelo Microsoft Azure. Para fazer isso, siga estas etapas:

  1. Encontre seu provedor de segurança em IDE > Security Providers e clique duas vezes em sua linha.

  2. No painel Endpoints, clique em + Endpoint. Configure as seguintes opções:

    • Endpoint Type: Selecione Metadata Endpoint.

    • URL: Digite a seguinte URL: https://login.microsoftonline.com/<your-tenant-id>/federationmetadata/2007-06/federationmetadata.xml, substituindo <your-tenant-id> pelo seu ID de locatário do Entra.

  3. Clique em Save.

  4. A seguir, no painel Claims, clique em + Claim. Configure o seguinte:

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

    • Usage: Selecione Group.

    • Name: Digite um nome para identificar este claim.

  5. Clique em Save.

  6. (Opcional) No painel Claims, clique em Discover. Ao marcar a caixa de seleção Store Claims, você pode instruir o App Builder a registrar todos os claims extraídos do token de segurança para fins de solução de problemas.

Etapa 3: Mapeie usuários e grupos do App Builder para identidades do Azure

Se você acessar IDE > User Management e abrir a aba Identities, agora verá que o painel Providers contém uma entrada para o provedor de segurança que você criou.

Com provisionamento de usuários

Se você habilitou o provisionamento de usuários e tenta fazer login, pode ser redirecionado de volta à página de login do App Builder com uma mensagem similar a:

Texto de erro

The user account (bob@example.com) has not been granted access to an application.

Embora o App Builder tenha provisionado o usuário com sucesso, é necessário mapear os grupos de segurança do Microsoft Entra ID para os grupos de segurança do App Builder para conceder acesso:

  1. Faça login no App Builder como administrador.

  2. Acesse IDE > User Management.

  3. Clique na aba Identities.

  4. No painel Providers, selecione seu novo provedor de segurança do Microsoft Entra ID.

  5. No painel Provider Groups, clique em + Group:

    • Name: Digite o nome de um grupo que você possui no Microsoft Entra ID.

    • Identifier: Digite o Object Id do grupo encontrado no Portal do Microsoft Entra ID.

    • Group: Use o menu suspenso para selecionar o grupo do App Builder ao qual os usuários devem se juntar.

  6. Clique no botão Save.

Sem provisionamento de usuários

Se você não habilitou o provisionamento de usuários, a autenticação falhará com uma mensagem similar a:

Texto de erro

Although you've successfully authenticated with Azure, the account bob@example.com (bob@example.com) is not associated with a local account.

Existem duas formas de resolver isso:

  • Método 1: Permitir que o App Builder corresponda usuários existentes:

    1. Acesse IDE > Security Providers.

    2. No painel Security Providers, localize o provedor de segurança que você criou e selecione-o.

    3. No painel Provider, clique em Edit.

    4. Em Provisioning, habilite a caixa de seleção Match Existing User.

  • Método 2: Mapear manualmente um novo usuário:

    1. Acesse IDE > User Management.

    2. Abra a aba Users.

    3. No painel Users, selecione o usuário que deseja mapear.

    4. No painel Identities, clique no botão + Identity. Um diálogo será aberto. Forneça as seguintes informações:

      • Name: O nome do usuário do Azure. Na mensagem de erro mostrada acima, é a parte fora dos parênteses.

      • Identifier: O identificador do nome do usuário do Azure. Na mensagem de erro mostrada acima, é a parte entre parênteses.

      • Provider: Use o menu suspenso para selecionar o provedor de segurança que você criou.

    5. Clique em Save.

Verificar o novo método de login

Faça logout do App Builder para verificar que a página de login agora possui um botão Sign in with ...:

Sign in with security provider