Ir para o conteúdo

Configurando Active Directory Federation Services usando SAML single sign on no Jitterbit App Builder

O App Builder pode se integrar com Active Directory Federation Services (AD FS) usando o protocolo SAML Single Sign-On (SSO). O protocolo SAML SSO define os seguintes papéis operacionais:

Ator Papel
App Builder Service Provider (SP)
AD FS Identity Provider (IdP) / Security Token Service (STS)
Usuário Browser

A configuração envolve os seguintes procedimentos:

  1. Criar um provedor de segurança do App Builder para AD FS
  2. Criar uma Relying Party Trust do AD FS para o App Builder

Requisitos

Para prosseguir, é necessário ter:

  • Acesso de administrador ao AD FS.
  • Acesso de administrador ao App Builder.
  • O App Builder precisará se conectar ao AD FS via HTTPS para recuperar o documento de metadados. O AD FS deve usar um certificado TLS com uma raiz confiável: o App Builder não conseguirá recuperar o documento de metadados se o certificado não for confiável ou inválido.
  • O App Builder precisará estar disponível via HTTPS. O provedor de segurança Require HTTPS deve estar habilitado (ou outras medidas devem ser tomadas para garantir que o App Builder seja acessível apenas via HTTPS).
  • Os computadores cliente precisarão estar configurados para confiar no AD FS. Caso contrário, o AD FS solicitará que o usuário faça login.

As instruções abaixo farão referência às seguintes propriedades:

Exemplo Observações
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 ADFS Cada provedor de segurança do App Builder recebe um nome lógico. Como o nome do provedor aparecerá na URL do Assertion Consumer Service (veja abaixo), evite espaços, pontuação e caracteres especiais.
URL do Assertion Consumer Service https://example.com/Vinyl/signin-Okta O App Builder provisiona automaticamente um endpoint do Assertion Consumer Service (ACS) para provedores de segurança SAML Single Sign-On (SSO). O AD FS se refere à URL do ACS como a "URL do serviço SSO SAML 2.0 da Relying party". Observe que o Nome do Provedor aparece na URL.
URI de Público https://example.com/Vinyl/ Embora a URI de público seja arbitrária, o AD FS e o App Builder devem usar o mesmo valor. Considere usar a URL do App Builder.
URL do Documento de Metadados de Federação https://fs.example.com/FederationMetadata/2007-06/FederationMetadata.xml A URL do Documento de Metadados de Federação pode ser recuperada do AD FS. Para isso, abra o console de Gerenciamento do AD FS. Selecione AD FS → Service → Endpoints. Localize o endpoint do tipo Federation Metadata.

Criar um provedor de segurança do App Builder para AD FS

Para criar o provedor de segurança, comece fazendo login no App Builder como administrador:

  1. Navegue até o IDE
  2. Selecione o botão Security Providers
  3. Clique no botão + Security Provider
  4. Forneça o seguinte:

    • Name: Security Provider Name (veja acima) Exemplo: ADFS
    • Type: SAML
    • Enabled: Marque
    • User Provisioning: Marque para habilitar o provisionamento de usuário Just-in-Time (JIT)
    • Supplies Group Membership: Marque se o AD FS foi configurado para passar a associação de grupo do usuário
    • Show On Login Form: Marque
  5. Clique no botão Save

  6. No painel Properties, clique em + Property
  7. Forneça o seguinte:

    • Parameter: MetadataEndpoint
    • Value: Federation Metadata Document URL (veja acima).\

      Exemplo: https://fs.example.com/FederationMetadata/2007-06/FederationMetadata.xml

  8. Clique no ícone Save (Check)

  9. No painel Properties, clique em + Property
  10. Forneça o seguinte:

    • Parameter: Audience
    • Value: Audience URI (veja acima).

      Exemplo: https://example.com/Vinyl/

  11. Clique no ícone Save (Check)

Além disso, qualquer declaração mapeada no AD FS precisará ser mapeada no App Builder. Por exemplo, para mapear a declaração de email:

  1. No painel Claim, clique em + Claim
  2. Forneça o seguinte:

    • Identifier: Nome do tipo de declaração.

      Exemplo: http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress

    • Usage: Uso do tipo de declaração.

      Exemplo: Email Address

  3. Clique no ícone Save (Check)

Criar uma confiança de terceira parte confiável do AD FS para o App Builder

Cada instância do App Builder deve ser registrada no AD FS como uma confiança de terceira parte confiável. Os detalhes completos de criação, configuração e manutenção de confianças de terceira parte confiável estão fora do escopo deste documento. Para obter informações adicionais sobre como criar uma confiança de terceira parte confiável do AD FS, consulte o seguinte artigo do TechNet:

https://technet.microsoft.com/en-ca/library/dd807108.aspx

A criação de uma confiança de terceira parte confiável requer as seguintes informações:

  • Relying party SAML 2.0 SSO service URL: Corresponde à Assertion Consumer Service URL.

    Exemplo: https://example.com/Vinyl/signin-ADFS

  • Relying party trust identifier: Corresponde à propriedade Audience URI.

    Exemplo: https://example.com/Vinyl/

Você também pode fornecer mapeamentos de declarações opcionais. O seguinte artigo do TechNet descreve como criar regras de declaração de confiança de terceira parte confiável do AD FS:

https://technet.microsoft.com/en-us/library/dd807115.aspx

As declarações comumente mapeadas incluem:

  • Email Address - http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress
  • Group Membership - http://schemas.xmlsoap.org/claims/Group

Consulte Claims para obter informações adicionais sobre declarações.

Solução de problemas

Execute o seguinte comando do PowerShell no servidor do AD FS para imprimir as configurações de confiança de terceira parte confiável:

> Get-ADFSRelyingPartyTrust -Identifier https://example.com/Vinyl/signin-ADFS

O argumento Identifier corresponde à Assertion Consumer Service URL (conforme descrito acima).

Associação de grupo ausente

Por padrão, o ADFS não inclui declarações de grupo em asserções SAML. Os administradores devem criar uma ou mais regras de declaração para incluir a associação ao grupo. É possível criar uma única regra de declaração que inclua toda a associação ao grupo. No entanto, ao usar a regra "Group Claim" integrada do ADFS, é necessária uma regra separada para cada grupo.

O seguinte artigo descreve como incluir associação ao grupo correspondente a uma expressão regular (por exemplo, grupos começando com "App Builder"):

http://social.technet.microsoft.com/wiki/contents/articles/8008.ad-fs-2-0-selectively-send-group-membership-s-as-a-claim.aspx

O artigo a seguir descreve como usar expressões regulares em regras de transformação de declarações:

http://social.technet.microsoft.com/wiki/contents/articles/16161.ad-fs-2-0-using-regex-in-the-claims-rule-language.aspx

Erro "The AudienceRestrictionCondition was not valid because the specified Audience is not present in AudienceUris."

Este erro indica que o URI do público não corresponde. Certifique-se de que a propriedade Audience foi definida explicitamente. Se não for definida, será padronizada para a URL atual, que pode variar por usuário. O valor diferencia maiúsculas de minúsculas.