Configurar SSO com Okta

Configure o single sign-on entre o Okta e a Clevera para que sua equipe faça login com a conta do Okta. Você pode conectar usando SAML 2.0 ou OpenID Connect (OIDC); este guia percorre ambos no lado do Okta e os campos correspondentes na Clevera.

O console de administração do Okta muda de tempos em tempos. Se um rótulo abaixo não corresponder ao que você vê, procure a configuração com o mesmo significado e use os guias gerais para a lista completa de valores: SAML, OIDC.

Antes de começar#

• Você é o Proprietário de um workspace da Clevera em um Plano personalizado.
• Você é um administrador do Okta que pode criar integrações de aplicativos e atribuí-las.
• Você conhece os domínios de e-mail que sua equipe usa no Okta, como acme.example.

Abra a caixa de diálogo de configuração da Clevera primeiro, para que você possa copiar os valores dela: abra o menu do workspace na parte superior da barra lateral, escolha Configurações da equipe, depois Segurança e clique em Configurar SSO. Escolha Okta como o Provedor de identidade.

Conectar com SAML 2.0#

1. Criar o aplicativo no Okta#

   No Console de Administração do Okta, vá para Applications → Applications e clique em Create App Integration. Escolha SAML 2.0 e clique em Próximo. Dê um nome a ele Clevera e clique em Próximo.

2. Inserir os valores da Clevera#

   Em SAML Settings, preencha:

   Campo do Okta	Valor da Clevera
   Single sign-on URL	ACS URL (Reply URL): https://app.clevera.ai/sso/saml/callback. Mantenha Use this for Recipient URL and Destination URL marcado.
   Audience URI (SP Entity ID)	Entity ID / Audience URI (copie da caixa de diálogo da Clevera; termina com o ID do seu workspace)
   Default RelayState	Deixe vazio
   Name ID format	EmailAddress
   Application username	Email

3. Verificar a assinatura#

   Clique em Show Advanced Settings e verifique se Response e Assertion Signature estão ambos Signed, se o Signature Algorithm é RSA-SHA256 e se Assertion Encryption está Unencrypted. A Clevera precisa que tanto a resposta quanto a asserção estejam assinadas.

4. Adicionar atributos de nome#

   Em Attribute Statements, adicione firstName com o valor user.firstName e lastName com o valor user.lastName. A Clevera os usa para nomear novas contas. Clique em Próximo, responda à pergunta de feedback do Okta como um aplicativo interno e clique em Finish.

5. Copiar os valores do Okta para a Clevera#

   Na aba Sign On do aplicativo, abra os detalhes da configuração SAML (View SAML setup instructions ou More details em consoles mais novos). Na Clevera, defina Protocol como SAML 2.0, clique em Continuar e cole:

   Valor do Okta	Campo da Clevera
   Identity Provider Issuer (ou Issuer)	IdP Entity ID
   Identity Provider Single Sign-On URL (ou Sign on URL)	SSO sign-in URL
   X.509 Certificate (ou Signing Certificate)	X.509 certificate

   Deixe a Logout URL vazia, a menos que você use o logout único do Okta.

   

6. Atribuir pessoas#

   Na aba Assignments do aplicativo, clique em Assign e adicione as pessoas ou grupos que devem usar a Clevera. Pessoas que não forem atribuídas não poderão fazer login pelo Okta.

Em seguida, finalize na Clevera: domínios e funções.

Conectar com OpenID Connect#

1. Criar o aplicativo no Okta#

   Vá para Applications → Applications → Create App Integration. Escolha OIDC - OpenID Connect, depois Web Application e clique em Próximo.

2. Definir o URI de redirecionamento#

   Na caixa de diálogo de configuração da Clevera, defina Protocol como OpenID Connect e copie o Redirect URI (callback URL) da caixa cinza. Em seguida, preencha no Okta:

   Campo do Okta	Valor
   App integration name	Clevera
   Grant type	Authorization Code
   Sign-in redirect URIs	O Redirect URI (callback URL): https://app.clevera.ai/sso/oidc/callback
   Sign-out redirect URIs	Remova o exemplo; deixe vazio
   Controlled access	Escolha quem pode usar o aplicativo ou Skip group assignment for now e atribua depois

   Clique em Salvar.

3. Copiar as credenciais#

   Na aba General do aplicativo, em Client Credentials, copie o Client ID e o Client secret. Deixe a Client authentication definida como Client secret.

4. Preencher na Clevera#

   Na Clevera, clique em Continuar e insira:

   Campo da Clevera	Valor
   Client ID	Client ID do Okta
   Client secret	Client secret do Okta
   Discovery URL	https:// seu domínio do Okta /.well-known/openid-configuration, por exemplo https://acme.okta.com/.well-known/openid-configuration

   Se você usar um servidor de autorização personalizado, use a própria URL de descoberta dele, por exemplo https://acme.okta.com/oauth2/default/.well-known/openid-configuration.

   

5. Atribuir pessoas#

   Na aba Assignments, atribua as pessoas ou grupos que devem usar a Clevera.

Finalizar na Clevera#

1. Em Domains & roles, adicione cada domínio de e-mail que seus usuários do Okta possuem, escolha Create accounts on first sign-in e a Default role for new SSO members.
2. Em Revisar, clique em Save configuration.
3. Clique em Run test, ative Enable SSO e faça login como um usuário de teste atribuído em uma janela privada, começando pela página de login da Clevera.
4. Quando funcionar para todos, ative Require SSO se você quiser que o SSO seja a única forma de acesso.

Os membros então digitam seu e-mail de trabalho na página de login da Clevera e clicam em Continue with Okta.

Solução de problemas#

Mais mensagens: Corrigir problemas de login SSO.

Relacionado#