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:
- Criar um provedor de segurança do App Builder para AD FS
- 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:
- Navegue até o IDE
- Selecione o botão Security Providers
- Clique no botão + Security Provider
-
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
- Name:
-
Clique no botão Save
- No painel Properties, clique em + Property
-
Forneça o seguinte:
- Parameter: MetadataEndpoint
-
Value:
Federation Metadata Document URL(veja acima).\Exemplo:
https://fs.example.com/FederationMetadata/2007-06/FederationMetadata.xml
-
Clique no ícone Save (Check)
- No painel Properties, clique em + Property
-
Forneça o seguinte:
- Parameter: Audience
-
Value:
Audience URI(veja acima).Exemplo:
https://example.com/Vinyl/
-
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:
- No painel Claim, clique em + Claim
-
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
-
-
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
Imprimir configurações de confiança de terceira parte confiável do AD FS
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"):
O artigo a seguir descreve como usar expressões regulares em regras de transformação de declarações:
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.