Configure o Single Log-On (SSO) para que seus usuários e leitores façam login no Document360 com uma conta que já possuem, em vez de uma senha separada do Document360. Este artigo ajuda você a escolher o método SSO correto, entender o que as pessoas veem ao fazer login e iniciar a configuração.
O Document360 suporta três métodos:
- SAML 2.0 e OpenID Connect (OIDC): As pessoas fazem login pelo seu provedor de identidade, como Okta, Microsoft Entra ID ou Google Workspace.
- JWT (JSON Web Token): Seu próprio aplicativo registra leitores e passa um token verificado para o Document360, sem envolvimento de provedor de identidade.
Como funciona o login SSO
A SSO envolve duas partes:
- Provedor de identidade (IdP): O serviço que armazena e verifica credenciais, como Okta, Microsoft Entra ID, Google Workspace, ADFS ou OneLogin.
- Provedor de serviço (SP): Document360. Ele depende do IDP para confirmar quem está entrando.
Com SAML ou OpenID Connect, o login funciona da mesma forma para usuários e leitores:
- Um usuário abre o portal da base de conhecimento, ou um leitor abre seu site de base de conhecimento. Eles digitam o e-mail na página de login ou selecionam o botão SSO primeiro.
- O Document360 encontra a configuração de SSO correspondente e envia para a página de login do seu IDP.
- Eles fazem login com suas credenciais IDP. Eles nunca digitam uma senha no Document360.
- O IdP confirma sua identidade e envia um token assinado de volta para o Document360.
- O Document360 verifica o token e dá acesso a eles com base no papel e nas permissões.
Se eles já fizeram login no seu IDP para outra aplicação, não precisam fazer login novamente. Com SAML, você também pode permitir que as pessoas abram o Document360 diretamente pelo painel do seu IDP. Para aprender como, leia o login iniciado pelo IDP.
No JWT, não há IdP nem redirecionamento. Sua aplicação cria e assina o token, e o Document360 verifica diretamente.
Escolha um método SSO
| SAML 2.0 | OpenID Connect | JWT | |
|---|---|---|---|
| Escolha se | Você usa um IdP corporativo ou local, como ADFS, ou Okta, Microsoft Entra ID, Google Workspace ou OneLogin | Você usa um IDP baseado em nuvem, como Okta ou Auth0, ou ADFS com OpenID Connect | Você gerencia o login no seu próprio aplicativo e quer fazer login com leitores a partir daí |
| Quem pode fazer login | Usuários e leitores | Usuários e leitores | Apenas leitores |
| Precisa de um IDP | Sim | Sim | Não |
| Esforço de preparação | Médio | Médio | Maior: requer desenvolvimento personalizado |
| Provisão SCIM | Okta e Microsoft Entra ID; OneLogin apenas para leitores; ADFS por meio de ferramentas de terceiros; outros IDPs que suportam SCIM. Não disponível com o Google Workspace. | Okta; ADFS por meio de ferramentas de terceiros; outros IDPs que suportam SCIM. Não disponível com Auth0. | Não disponível |
Métodos de combinação
- Você pode ter várias configurações SAML ativas ao mesmo tempo, ou várias configurações do OpenID Connect, por exemplo, uma IdP para seus usuários e outra para seus leitores.
- SAML e OpenID Connect não podem estar ativos ao mesmo tempo. Para alternar entre um e outro, desative a configuração que você não quer mais usar.
- Você pode adicionar até cinco configurações de JWT junto com suas configurações SAML ou OpenID Connect.
Configurar SSO
Antes de começar
- Você precisa do cargo de Proprietário ou Administrador no seu projeto Document360.
- Certifique-se de ter acesso de administrador ao seu IDP ou, no caso do JWT, um desenvolvedor que possa atualizar o código de login do seu aplicativo.
- Decida qual método você vai usar. Veja Escolha um método SSO.
Toda configuração de SSO começa no mesmo lugar no Document360:
- Vá para Configurações > Usuários e Permissões > SSO Empresarial.
- Selecione Criar SSO.
- Selecione SAML, OpenID Connect ou JWT.
- Se você selecionou SAML ou OpenID Connect, selecione seu provedor de identidade. O assistente de configuração é aberto.
- Complete o assistente usando o guia do seu método.
Configurar JWT
Faça login com leitores no seu site de base de conhecimento a partir do seu próprio aplicativo.
Saiba mais →Quando terminar, a configuração aparece na lista de SSO Empresarial junto com todas as suas outras configurações de SSO. Você pode editar, reordenar ou remover a partir daí.
Usuários e leitores que fazem login pelo SSO usam suas credenciais IdP, não uma senha do Document360. Você não pode se bloquear: um administrador não pode remover seu próprio acesso, apenas o de outro administrador.
Depois que você configurar o SSO
Quando sua configuração de SSO estiver funcionando, configure o provisionamento automático e gerencie quem pode fazer login. O SCIM está disponível apenas para SAML e OpenID Connect.
Configurar o provisionamento SCIM
Adicione, atualize e desative usuários e leitores no seu IDP, e o Document360 atualiza automaticamente.
Saiba mais →Gerencie o acesso à SSO
Adicione usuários, gerencie leitores, mapeie projetos e controle as configurações de login.
Saiba mais →FAQ
Posso usar SAML e OpenID Connect ao mesmo tempo?
Não. Um projeto pode ter o SAML ou OpenID Connect ativos, mas não ambos. Para mudar, desative a configuração que você não quer mais usar. Qualquer um pode rodar junto com o JWT.
Posso configurar o SSO tanto para usuários quanto para leitores?
Sim. SAML e OpenID Connect funcionam para usuários que fazem login no portal da base de conhecimento e leitores que fazem login no site da base de conhecimento. O JWT funciona apenas para leitores e não pode ser usado para fazer login no portal.
Posso ter mais de uma configuração de SSO em um projeto?
Sim. Você pode ter várias configurações SAML ou várias configurações do OpenID Connect ativas ao mesmo tempo, por exemplo, um IdP para seus usuários e outro para seus leitores. Você também pode adicionar até cinco configurações JWT junto com elas.