Configurando Okta no Jitterbit App Builder
Okta é um Provedor de Identidade (IdP) que suporta autenticação SAML Single Sign-On (SSO). O App Builder integra-se com Okta como um Provedor de Serviços (SP). Cada instância do App Builder deve ser integrada com Okta e vice-versa. Existem três tarefas principais envolvidas:
- Registrar o App Builder como uma aplicação Okta.
- Configurar Okta como um provedor de segurança do App Builder.
- Mapear usuários do App Builder para identidades Okta.
Assume-se que sua organização já possui uma conta Okta existente.
As instruções abaixo referem-se às seguintes propriedades:
| Exemplo | Observações | |
|---|---|---|
| URL do App Builder | https://example.com/Vinyl/ | A URL pela qual o App Builder é hospedado. Inclui a barra final. O caminho diferencia maiúsculas de minúsculas. |
| Nome do Provedor de Segurança | Okta | 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. |
| URL do Serviço de Consumidor de Asserção | https://example.com/Vinyl/signin-Okta | O App Builder provisiona automaticamente um endpoint do Serviço de Consumidor de Asserção (ACS) para provedores de segurança SAML Single Sign-On (SSO). Okta refere-se à URL do ACS como "Post Back URL" ou "Single sign on URL". Observe que o Nome do Provedor aparece na URL. |
Registrar o App Builder como uma aplicação Okta
O documento Okta a seguir descreve como registrar uma aplicação SAML: https://developer.okta.com/standards/SAML/setting_up_a_saml_application_in_okta
-
Durante o processo de configuração, será solicitado fornecer as seguintes informações:
-
Nome: Nome do ambiente App Builder.\
Exemplo: App Builder Development
-
URL de logon único: Corresponde à
URL do Serviço de Consumidor de Asserção.\Exemplo:
https://example.com/Vinyl/signin-Okta -
URI de Audience: Embora a URI de audience seja arbitrária, Okta e App Builder devem usar a mesma URI de Audience. Considere usar a
URL do App Builder.\Exemplo:
https://example.com/Vinyl/. -
Formato de ID de Nome:
EmailAddress - Nome de usuário da aplicação:
Okta username
-
-
Você pode fornecer mapeamentos de solicitações opcionais de Attribute Statements ou Group Attribute Statements. As solicitações comumente mapeadas incluem:
- Endereço de Email - http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress
- Associação ao Grupo - http://schemas.xmlsoap.org/claims/Group
Nota
Consulte Claims para informações adicionais sobre solicitações.
-
Clique em Next, selecione I'm an Okta customer adding an internal app e clique em Finish.
-
Após a criação da aplicação Okta, copie e armazene os seguintes valores para referência posterior:
- Metadata URL. Exemplo:
https://www.okta.com/app/abcdef012345/sso/saml/metadata - Sign on URL. Exemplo:
https://example.okta.com/app/abcdef012345/sso/saml - Issuer. Exemplo:
http://www.okta.com/abcdef012345
- Metadata URL. Exemplo:
Configurar Okta como provedor de segurança do App Builder
Para configurar Okta como provedor de segurança do App Builder, comece entrando no App Builder como administrador.
- Navegue até o IDE
- Selecione o botão Security Providers
- Clique no botão + Security Provider
-
Forneça as seguintes informações:
-
Name:
Security Provider Name(veja acima)\Exemplo: Okta
-
Type: SAML
- Enabled: Marque
-
-
Clique no botão Save
-
Na seção Tokens, forneça as seguintes informações:
-
Audience:
Audience URI(veja acima)Exemplo:
https://example.com/Vinyl/ -
Recipient:
Single sign-on URL(veja acima)Exemplo:
https://example.com/Vinyl/signin-Okta -
Issuer:
Issuer(veja acima)Exemplo:
http://www.okta.com/abcdef012345
-
-
Clique no botão Save
-
Na seção Provisioning, confirme as seguintes configurações:
- User Provisioning: Marque
- Supplies Group Membership: Marque
- Store Claims: Marque
-
No painel Endpoints, clique no botão + Endpoint
-
Forneça as seguintes informações:
- Type: Metadata Endpoint
-
URL:
Metadata URL(veja acima)Exemplo:
https://www.okta.com/app/abcdef012345/sso/saml/metadata
-
Clique no botão Save
- No painel Claims, será necessário mapear quaisquer claims do Okta no App Builder. Por exemplo, para mapear os claims Group e E-mail Address, clique no botão + Claim
-
Forneça as seguintes informações:
-
Identifier: Nome do tipo de claim.
Exemplo:
http://schemas.xmlsoap.org/ws/2005/05/identity/claims/Group -
Usage: Uso do tipo de claim.
Exemplo: Group
-
-
Clique no botão Save
- Saia da tela Claim e clique no botão + Claim do painel Claims
-
Forneça as seguintes informações:
-
Identifier: Nome do tipo de claim.
Exemplo:
http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress -
Usage: Uso do tipo de claim.
Exemplo: E-mail Address
-
-
Clique no botão Save
- Na seção Sign In, marque a opção para ativar Show On Login Form. Isso ativa um botão Sign in with Okta para exibição na página de login do App Builder.
- Clique no botão Save
Mapear usuários do App Builder para identidades do Okta
Com provisionamento de usuário
Se você ativou o provisionamento de usuário conforme descrito acima e tentar entrar, poderá ser redirecionado de volta ao formulário de login do App Builder com a seguinte mensagem:
The user account (
arthur.dent@example.com) has not been granted access to an application.
Embora o App Builder tenha provisionado o usuário com sucesso, o usuário não tem acesso a nenhum aplicativo do App Builder por padrão. Supondo que o usuário do Okta tenha sido adicionado a um ou mais grupos e que Supplies Group Membership esteja ativado (conforme descrito acima), será necessário mapear os grupos de segurança do Okta para grupos de segurança do App Builder.
Para mapear grupos de segurança do Okta para grupos de segurança do App Builder, comece entrando no App Builder como administrador.
- Navegue até o IDE
- Clique no botão User Management
- Clique na aba Identities
- No painel Provider Groups, localize o grupo do Okta e clique no ícone Details (Popup)
- Clique no botão Edit
- Na lista Group, selecione o grupo do App Builder
- Clique no botão Save
Consulte Provisionamento de usuários e grupos para obter informações adicionais.
Sem provisionamento de usuário
Se você não ativou o provisionamento de usuário, a autenticação falhará com uma mensagem semelhante à seguinte:
Although you've successfully authenticated with Okta, the account
arthur.dent@example.com(arthur.dent@example.com) is not associated with a local account.
Na mensagem acima, arthur.dent@example.com é o Okta User Name (chamado de "name" na autenticação por claims). A parte entre parênteses é o Okta Name Identifier (chamado de "name identifier" na autenticação por claims). Você precisará dessas duas informações para a próxima etapa.
Para mapear uma conta de usuário do App Builder para uma identidade Okta, comece entrando no App Builder como administrador:
- Navegue até a IDE
- Clique no botão User Management
- No painel Users, localize e selecione o usuário que deseja mapear
- No painel Identities, clique no botão + Identity
-
Forneça o seguinte:
-
Provider:
Security Provider Name\Exemplo: Okta
-
Name:
Okta User Name(veja acima) - Identifier:
Okta Name Identifier(veja acima)
-
-
Clique no ícone Save (Verificar)
Solução de problemas
O usuário é redirecionado de volta para a página de login após entrar.
Se User Provisioning foi habilitado, o usuário pode ter sido criado, mas não foi atribuído a nenhum grupo ou os grupos aos quais o usuário foi atribuído não receberam acesso a nenhum aplicativo do App Builder. O único grupo atribuído a novos usuários por padrão (ou seja, com a opção Grant On User Create habilitada) é o grupo Users. Este grupo não recebe acesso a nenhum aplicativo por padrão.
Se a opção Supplies Group Membership foi habilitada, o App Builder registrou os grupos do Okta. Entre como administrador e mapeie os grupos do Okta para os grupos de segurança do App Builder. Se a opção Supplies Group Membership não foi habilitada, o provedor de segurança do Okta não terá nenhum grupo. Entre como administrador e defina um ou mais grupos de provedor de segurança do Okta com a opção Grant On Identity Create habilitada e mapeie os grupos do provedor para os grupos de segurança do App Builder.
Se o provedor de segurança Require HTTPS não foi habilitado, o usuário pode iniciar o processo de SAML SSO a partir de uma URL não segura (por exemplo, http://example.com/Vinyl/). No entanto, o Provedor de Identidade retornará o usuário para a URL segura do Assertion Consumer Service (ACS) (https://example.com/Vinyl/signin-Okta). O App Builder autentica o usuário no contexto da URL segura antes de devolvê-lo à URL não segura. Na prática, o usuário possui duas sessões separadas. Para resolver este problema, habilite o provedor de segurança Require HTTPS.
O aplicativo Okta pode estar desativado.
Erro: "the audiencerestrictioncondition was not valid because the specified audience is not present in audienceuris."
Este erro indica que o URI de audience não corresponde. Certifique-se de que a propriedade Audience foi definida explicitamente. Se não estiver definida, o padrão será a URL atual, que pode variar por usuário. O valor diferencia maiúsculas de minúsculas.
Erro: "an unhandled exception was caught at the end of the pipeline."
Este erro pode indicar uma incompatibilidade entre o valor Recipient configurado e o valor Recipient esperado no App Builder. Certifique-se de que o valor Recipient esteja configurado corretamente.