Configurando App Builder como provedor de identidade no Jitterbit App Builder
App Builder pode funcionar tanto como um Provedor de Serviço SAML (SP) quanto como um Provedor de Identidade SAML (IdP). Isso permite que uma instância de Viny (o IdP) autentique usuários em nome de outra instância (o SP).
Há quatro tarefas principais envolvidas:
- Gerar um certificado de assinatura.
- Criar um provedor de segurança SAML IdP.
- Criar um provedor de segurança SAML SP.
- Testar
Estas instruções pressupõem o seguinte:
- Você possui pelo menos duas instâncias de App Builder.
- Você tem acesso de administrador em cada instância de App Builder.
As instruções abaixo fazem referência às seguintes propriedades:
| Exemplo | Notas | |
|---|---|---|
| URL do IdP do App Builder | https://idp.example.com/Vinyl/ | A URL da raiz da aplicação da instância de App Builder que funciona como IdP. Inclui a barra final. |
| URL do SP do App Builder | https://sp.example.com/Vinyl/ | A URL da raiz da aplicação da instância de App Builder que funciona como SP. Inclui a barra final. |
| Nome do Provedor de Segurança IdP | VinylIdP | Cada provedor de segurança do App Builder recebe um nome lógico. Este nome é usado no Ponto de Extremidade de Redirecionamento de Solicitação (veja abaixo). |
| Nome do Provedor de Segurança SP | VinylSP | Cada provedor de segurança do App Builder recebe um nome lógico. Este nome é usado na URL do Serviço de Consumidor de Asserção (ACS) (veja abaixo). Este é o nome que os usuários verão no formulário de login. |
| Ponto de Extremidade de Redirecionamento de Solicitação | https://idp.example.com/Vinyl/signin-VinylIdP | App Builder fornece automaticamente um Ponto de Extremidade de Redirecionamento de Solicitação para provedores de segurança SAML IdP. Observe que o Nome do Provedor de Segurança IdP (acima) aparece no Ponto de Extremidade de Redirecionamento de Solicitação. |
| URL do Serviço de Consumidor de Asserção | https://sp.example.com/Vinyl/signin-VinylSP | App Builder fornece automaticamente um ponto de extremidade do Serviço de Consumidor de Asserção (ACS) para provedores de segurança SAML SP. Observe que o Nome do Provedor de Segurança SP aparece no ponto de extremidade ACS. |
Gerar um certificado de assinatura
Em Logon Único SAML (SSO), a confiança é estabelecida por meio de certificados de assinatura. O processo para adquirir um certificado está fora do escopo deste documento. No entanto, para fins ilustrativos, os comandos a seguir demonstram como gerar um certificado compatível usando o utilitário de linha de comando OpenSSL.
O comando a seguir gera uma chave privada codificada em PEM (key.pem) e um certificado autoassinado (cert.pem):
$ openssl req -x509 -newkey rsa:2048 -keyout key.pem -out cert.pem -nodes -days 1095 -subj "/CN=idp.example.com/O=App BuilderIdP"
Você precisará do conteúdo do arquivo cert.pem para configurar o provedor de segurança SP do App Builder.
O comando a seguir gera um arquivo PKCS#12 (cert.pfx) contendo tanto a chave privada quanto o certificado:
$ openssl pkcs12 -export -in cert.pem -inkey key.pem -out cert.pfx
Será solicitado que você forneça uma senha. Você precisará da senha para configurar o provedor de segurança IdP do App Builder.
Por fim, o comando a seguir codifica em base64 o arquivo PKCS#12:
$ openssl base64 -in cert.pfx -out cert.txt -A
Você precisará do conteúdo do arquivo cert.txt para configurar o provedor de segurança IdP do App Builder.
Criar um provedor de segurança SAML IdP
Para criar um provedor de segurança SAML IdP, comece fazendo login na instância do App Builder que servirá como IdP.
- Navegue até o IDE
- Clique no botão Security Providers (Provedores de Segurança)
- Clique no botão + Security Provider (+ Provedor de Segurança)
-
Forneça o seguinte:
- Name (Nome): Nome do Provedor de Segurança IdP, por exemplo
VinylIdP - Type (Tipo): SAML Identity Provider
- Name (Nome): Nome do Provedor de Segurança IdP, por exemplo
-
Clique no botão Save (Salvar)
-
No painel Properties (Propriedades), clique no botão + Property (+ Propriedade) para adicionar cada uma das seguintes propriedades:
- AssertionConsumerService: URL do Serviço de Consumidor de Asserção, por exemplo
https://sp.example.com/Vinyl/signin-VinylSP. - Audience: URL do SP do App Builder, por exemplo
https://sp.example.com/Vinyl/. - Issuer: URL do IdP do App Builder, por exemplo
https://idp.example.com/Vinyl/. - Recipient: URL do Serviço de Consumidor de Asserção, por exemplo
https://sp.example.com/Vinyl/signin-VinylSP. - SigningCertificate: arquivo PKCS#12 codificado em base64 (consulte Generate a Signing Certificate).
- SigningCertificatePassword: Senha do certificado de assinatura (consulte Generate a Signing Certificate).
- AssertionConsumerService: URL do Serviço de Consumidor de Asserção, por exemplo
-
No painel Claims (Declarações), clique no botão + Claim (+ Declaração) para mapear cada uma das seguintes propriedades:
- Name:
http://schemas.xmlsoap.org/ws/2005/05/identity/claims/name - Group:
http://schemas.xmlsoap.org/claims/Group
- Name:
-
No painel Provider (Provedor), clique no botão Edit (Editar)
- Marque a opção Enabled (Ativado)
- Clique no botão Save (Salvar)
As etapas acima incluem uma declaração de grupo. A declaração de grupo é usada para passar a associação ao grupo para o SP. Porém, os grupos não são passados por padrão. Para passar um grupo, adicione-o ao provedor de segurança IdP. Por exemplo:
- Navegue até o IDE
- Clique no botão User Management (Gerenciamento de Usuários)
- Clique no botão Identities (Identidades)
- Selecione o provedor de segurança IdP, por exemplo
VinylIdP - No painel Provider Groups (Grupos do Provedor), clique no botão + Group (+ Grupo)
- Forneça um Name (Nome), por exemplo
Administrators(Administradores) - Selecione o Group (Grupo), por exemplo
Administrators(Administradores) - Clique no botão Save (Salvar)
Criar um provedor de segurança SAML SP
Para criar um provedor de segurança SAML SP, comece fazendo login na instância do App Builder que servirá como SP.
- Navegue até o IDE
- Clique no botão Security Providers (Provedores de Segurança)
- Clique no botão + Security Provider (+ Provedor de Segurança)
-
Forneça o seguinte:
- Name (Nome): Nome do Provedor de Segurança SP, por exemplo
VinylSP. - Type (Tipo): SAML
- User Provisioning (Provisionamento de Usuário): Marque para ativar o provisionamento de usuário.
- Show On Login Form (Mostrar no Formulário de Login): Marque para mostrar o provedor de autenticação no formulário de login.
- Name (Nome): Nome do Provedor de Segurança SP, por exemplo
-
Clique no botão Save (Salvar)
-
No painel Properties (Propriedades), clique no botão + Property (+ Propriedade) para adicionar cada uma das seguintes propriedades:
- Audience: URL do SP do App Builder, por exemplo
https://sp.example.com/Vinyl/. - Issuer: URL do IdP do App Builder, por exemplo
https://idp.example.com/Vinyl/. - Recipient: URL do Serviço de Consumidor de Asserção, por exemplo
https://sp.example.com/Vinyl/signin-VinylSP. - RequestRedirectEndpoint: Ponto de Extremidade de Redirecionamento de Solicitação, por exemplo
https://idp.example.com/Vinyl/signin-VinylIdP. - SigningCertificate: certificado codificado em PEM (consulte Generate a Signing Certificate).
- Audience: URL do SP do App Builder, por exemplo
-
No painel Claims (Declarações), clique no botão + Claim (+ Declaração) para mapear cada uma das seguintes propriedades:
- Name:
http://schemas.xmlsoap.org/ws/2005/05/identity/claims/name - Group:
http://schemas.xmlsoap.org/claims/Group
- Name:
-
No painel Provider (Provedor), clique no botão Edit (Editar)
- Marque a opção Enabled (Ativado)
- Clique no botão Save (Salvar)
As etapas acima incluem uma declaração de grupo. A declaração de grupo é usada para mapear declarações para grupos de provedor de segurança. Porém, os grupos de provedor de segurança não são mapeados para os grupos de segurança do App Builder por padrão. Para mapear um grupo de provedor de segurança para um grupo de segurança do App Builder:
- Navegue até o IDE
- Clique no botão User Management (Gerenciamento de Usuários)
- Clique no botão Identities (Identidades)
- Selecione o provedor de segurança SP, por exemplo
VinylSP - No painel Provider Groups (Grupos do Provedor), clique no botão + Group (+ Grupo)
- Forneça um Name (Nome), por exemplo
Administrators(Administradores) - Selecione o Group (Grupo), por exemplo
Administrators(Administradores) - Clique no botão Save (Salvar)
Teste
Para testar, comece abrindo um navegador em modo Incógnito/Privado.
- Navegue até a URL do App Builder SP, por exemplo
https://sp.example.com/Vinyl/. - No formulário de login, clique na opção para entrar com o App Builder SP, por exemplo
VinylSP. Você será redirecionado para o formulário de login do App Builder IdP. - Faça login na instância do App Builder IdP. Você será redirecionado de volta para o App Builder SP.
Se o teste foi bem-sucedido, você estará conectado na instância do App Builder SP.
Solução de problemas
Opção "entrar com..." ausente do formulário de login
Se a opção "Entrar com..." está ausente do formulário de login, o provedor de segurança do App Builder SP não está ativado ou a opção Exibir no Formulário de Login não foi marcada.
Erro 404 não encontrado após clicar em "entrar com..."
Se você receber um erro 404 Not Found após clicar no botão "Entrar com..." no formulário de login, isso pode indicar que o Provedor de Segurança do App Builder IdP não está ativado, está nomeado incorretamente ou está configurado incorretamente. Para evitar interrupção de serviço, o App Builder desativa o provedor de segurança no tempo de execução se detectar uma configuração incorreta.