SAML

SAML 2.0 é um protocolo padrão aberto que permite aos usuários acessar múltiplas aplicações baseadas na web com um único conjunto de credenciais. Isso oferece uma forma mais segura e conveniente para os usuários acessarem o Document360. Com o SAML 2.0 ativado, os usuários do Document360 podem fazer login na plataforma usando suas credenciais existentes de um provedor de identidade (IdP). O Document360 suporta a configuração de múltiplos endpoints de login único (SSO), permitindo que tanto usuários quanto leitores façam login usando seu provedor de identidade preferido.

Provedores de identidade suportados

O Document360 suporta os seguintes provedores de identidade (IdP):

• Okta

• Entra ID

• Google

• Auth0

• ADFS

• OneLogin

• Outros

Configuração do SSO usando SAML

1. Faça login na sua conta Document360 e navegue até o projeto desejado.

2. Navegue até Configurações () > Usuários e permissões > Configuração SSO.

3. Clique em Criar SSO.

4. Selecione um provedor de identidade na página Escolha seu Provedor de Identidade (IdP ).

   

5. Selecione SAML na página Configurar o Provedor de Serviço (SP ).

   

6. Usando os detalhes fornecidos na página Configurar o Provedor de Serviço (SP ), configure o aplicativo Document360 com o provedor de identidade previamente selecionado.

7. Usando os dados fornecidos pelo provedor de identidade, configure a configuração do SSO no Document360 na página Configurar o Provedor de Identidade (IdP ).

   

Ativando redirecionamento direto do site da base de conhecimento (SSO iniciado por IdP)

Se você quiser que usuários que fazem login por meio de um fluxo SSO iniciado por IdP sejam redirecionados diretamente para o site da sua base de conhecimento (em vez do painel do Projeto), você deve configurar o parâmetro RelayState no seu Provedor de Identidade (IdP).

Para configurar isso:

1. Faça login no console de administração do seu Provedor de Identidade (IdP) (por exemplo, Okta, Entra ID, Auth0 ou ADFS).

2. Abra o aplicativo SAML que você criou para o Document360.

3. Localize o campo RelayState (ou equivalente).

4. Insira a URL do seu site de base de conhecimento.

   Por exemplo: https://docs.yourdomain.com

5. Salve sua configuração.

6. Teste o login iniciado pelo IdP para verificar se os usuários são redirecionados diretamente para o site da Knowledge Base.

NOTA

Se o campo RelayState ficar em branco, os usuários serão redirecionados para o painel do Projeto Document360 por padrão.

Depois de concluir com sucesso a configuração do SSO baseada no protocolo SAML, você pode convidar membros do seu projeto para a aplicação SSO configurada.

Agora, os usuários podem fazer login no Document360 usando seu e-mail e senha ou usando SSO.

Solução de problemas

Se você encontrar problemas durante a configuração ou login do SSO em SAML, consulte os seguintes erros comuns e suas soluções:

Requisição SAML inválida (Chave não confiável)

Erro: Um erro foi encontrado ao lidar com o login remoto - a assinatura SAML inválida de solicitação SAML é válida, mas usa uma chave não confiável. Esse erro ocorre quando o certificado SAML enviado para o Document360 está inativo.

Passos para resolver:

Para resolver essa questão,

Baixe o certificado SAML ativo

1. Acesse seu IDP.

2. Baixe o certificado SAML atualmente ativo.

Refaça o upload do certificado no Document360

1. No Document360, navegue até Configurações () > Usuários e permissões > SAML/OpenID.

2. Clique em Editar para a configuração relevante do SSO.

3. Na seção Configurar o Provedor de Identidade (IdP ), localize o campo Certificado SAML .

4. Clique em Navegar para enviar o novo certificado ativo.

Fazer upload do certificado ativo deve resolver o problema.

Assinatura de mensagem SAML inválida

Erro:

• AssinaturaInválido: Assinatura da mensagem SAML é inválida.

• AssertionSignatureInvalid: Assinatura de assertion SAML inválida.

• Solicitação SAML inválida: Assinatura SAML é válida, mas usa uma chave não confiável.

Esse erro ocorre quando um certificado SAML incorreto ou expirado é enviado para o Document360.

Passos para resolver:

Certifique-se de que o certificado seja válido:

1. Verifique se o certificado enviado está ativo e não expirado.

2. Se necessário, gere um novo certificado no Provedor de Identidade (IdP).

Refaça o upload do certificado correto no Document360:

1. No Document360, navegue até Configurações () > Usuários e permissões > SAML/OpenID.

2. Clique em Editar para a configuração relevante do SSO.

3. Na seção Configurar o Provedor de Identidade (IdP ), localize o campo Certificado SAML .

4. Clique em Navegar para enviar o novo certificado ativo.

Registrar registros de captura para análise adicional (caso o problema persista)

1. Adicione a extensão SAML Tracer ao seu navegador.

2. Abra o SAML Tracer antes de iniciar o fluxo de login do SSO.

3. Execute a ação que aciona o processo SSO (por exemplo, clicar em Continuar com SSO).

4. O rastreador SAML gravará todas as solicitações de rede.

5. Clique com o botão direito no painel SAML Tracer .

6. Selecione Exportar ou salve os registros em um formato adequado.

Para mais assistência, entre em contato com a equipe de suporte do Document360 com:

• Capturas de tela da sua configuração de IdP.

• Os detalhes do certificado SAML enviado.

• Registros rastreadores SAML.