Ir para o conteúdo

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:

  1. Gerar um certificado de assinatura.
  2. Criar um provedor de segurança SAML IdP.
  3. Criar um provedor de segurança SAML SP.
  4. Testar

Estas instruções pressupõem o seguinte:

  1. Você possui pelo menos duas instâncias de App Builder.
  2. 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.

  1. Navegue até o IDE
  2. Clique no botão Security Providers (Provedores de Segurança)
  3. Clique no botão + Security Provider (+ Provedor de Segurança)
  4. Forneça o seguinte:

    • Name (Nome): Nome do Provedor de Segurança IdP, por exemplo VinylIdP
    • Type (Tipo): SAML Identity Provider
  5. Clique no botão Save (Salvar)

  6. 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).
  7. 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
  8. No painel Provider (Provedor), clique no botão Edit (Editar)

  9. Marque a opção Enabled (Ativado)
  10. 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:

  1. Navegue até o IDE
  2. Clique no botão User Management (Gerenciamento de Usuários)
  3. Clique no botão Identities (Identidades)
  4. Selecione o provedor de segurança IdP, por exemplo VinylIdP
  5. No painel Provider Groups (Grupos do Provedor), clique no botão + Group (+ Grupo)
  6. Forneça um Name (Nome), por exemplo Administrators (Administradores)
  7. Selecione o Group (Grupo), por exemplo Administrators (Administradores)
  8. 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.

  1. Navegue até o IDE
  2. Clique no botão Security Providers (Provedores de Segurança)
  3. Clique no botão + Security Provider (+ Provedor de Segurança)
  4. 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.
  5. Clique no botão Save (Salvar)

  6. 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).
  7. 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
  8. No painel Provider (Provedor), clique no botão Edit (Editar)

  9. Marque a opção Enabled (Ativado)
  10. 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:

  1. Navegue até o IDE
  2. Clique no botão User Management (Gerenciamento de Usuários)
  3. Clique no botão Identities (Identidades)
  4. Selecione o provedor de segurança SP, por exemplo VinylSP
  5. No painel Provider Groups (Grupos do Provedor), clique no botão + Group (+ Grupo)
  6. Forneça um Name (Nome), por exemplo Administrators (Administradores)
  7. Selecione o Group (Grupo), por exemplo Administrators (Administradores)
  8. Clique no botão Save (Salvar)

Teste

Para testar, comece abrindo um navegador em modo Incógnito/Privado.

  1. Navegue até a URL do App Builder SP, por exemplo https://sp.example.com/Vinyl/.
  2. 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.
  3. 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.