Isenção de responsabilidade: Este artigo foi gerado usando tradução automática.

SAML

Prev Next

Configure o SSO SAML para que seus usuários e leitores façam login no Document360 através do seu provedor de identidade (IdP), como Okta, Microsoft Entra ID ou Google Workspace, em vez de usar uma senha separada do Document360. O Document360 atua como provedor de serviço (SP): seu IdP confirma quem está entrando e envia ao Document360 uma confirmação assinada digitalmente, chamada de assertion.

O que o SAML oferece

  • As regras de segurança do seu IDP se aplicam ao Document360. Autenticação multifator (MFA), políticas de acesso condicional e controles de sessão que você define no seu IdP se aplicam toda vez que alguém faz login.
  • Você controla o acesso de um único lugar. Quando você desativa alguém no seu IDP, essa pessoa não pode mais fazer login no Document360.

Este artigo ajuda você a escolher seu IDP, guia pelo assistente de configuração e mostra como permitir que as pessoas façam login pelo painel do seu IDP e mantenham seu certificado atualizado.


Escolha seu provedor de identidade

Cada IdP abaixo suporta login para usuários e leitores, e login a partir do painel do IdP. Eles diferem no suporte a SCIM, que mantém usuários e leitores sincronizados automaticamente com seu IdP. Selecione seu IdP para abrir seu guia passo a passo.

Provedor de identidade Provisão SCIM
Okta Usuários e leitores
Microsoft Entra ID Usuários e leitores
Google Workspace Não suportado
OneLogin Apenas leitores
ADFS Por meio de ferramentas de terceiros
Outros provedores SAML 2.0 Se seu IDP suporta SCIM

Configurar SAML SSO

Antes de começar

  • Você precisa do cargo de Proprietário ou Administrador no seu projeto Document360.
  • Você precisa de acesso de administrador ao seu IDP.
  • Tenha o certificado X.509 do seu IDP pronto, em formato PEM, CRT ou CER, com até 10 MB.

AVISO

Duas escolhas nessa configuração não podem ser desfeitas:

  • Provedor de identidade: Você não pode alterar o IDP depois de criar a configuração.
  • Converter contas existentes para SSO: Usuários e leitores convertidos perdem o login por senha imediatamente e precisam fazer login pelo seu IDP. Cada um deles recebe um e-mail sobre a mudança.
  1. Vá em Configurações () > Usuários e Permissões > SSO Empresarial.
  2. Selecione Criar SSO e depois selecione SAML.
  3. Selecione seu provedor de identidade. O assistente de configuração se abre.
  4. No Configure SP, copie os parâmetros gerados pelo Document360 (subdomínio, caminho de retorno e ID da entidade) no seu IdP.
  5. No Configurar IdP, insira os valores do seu IdP: a URL de Logar, ID da Entidade e certificado X.509. Para permitir que as pessoas façam login pelo painel do seu IDP, ative Permitir login iniciado por IdP.
  6. (Opcional) No SCIM, ative o provisionamento automático de usuários e grupos.
  7. Em Mais configurações, defina o nome do SSO, o texto do botão de login e o tempo limite da sessão ociosa. Se você quiser que usuários e leitores existentes façam login pelo seu IDP em vez de com senha, escolha converter suas contas para SSO.

Para os valores exatos a copiar para seu IDP, siga o guia dele em Escolha seu provedor de identidade.

Quando você termina, a configuração aparece na lista de SSO da Empresa . Para alterar depois, edite a configuração: as mesmas configurações aparecem como abas em vez de etapas do assistente.


Deixe as pessoas fazerem login pelo seu painel de IdP

Por padrão, as pessoas fazem login a partir da página de login do Document360. Com o login iniciado pelo IdP, usuários e leitores também podem abrir o Document360 diretamente pelo painel do seu IDP.

Se você não ativou o Permitir login iniciado por IdP durante a configuração, ative para uma configuração existente:

  1. Vá em Configurações () > Usuários e Permissões > SSO Empresarial.

  2. Passe o mouse sobre a configuração e então selecione o ícone Editar ().

    The Edit icon on a SAML configuration in the Enterprise SSO list

  3. Selecione a aba de configurações de IdP .

  4. Ative o Permitir login iniciado por IdP.

    The Allow IdP initiated sign in toggle on the IdP configurations tab

  5. Selecione Atualizar.

Em seguida, copie a URL de login iniciada pelo IdP do seu IdP e compartilhe com seus usuários e leitores. Eles abrem a URL, entram no painel do seu IDP e selecionam seu projeto Document360 para entrar direto.

NOTA

Se as pessoas virem um erro ao abrir o Document360 no painel do seu IDP, verifique se permitir login iniciado por IdP está ativado.


Renove seu certificado SAML antes que ele expire

O Document360 usa o certificado X.509 do seu IdP para verificar cada login. Quando o certificado expira, o login SAML para de funcionar para todos que usam essa configuração.

Quinze dias antes do vencimento, um banner de Aviso de Rotação de Certificado SAML aparece na página do SSO Empresarial . Baixe o certificado atualizado do banner e renove-o no seu IdP antes da data de expiração. Para saber mais, leia Gerenciando certificados SSO.


Depois que você configurar o SAML

 
   
     

Configurar o provisionamento SCIM

   
   

Adicione, atualize e desative usuários e leitores no seu IDP, e o Document360 atualiza automaticamente.

   Saiba mais →  
 
   
     

Remover uma configuração SAML

   
   

Descubra o que acontece ao remover uma configuração SAML e como fazer isso com segurança.

   Saiba mais →  

FAQ

Posso ter mais de uma configuração SAML em um projeto?

Sim. Você pode ter várias configurações SAML ativas ao mesmo tempo, cada uma com um provedor de identidade diferente. Por exemplo, você pode usar o Okta para seus usuários e o Microsoft Entra ID para seus leitores.

Posso usar SAML e OpenID Connect ao mesmo tempo?

Não. SAML e OpenID Connect não podem estar ativos no mesmo projeto. Para mudar, desative a configuração que você não quer mais usar.

Posso usar SAML e JWT ao mesmo tempo?

Sim. O SAML faz login com usuários e leitores através do seu provedor de identidade, e o JWT faz login com leitores pelo seu próprio aplicativo. Ambos podem estar ativos no mesmo projeto.