--- title: "ADFS com OpenID SSO" slug: "adfs-with-openid-sso" updated: 2026-10-12T08:21:03Z published: 2026-10-12T08:21:03Z canonical: "docs.document360.com/adfs-with-openid-sso" --- > ## 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 OpenID 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 OpenID Connect SSO configurado entre ADFS e Document360, seus usuários 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 do usuário (portal) | Sim | | Autenticação do leitor (site da base de conhecimento) | Sim | | Provisão SCIM | Sim (apenas por ferramentas de terceiros ou integrações personalizadas) | | Herança de configuração SSO (projetos pai-filho) | Sim | --- ## 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 antes de começar. --- ## Como configurar o SDO do OpenID do ADFS no Document360 ### Passo 1: 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 OpenID 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). --- ### Passo 2: Obtenha os parâmetros SP do 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** > **OpenID Conectar**. ![Settings page displaying SSO configuration options and user permissions for identity providers.](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/SSO-configurations.png) 1. Selecione **o ADFS** como seu provedor de identidade para navegar automaticamente até a etapa **Configurar SP** . ![Select an Identity Provider for SSO configuration, highlighting ADFS option prominently.](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/oidc-okta.png) 1. Na **etapa Configurar SP** , um conjunto de parâmetros será exibido. ![Configuration settings for OpenID in the Service Provider setup for SSO.](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/oidc-adfs-sp.png) --- ### Passo 3: Insira os parâmetros do Document360 no ADFS 1. Vá para a aba do console de gerenciamento do ADFS e insira os parâmetros do Document360 nos campos correspondentes na etapa **Configurar URL** usando o mapeamento abaixo. | ADFS | Document360 | | --- | --- | | Confiando no Identificador da Parte | Nome do subdomínio | | URL de Login | URL de redirecionamento de login | | URL de Encerramento | URL de redirecionamento para sair de sessão | 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 4: Adicionar regras de reivindicação no ADFS 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**: 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 5: Configure o Provedor de Identidade no Document360 1. Retorne ao Document360 na **etapa Configurar SP** e clique em **Próximo** para navegar até a etapa **Configurar IdP** . 2. Insira os valores correspondentes da sua configuração ADFS usando o mapeamento abaixo. | ADFS | Document360 | | --- | --- | | Identificador do Cliente (ID do Cliente) | ID do cliente | | Segredo do Cliente | Segredo do Cliente | | URL do Emissor | Autoridade (URL de Autorização ou Endpoint) | NOTA Certifique-se de que o **ID do Cliente** no Document360 corresponda ao **Identificador de Parte Confiável** configurado no ADFS. 1. No campo **de escopo adicional** (opcional), digite um valor de escopo e clique **em +** para adicioná-lo como um chip. Isso define quais informações de usuário ou permissões o Document360 solicita do ADFS. Você pode adicionar até 3 escopos. ![Configure the Identity Provider page for ADFS OpenID Connect in Document360.](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/oidc-adfs-idp.png) 1. Clique **em Próximo** para prosseguir para a etapa de **provisionamento do SCIM** . --- ### Passo 6: 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. 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/oidc-adfs-scim.png) 1. 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. 2. 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. 3. 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. 4. Clique **em Próximo** para continuar. #### Configurar o nome do SSO e as opções de login #### 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. [**Atribuição automática de grupo de leitor**](https://docs.document360.com/docs/pt/auto-assign-reader-group): Esta 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 automaticamente fornece usuários e grupos. 4. Ative **o timeout SSO da sessão ociosa** se necessário e defina a **duração do tempo limite (HH:MM).** 5. Escolha se convida contas de usuários e leitores existentes para o SSO. ![Settings for creating a new SSO, including name and login button customization options.](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/oidc-more-settings.png) 1. Clique **em Criar** para completar a configuração do OpenID SSO. A configuração SSO usando ADFS e o protocolo OpenID Connect agora está ativa no Document360. --- ## 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 e 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) --- ## Melhores práticas - **Verifique se o ID do Cliente corresponde ao Identificador da Parte Confiável.** O ID do Cliente inserido no Document360 deve corresponder exatamente ao Identificador da Parte Confiável configurado no ADFS. Uma incompatibilidade causará falhas na autenticação. - **Use o tipo correto de reivindicação de saída para e-mail.** Para o OpenID Connect ADFS, o tipo de reivindicação de saída para e-mail é **E-mail**, não Endereços de E-mail usados na configuração em SAML. Usar o tipo de reivindicação errado causará erros de identidade de usuário. - **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. - **Gire os segredos do cliente antes do vencimento.** O segredo do cliente configurado no ADFS tem data de expiração. Quando expirar, a autenticação SSO falhará. Monitore o vencimento e rotative os segredos com antecedência. --- ## 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. **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. **Como o mapeamento de regras de reivindicação do ADFS OpenID é diferente do mapeamento de regras de reivindicação em SAML?** O mapeamento de regras de reivindicação para o OpenID Connect ADFS usa **Email** como tipo de reivindicação de saída para endereços de e-mail, enquanto a configuração SAML usa **Endereços de E-mail**. Certifique-se de usar o tipo de reivindicação correto para o protocolo que você estiver configurando.