Configurar o logon único com o Okta

Depois disso, os agentes entram no Taiwa com a conta do Okta. Você precisa de um administrador do Okta que possa criar integrações de app e da função de administrador no Taiwa.

Antes de começar

• Peça ao Taiwa para verificar os domínios de e-mail da sua organização. O Taiwa recusa a entrada de um domínio de e-mail que não foi verificado.
• Cada agente precisa de um endereço de e-mail principal no Okta, em um desses domínios. O Taiwa só permite a entrada de um usuário quando o Okta informa que esse endereço de e-mail foi verificado.

1. Criar a integração de app

1. No Okta Admin Console, acesse Applications > Applications e selecione Create App Integration.
2. Em Sign-in method, selecione OIDC - OpenID Connect. Em Application type, selecione Web Application. Selecione Next.
3. Em App integration name, digite Taiwa.
4. Em Grant type, mantenha Authorization Code.
5. Em Sign-in redirect URIs, digite https://api.taiwa.cx/v1/auth/sso/callback. Remova qualquer URI de redirecionamento de saída.
6. Em Assignments, escolha quem pode usar o Taiwa. Selecione Save.

2. Copiar os dados do cliente

1. Na guia General, em Client Credentials, copie o Client ID.
2. Em Client authentication, mantenha Client secret. Copie o Secret do cliente.
3. Se a opção Require PKCE as additional verification estiver selecionada, desmarque-a. O Taiwa não envia PKCE e, nesse caso, o Okta recusa a entrada.

3. Atribuir pessoas

Na guia Assignments, atribua as pessoas ou os grupos que usam o Taiwa. O Okta recusa a entrada de uma pessoa que não foi atribuída.

4. Conectar o Okta no portal de administração

1. No portal de administração, abra SSO e provisionamento.
2. Em URL do issuer, digite o seu domínio do Okta, por exemplo https://acme.okta.com. Use o domínio sem -admin.
3. Em Client ID e Client secret, digite os valores do Okta.
4. Selecione Salvar conexão.

Se a sua organização usa um servidor de autorização personalizado no Okta, digite o issuer dele, por exemplo https://acme.okta.com/oauth2/default.

5. Testar

Entre no portal de administração em uma janela anônima do navegador. Selecione Entrar com SSO, digite o ID da organização e entre com uma conta do Okta que você atribuiu.

Sincronização de diretório com SCIM (opcional)

Uma integração de app OIDC do Okta não pode usar SCIM. Crie uma segunda integração de app para a sincronização de diretório.

1. No portal de administração, em Sincronização de diretório (SCIM 2.0), copie a URL base do SCIM e selecione Gerar token. Copie o token imediatamente.
2. No Okta, crie uma segunda integração de app, por exemplo Taiwa provisioning, conforme descrito no guia do Okta para provisionamento SCIM.
3. Na guia General dessa integração, em App Settings, selecione Edit. Em Provisioning, selecione SCIM e selecione Save.
4. Na guia Provisioning, em Integration, digite a URL base do SCIM como a URL base do conector SCIM. Em Unique identifier field for users, digite userName.
5. No modo de autenticação, selecione HTTP Header e digite o token como bearer token.
6. Selecione Test Connector Configuration e salve.
7. Ative Create Users, Update User Attributes e Deactivate Users e atribua as mesmas pessoas da integração de app de entrada.

Se a entrada falhar

Quando uma entrada falha depois do provedor de identidade, o navegador mostra uma página em api.taiwa.cx com o motivo. O motivo aparece em inglês.

Artigos relacionados

• Logon único e provisionamento de usuários
• Não consigo entrar