Provedor de segurança SAML no Jitterbit App Builder
A autenticação SAML Single Sign-On (SSO) é definida nos seguintes documentos:
- Assertions and Protocols for the OASIS Security Assertion Markup Language (SAML) V2.0
- SAML Version 2.0 Errata 05
Em um cenário de SSO, há três funções:
- Principal - O usuário que acessa um serviço restrito.
- Provedor de Serviços (SP) - Fornece acesso a serviços restritos.
- Provedor de Identidade (IdP) - Autentica usuários.
O App Builder pode ser configurado como SP ou IdP usando o provedor de segurança apropriado. Este documento aborda o provedor de segurança SAML, usado para a função de SP. Nessa função, o App Builder delega a autenticação a um IdP de terceiros. Os IdPs compatíveis incluem:
Para a função de IdP, consulte Provedor de identidade SAML.
Fluxos
A especificação SAML Single Sign-On (SSO) define vários fluxos. O provedor de segurança SAML oferece suporte aos seguintes fluxos SAML SSO:
- Iniciado por Provedor de Serviços (SP)
- Iniciado por Provedor de Identidade (IdP)
Provedor de serviços (SP) iniciado
No fluxo iniciado por Provedor de Serviços (SP), um usuário navega para o App Builder e tenta acessar uma página restrita. O App Builder redireciona o usuário para o Provedor de Identidade (IdP) via vinculação SAML Redirect (HTTP GET). Após a autenticação, o IdP redireciona o usuário de volta ao App Builder usando a vinculação SAML Post (HTTP POST). O App Builder valida a Resposta SAML, mapeia o identificador de nome para uma conta de usuário local do App Builder e concede os direitos associados à conta de usuário.
Observe que, antes de redirecionar o usuário para o IdP, o App Builder registra a URL da página que o usuário tentou acessar. Após a autenticação, o App Builder redireciona o usuário para a página originalmente solicitada. Isso permite vinculação profunda.
Provedor de identidade (IdP) iniciado
No fluxo do Provedor de Identidade (IdP), um usuário navega diretamente para o IdP. Após a autenticação, o usuário é redirecionado para o App Builder via vinculação SAML Post (HTTP POST). Como no fluxo iniciado por SP, o App Builder valida a Resposta SAML, mapeia o identificador de nome para uma conta de usuário local do App Builder e concede os direitos associados à conta de usuário.
Normalmente, o App Builder redireciona o usuário para sua página inicial após o login bem-sucedido. No entanto, o IdP pode realizar uma vinculação profunda passando a URI no parâmetro SAML Response RelayState. Consulte o parâmetro AllowRelayStateRedirects abaixo.
Configuração
Tokens
- Issuer: O emissor da asserção SAML. Assume como padrão o público-alvo.
- Audience: Restrição de público-alvo da asserção SAML. O valor deve ser uma URI sintaticamente válida.
- Recipient: O destinatário da asserção SAML. Este valor deve ser uma URI sintaticamente válida. Assume como padrão a URI do Serviço de Consumidor de Asserção (por exemplo, https://example.com/Vinyl/signin-SAML).
Cuidado
Por motivos legados, Audience assume como padrão a URL raiz da aplicação (por exemplo, https://example.com/Vinyl/). É altamente recomendável que você defina explicitamente Audience em vez de contar com o padrão.
Endpoints
| Tipo | Descrição |
|---|---|
| Metadata Endpoint | Endpoint de metadados do serviço SAML Single Sign-On (SSO). Este parâmetro é necessário se os parâmetros Request Redirect Endpoint ou SigningCertificate não forem definidos. |
| RelayState URI | URI de redirecionamento RelayState permitida para uma solicitação iniciada por um Provedor de Identidade (IdP) SAML. Consulte o parâmetro AllowRelayStateRedirects para obter informações adicionais. |
| Request Redirect Endpoint | Endpoint de solicitação de autenticação SAML Single Sign-On (SSO) para a vinculação Redirect. Este parâmetro é necessário se o Metadata Endpoint não for definido. |
Certificados
| Finalidade | Tipo | Formato | Descrição |
|---|---|---|---|
| Validação de Assinatura | Certificado X.509 |
|
Certificado X.509 usado para validar assinaturas de resposta SAML Single Sign-On (SSO). O certificado de validação de assinatura é obrigatório se o Endpoint de Metadados não estiver definido. |
Propriedades
O provedor de segurança SAML define os seguintes parâmetros adicionais:
| Parâmetro | Padrão | Descrição |
|---|---|---|
| AllowRelayStateRedirects | False |
Indica se um sign-on iniciado por um Provedor de Identidade (IdP) SAML pode incluir um URI de redirecionamento no parâmetro RelayState. O URI de redirecionamento é o local para o qual o usuário será redirecionado após fazer login. Por padrão, o parâmetro RelayState pode não conter um URI de redirecionamento. Defina como True para permitir URIs de redirecionamento no parâmetro RelayState. Para proteger contra ataques de retransmissão aberta, o URI deve corresponder ao endpoint RelayState URI. |
| IgnoreTlsErrors | False |
Indica se App Builder deve ignorar erros de certificado HTTPS ao fazer solicitações de back-channel para recuperar os metadados do serviço. Esta configuração é apenas para fins de configuração e teste. Não habilite esta configuração em um sistema em produção. |
| SignatureRequirement | AssertionOrResponse |
Indica se a resposta, asserção ou ambas do SAML devem ser assinadas. As opções incluem: - AssertionOrResponse - A asserção ou resposta deve ser assinada. - Assertion - A asserção deve ser assinada. - Response - Apenas a resposta deve ser assinada. A asserção herda a assinatura da resposta. - AssertionAndResponse - Tanto a asserção quanto a resposta devem ser assinadas. |
| LogPII | False |
Indica que informações de identificação pessoal (PII) devem ser registradas. Esta configuração entra em vigor na inicialização. |
Declarações
As asserções SAML contêm atributos. Atributos são pares chave/valor com múltiplos valores. App Builder trata os atributos de asserção SAML como declarações. O nome do atributo mapeia para um identificador de declaração.
Por exemplo, considerando uma asserção SAML com o seguinte atributo:
<Attribute AttributeName="http://schemas.xmlsoap.org/ws/2005/05/identity/claims/name">
<AttributeValue>Arthur.Dent</AttributeValue>
</Attribute>
Mapeando o identificador http://schemas.xmlsoap.org/ws/2005/05/identity/claims/name para a propriedade Name definirá o nome de usuário como "Arthur.Dent" quando a conta de usuário for provisionada.
A tabela a seguir descreve os mapeamentos de declarações padrão:
| Identificador | Finalidade | Descrição |
|---|---|---|
| http://schemas.xmlsoap.org/ws/2005/05/identity/claims/nameidentifier | Identificador de Nome | Identificador único e imutável usado para mapear a identidade de terceiros para um usuário App Builder. |
| http://schemas.xmlsoap.org/ws/2005/05/identity/claims/name | Nome | Nome de usuário. |
| http://schemas.xmlsoap.org/claims/Group | Grupo | Associação a grupos de segurança. |
| http://schemas.zudy.com/identity/claims/fullname | Nome Completo | Nome completo. |
| http://schemas.zudy.com/identity/claims/displayname | Nome de Exibição | Nome amigável. |
| http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress | Endereço de Email | Endereço de email. |
| http://schemas.zudy.com/identity/claims/phonenumber | Número de Telefone | Número de telefone. |
| http://schemas.xmlsoap.org/ws/2005/05/identity/claims/thumbprint | Impressão digital do certificado X.509. | |
| http://schemas.xmlsoap.org/ws/2005/05/identity/claims/x500distinguishedname | Nome distinto do certificado X.509. | |
| http://schemas.xmlsoap.org/ws/2005/05/identity/claims/dns | Nome DNS do certificado X.509. |
Integração
Serviço consumidor de asserção
O provedor de segurança SAML expõe um único endpoint. O endpoint recebe Respostas SAML. Isso é conhecido como Serviço Consumidor de Asserção. Uma URL do Serviço Consumidor de Asserção do App Builder pode ser algo assim:
https://example.com/Vinyl/signin-SAML
A URL é composta pelas seguintes partes:
| Componente | Descrição |
|---|---|
| https://example.com/Vinyl/ | URL absoluta do diretório raiz da aplicação App Builder. |
| SAML | Esquema do provedor de segurança SAML. O valor diferencia maiúsculas de minúsculas. Caracteres especiais precisam ser codificados em URL. |
Provisionar usuários
Após configurar o provedor de segurança SAML, você deve garantir que os usuários tenham identidades correspondentes no App Builder para fazer login com êxito.
Provisionamento manual
Um administrador pode associar manualmente usuários ao provedor de segurança SAML:
-
Navegue até IDE > User Management.
-
No painel Identities, clique em + Identity para criar uma nova identidade.
-
Ao configurar a nova identidade, selecione SAML como o Provider de segurança e insira o Identifier que corresponde ao nome de usuário do IdP do usuário (normalmente o email ou NameID).
Provisionamento automático
Para processar integração em massa de usuários sem entrada manual, você pode ativar o recurso Match Existing User. Isso é útil quando você já possui uma lista de usuários no App Builder e deseja vinculá-los às suas identidades SAML automaticamente no primeiro login.
-
Navegue até IDE > Security Providers.
-
Se seu provedor de segurança SAML já existe, localize-o no painel Security Providers e clique duas vezes no ícone de expansão no final da linha. Se ainda não existe, clique em + Security Provider.
-
Na tela de configuração que se abre, localize o grupo de campos Provisioning e ative a caixa de seleção User Provisioning. Ao fazer isso, a caixa de seleção Match Existing User aparecerá. Ative-a.
Após ativar esse recurso, quando um usuário tentar fazer login via SAML, o App Builder verifica se já existe uma conta de usuário local com um nome de usuário que corresponda ao identificador de nome SAML. Se uma correspondência for encontrada, o sistema cria automaticamente o vínculo de identidade para esse usuário durante o processo de login, concedendo acesso imediatamente.
Solução de problemas
Erro "The AudienceRestrictionCondition was not valid because the specified Audience is not present in AudienceUris."
Esse erro indica que a URI do público-alvo não corresponde. Verifique se a propriedade Audience foi definida explicitamente. Se não for definida, usará como padrão a URL atual, que pode variar por usuário. O valor diferencia maiúsculas de minúsculas.
Problemas conhecidos e limitações
O provedor de segurança SAML Single Sign-On (SSO) do App Builder possui as seguintes limitações:
- Apenas uma única restrição de público-alvo pode ser validada.
- O protocolo de resolução de artefatos não é suportado.
- O protocolo de logout não é suportado.