--- title: "ADFS com SAML SSO" slug: "saml-sso-with-adfs" updated: 2026-10-12T08:21:03Z published: 2026-10-12T08:21:03Z canonical: "docs.document360.com/saml-sso-with-adfs" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.document360.com/llms.txt > Use this file to discover all available pages before exploring further. # ADFS com SAML SSO **Os Serviços de Federação do Active Directory (ADFS)** são o provedor de identidade local da Microsoft que permite identidade federada e login único entre aplicações. Com o SSO SAML configurado entre ADFS e Document360, seus membros de equipe e leitores podem fazer login no Document360 usando suas credenciais existentes do Active Directory. NOTA Somente usuários com as funções **de projeto Proprietário** ou **Administrador** podem configurar o SSO no Document360. ## O que você pode fazer com o ADFS como seu IDP | Capacidade | Apoiado | | --- | --- | | Autenticação de membro da equipe (portal) | Sim | | Autenticação do leitor (site da base de conhecimento) | Sim | | Login iniciado pelo IdP | Sim | | Provisão SCIM | Sim (apenas por ferramentas de terceiros ou integrações personalizadas) | | Herança de configuração SSO (projetos pai-filho) | Sim | NOTA O ADFS não suporta nativamente o provisionamento SCIM. O SCIM só pode ser habilitado usando ferramentas de terceiros ou integrações personalizadas. --- ## Antes de começar - Você tem acesso administrativo tanto ao Document360 quanto ao seu servidor ADFS. - Você tem acesso **de Proprietário** ou **Administrador** no seu projeto Document360. - Abra o Document360 e o ADFS em duas abas separadas do navegador. Você precisará alternar entre elas várias vezes durante a configuração. --- ## Passo 1: Crie um Trust de Parte Confiável no ADFS #### Adicionar a aplicação no ADFS 1. Faça login no console **de gerenciamento do ADFS** no seu servidor ADFS. 2. No console de gerenciamento do ADFS, navegue até **Trusts de Partes Confiáveis**. 3. Clique com o botão direito **em Confianças Parte** Confiável e selecione **Adicionar Confiança Confiável.** 4. No **Assistente de Confiança de Parte Confiável,** escolha **Sinistros conscientes** e clique **em Iniciar**. 5. Selecione **Inserir dados sobre a parte confiável manualmente** e clique **em Próximo**. 6. Forneça um nome de exibição (por exemplo, "Document360 SAML SSO") e clique **em Próximo**. 7. Na **etapa Configurar Certificado** , clique **em Próximo** (você pode pular isso se não estiver usando um certificado). 8. **Em Configurar URL,** selecione **Habilitar suporte ao protocolo SAML 2.0 Web SSO**. --- ## Passo 2: Configure o ADFS com os parâmetros do Document360 Service Provider #### Obtenha os parâmetros SP no Document360 1. Abra o Document360 em uma aba separada. 2. Navegue até **Configurações** () > **Usuários e permissões** > **SSO Empresarial**. 3. Clique **em Criar SSO**. ![SSO configuration and user permissions settings.](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/SSO-configurations.png) 1. Selecione **o ADFS** como seu Provedor de Identidade (IdP) para navegar automaticamente até a etapa **Configurar SP** . ![Select your Identity Provider for SSO configuration, highlighting OneLogin option.](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/SAML-create-sso-step-1.png) 1. Na **etapa Configurar SP** , um conjunto de parâmetros será exibido para completar a configuração SAML no ADFS. ![Configuration settings for SSO using SAML and ADFS management overview.](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/saml-adfs-sp.png) #### Insira os parâmetros do Document360 no ADFS Insira os parâmetros do Document360 nos campos correspondentes nas etapas **Configurar URL** e **Identificadores** no ADFS usando o mapeamento abaixo. | ADFS | Document360 | | --- | --- | | Confiando no Identificador da Parte | ID da entidade do provedor de serviço | | URL de Login | Caminho de retorno | | URL de Encerramento | Caminho de retorno de chamada desconectado | | Identificador de Confiança da Parte Confiável | Nome do subdomínio | | URL de metadados | Caminho de metadados | 1. Clique **em Próximo** e complete as etapas restantes do assistente, como configurar a autenticação multifator, se necessário, e permitir que todos os usuários acessem o aplicativo. 2. Revise suas configurações e clique **em Próximo** para adicionar a parte confiável. 3. Na tela final, marque a caixa **Abrir o diálogo Editar Regras de Reivindicação** e clique **em Fechar**. --- ## Passo 3: Configurar regras de reivindicação no ADFS #### Adicionar regras de reivindicação 1. No diálogo **Editar Regras de Reivindicação** , clique **em Adicionar Regra**. 2. Selecione **Enviar Atributos LDAP como Reivindicações** como modelo de regra e clique **em Próximo**. 3. Forneça um nome para a regra de reivindicação (por exemplo, "Enviar Atributos LDAP"). 4. Configure o seguinte: - **Armazenamento de Atributos**: Selecione **Active Directory**. - **Mapeamento**: - **Atributo LDAP**: Nome Principal do Usuário | **Tipo de Reivindicação Saída**: ID do Nome - **Atributo LDAP**: Endereços de E-mail | **Tipo de Reivindicação de Saída**: Endereços de E-mail - **Atributo LDAP**: Nome de Exibição | **Tipo de Reivindicação de Saída**: Nome 5. Clique **em Finalizar** para adicionar a regra. 6. Clique **em Aplicar** para salvar suas alterações e feche o diálogo. --- ## Passo 4: Complete a configuração do SSO no Document360 #### Configure o Provedor de Identidade no Document360 1. Volte à aba Document360 que exibe a etapa **Configurar SP** e clique em **Próximo** para navegar até a etapa **Configurar IdP** . ![Configuration settings for Single Sign-On with highlighted fields for user input.](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/saml-adfs-idp.png) 1. O campo **Configurar uma conexão existente** permite que você herde uma configuração SSO que já tenha SCIM ativado de um projeto pai. Ao selecionar essa opção, a configuração atual do SSO se torna o filho e herda automaticamente as configurações SCIM do projeto pai. 2. Insira os valores correspondentes da sua configuração ADFS usando o mapeamento abaixo. | ADFS | Document360 | | --- | --- | | URL de Login SAML | URL de Login Único do Provedor de Identidade | | Identificador (ID da Entidade) | Emissora do Provedor de Identidade | | Certificado X.509 | Certificado SAML | 1. Baixe o Certificado X.509 do ADFS e faça o upload no campo **Certificado SAML** no Document360. NOTA Ao exportar o certificado X.509 do ADFS, selecione o formato **codificado Base-64 (. CER** ). O formato padrão codificado por DER não é suportado para configuração SAML do Document360. 1. Ative ou desative a opção **Permitir login iniciado por idP** conforme as necessidades do seu projeto. 2. Clique **em Próximo** para prosseguir para a etapa de **provisionamento do SCIM** . --- ## Passo 5: Configurar o provisionamento SCIM O provisionamento SCIM permite automatizar o gerenciamento do ciclo de vida do usuário e do leitor entre o ADFS e o Document360. Como o ADFS não suporta SCIM nativamente, isso requer uma ferramenta de terceiros ou uma integração personalizada. Se você não precisar de provisionamento SCIM, pule para **Configurar as opções de nome e login do SSO** abaixo. #### Ative o SCIM no Document360 1. Ative a opção **Ativar provisão SCIM** . ![Instructions for enabling SCIM provisioning in Document360 for user synchronization.](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/saml-adfs-scim.png) 1. Um diálogo de confirmação aparece. Revise os termos, selecione a caixa de seleção e clique **em Concordar**. 2. Os parâmetros necessários para completar a configuração SCIM serão então exibidos. NOTA O provisionamento SCIM no ADFS pode ser habilitado usando ferramentas de terceiros ou integrações personalizadas apenas. O ADFS não suporta provisionamento SCIM nativamente. 1. Insira os parâmetros necessários do Document360 nos campos correspondentes do seu aplicativo personalizado. #### Atribuir função padrão e grupos no Document360 1. No campo **de função padrão** , a função está definida como **Contribuinte** por padrão. Você pode mudar isso a partir do menu suspenso, se necessário. 2. Nos **campos de grupos de usuários** e **grupos de leitores** , selecione os grupos que deseja adicionar. Vários grupos podem ser adicionados, e eles herdarão o papel padrão que você selecionou anteriormente. 3. Clique **em Próximo** para continuar. #### Configurar o nome do SSO e as opções de login 1. No campo **do nome do SSO** , insira um nome para a configuração do SSO. 2. No **texto do botão de login**, insira o texto para o botão de login exibido aos usuários. 3. **Atribuir automaticamente grupo de leitores** — essa opção está disponível apenas para configurações SSO existentes. Para configurações de SSO recém-criadas, essa opção não será exibida, pois o SCIM fornece automaticamente usuários e grupos. Saiba mais sobre o [grupo de leitores de atribuição automática](https://docs.document360.com/docs/pt/auto-assign-reader-group). 4. Ative **o timeout SSO da sessão ociosa** se necessário e defina a **duração do tempo limite (HH:MM).** ![Settings for creating a new SSO, including name and login button customization options.](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/Configure-Okta-more-settings.png) 1. Clique **em Criar** para completar a configuração SAML SSO. --- ## Gerenciando usuários no ADFS Para ver leitores adicionados pela sua integração ADFS: ![Overview of reader management settings, highlighting user accounts and permissions synchronization.](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/readers.png) 1. No Document360, navegue até **Configurações** () > **Usuários e permissões** > **Leitores & grupos**. 2. Selecione o leitor para navegar até o perfil dele. Leitores provisionados via SCIM exibirão um crachá **SSO-SCIM** ao lado do nome. NOTA Quando o SCIM está ativado, editar o nome de um usuário ou excluir um usuário diretamente no Document360 é desativado, pois essas ações precisam ser gerenciadas pelo seu IdP para manter as duas plataformas sincronizadas. Você só pode gerenciar o acesso ao conteúdo pelo Document360. Deletar um perfil no seu IdP não o remove do Document360 — o perfil permanecerá com status Inativo. ### Gerenciar o acesso ao conteúdo de leitores, usuários e grupos O papel padrão de conteúdo atribuído a qualquer novo usuário, leitor ou grupo é baseado no que foi configurado durante a configuração do provisionamento SCIM. As permissões serão definidas como **Nenhuma** por padrão, mas podem ser atualizadas a qualquer momento. 1. Selecione o leitor desejado e clique **em Gerenciar Acesso ao Conteúdo**. 2. Escolha o nível de acesso desejado no menu suspenso e clique **em Atualizar**. ![Editing reader account settings, including content access and associated groups options.](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/manage.png) NOTA Você também pode gerenciar grupos para um leitor clicando **em Gerenciar grupos** na seção Grupos de Leitores. --- ## Melhores práticas - **Exporte o certificado no formato codificado Base-64 (. CER).** O formato padrão codificado em DER do ADFS não é suportado pelo Document360. Sempre selecione codificação Base-64 ao exportar o certificado X.509. - **Use uma ferramenta de terceiros para SCIM.** O ADFS não suporta provisionamento SCIM nativamente. Planeje sua abordagem de provisionamento do usuário antes de ativar o SCIM no Document360. - **Configure cuidadosamente as regras de reivindicação.** Garanta que os três mapeamentos de atributos LDAP (ID do Nome, Endereços de E-mail e Nome) estejam configurados corretamente. Reivindicações ausentes ou incorretas causarão falhas na autenticação. - **Teste primeiro com um único usuário.** Antes de implantar o SSO para todos os usuários, teste a configuração com um usuário para verificar se as regras de reivindicação, certificados e URLs estão funcionando corretamente. --- ## FAQ **Por que o SCIM não é suportado nativamente no ADFS?** ADFS é um serviço de federação local construído sobre os protocolos SAML e WS-Federation. Não inclui um endpoint SCIM embutido. Para usar SCIM com ADFS no Document360, você precisa de uma ferramenta de provisionamento de terceiros ou de uma integração personalizada que conecte o ADFS ao protocolo SCIM. **Qual formato de certificado o Document360 exige para o ADFS?** O Document360 requer o certificado X.509 no formato **codificado Base-64 (. CER** ). Ao exportar do ADFS, certifique-se de selecionar esse formato. O formato padrão codificado em DER não é suportado. **O que acontece com o perfil de um usuário no Document360 se eu o excluir no ADFS?** Excluir um perfil de usuário no seu IdP não o remove do Document360. O perfil permanecerá no Document360 com status Inativo.