--- title: "Entra com SAML SSO" slug: "saml-sso-with-entra" description: "You can configure Document360's SAML Single Sign-On (SSO) with the Azure Active directory (Azure AD) as the Identity provider." updated: 2026-10-12T08:21:03Z published: 2026-10-12T08:21:03Z canonical: "docs.document360.com/saml-sso-with-entra" --- > ## 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. # Entra com SAML SSO **Microsoft Entra ID** é o serviço de gerenciamento de identidade e acesso baseado em nuvem da Microsoft, anteriormente conhecido como Azure Active Directory. Com o SAML SSO configurado entre Microsoft Entra e Document360, seus usuários e leitores podem fazer login no Document360 usando suas credenciais Microsoft existentes, sem precisar de uma senha separada. 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 Microsoft Entra como seu IDP | Capacidade | Apoiado | | --- | --- | | Autenticação do usuário (portal) | Sim | | Autenticação do leitor (site da base de conhecimento) | Sim | | Login iniciado pelo IdP | Sim | | Provisão de usuários SCIM | Sim | | Provisão de leitores SCIM | Sim | | Sincronização de grupo SCIM | Sim | | Herança de configuração SSO (projetos pai-filho) | Sim | --- ## Antes de começar - Você tem uma conta ativa do Microsoft Azure com acesso de administrador. Faça login no [entra.microsoft.com](https://entra.microsoft.com/#home). - Você tem acesso **de Proprietário** ou **Administrador** no seu projeto Document360. - Abra o Document360 e o Microsoft Entra em duas abas separadas do navegador. Você precisará alternar entre elas várias vezes durante a configuração. --- ## Passo 1: Criar uma aplicação SAML no Microsoft Entra #### Faça login no Microsoft Entra 1. Faça login na sua conta Microsoft Azure no [entra.microsoft.com](https://entra.microsoft.com/#home). 2. Você será direcionado para a página **do centro de administração do Microsoft Entra** . #### Crie a aplicação 1. No **centro de administração do Microsoft Entra**, selecione **ID Entra** na barra de navegação da esquerda e clique **em aplicativos empresariais**. 2. Na página **de aplicações empresariais** , clique em **Nova aplicação** > **Criar sua própria aplicação**. 3. Insira o nome da sua aplicação no campo **Nome de Entrada** e clique **em Criar**. ![Creating a new application in Microsoft Entra admin center](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/creating application.gif) NOTA Ao criar o aplicativo, certifique-se de selecionar **Criar seu próprio aplicativo** e escolha **Integrar qualquer outro aplicativo que não encontrar no botão de opção da galeria** . Não selecione um aplicativo Galeria nem pesquise por Document360 na Galeria Entra. Aplicativos de galeria não suportam provisão SCIM personalizada. Se um aplicativo Galeria já estiver configurado, você precisará criar um novo aplicativo que não seja Galeria e reconfigurar sua configuração SSO. --- ## Passo 2: Configure SAML no Entra usando parâmetros do Document360 #### Obtenha os parâmetros do Provedor de Serviço 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** > **SAML**. ![User management interface showing SSO configuration options and settings for Azure AD.](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/SSO-configurations.png) 1. Selecione **o Entra ID** como seu Provedor de Identidade (IdP) para navegar automaticamente até a etapa **Configurar SP** . ![Select an Identity Provider for Single Sign-On configuration options and settings.](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/SAML-create-sso-step-1.png) 1. A etapa **Configurar SP** exibe os parâmetros necessários para configurar sua integração SAML no Provedor de Identidade. ![Configuration settings for Entra ID with highlighted callback paths and service provider entity ID.](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/saml-entra-sp.png) #### Configure SAML no Entra 1. Vá para o Microsoft Entra e, na página da aplicação criada, abra a **aba de Login Único** e selecione método **SAML** . ![Select a single sign-on method, highlighting SAML for secure authentication options.](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/saml method.png) 1. Clique **em Editar** na seção **Configuração Básica de SAML** e insira os parâmetros do Document360 conforme mostrado abaixo. | Entra | Document360 | | --- | --- | | URL de resposta (URL do Serviço ao Consumidor de Asserção) | Caminho de retorno | | URL de login | Caminho de retorno | | Identificador (ID da Entidade) | ID da entidade do provedor de serviço | ![Basic SAML configuration settings for Document360 SCIM SSO in Microsoft Entra admin center.](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/saml config.png) 1. Clique **em Salvar**. --- ## Passo 3: Complete a configuração do SSO no Document360 #### Configure o Provedor de Identidade no Document360 1. Volte ao Document360 e clique em **Próximo** para navegar até a etapa **Configurar IdP** . 2. Se você já tem uma configuração SSO existente, pode selecioná-la no **menu suspenso Configurar uma conexão existente** para herdar suas configurações. Isso elimina configurações redundantes e economiza tempo. NOTA Para mais informações sobre herança, [veja Gerenciar usuários e leitores com SCIM no Entra](https://docs.document360.com/docs/pt/scim-with-entra#inherit-from-another-application). ![Configuration settings for creating a new SSO with highlighted fields and options.](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/saml-entra-idp.png) 1. Preencha os campos necessários usando os parâmetros encontrados na seção **Set Up Document360 SCIM SSO** da página do Entra, conforme mostrado abaixo. | Entra | Document360 | | --- | --- | | Login URL | URL de login | | Identificador Microsoft Entra | ID da Entidade | | Certificado SAML | Certificado (Base64) | 1. Baixe o **Certificado (Base64)** na seção **de Certificados SAML** e anexe-o ao campo **de certificado SAML** no Document360. ![Document360 SCIM SSO settings with highlighted certificate download options and URLs.](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/certificate.png) 1. Ative ou desative a opção **Permitir login iniciado por IdP** , dependendo das necessidades do seu projeto. Saiba mais sobre [o login iniciado por IdP](https://docs.document360.com/docs/pt/saml#idpinitiated-signin). 2. Clique **em Próximo** para prosseguir até a página **de provisionamento SCIM** . --- ## Passo 4: Configurar o provisionamento SCIM O provisionamento SCIM automatiza o gerenciamento do ciclo de vida do usuário e do leitor entre Microsoft Entra e Document360. Quando ativado, usuários adicionados, atualizados ou desativados no Entra são automaticamente sincronizados com o Document360. Se você não precisar de provisionamento SCIM, clique **em Próximo** e avance para **Configurar as opções de nome e login do SSO** abaixo. #### Ative o SCIM no Document360 1. Na página **de provisão SCIM** no Document360, ative a **opção Ativar provisão SCIM** . 2. Um diálogo de confirmação será exibido. Leia os termos e clique **em Aceitar**. Um conjunto de parâmetros será então exibido. ![Configuration settings for SCIM provisioning and identity provider setup in a user interface.](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/saml-entra-scim.png) ATENÇÃO Os tokens secretos primário e secundário são gerados uma vez e exibidos apenas no momento da criação. Certifique-se de copiá-los e armazená-los em um local seguro antes de salvar a configuração. Uma vez que a configuração SSO seja salva, os tokens aparecerão mascarados e não poderão ser recuperados. A regeneração de um token invalida o existente e exige que você atualize o novo token na configuração do Entra para evitar interromper a sincronização do usuário. #### Configure o provisionamento SCIM no Entra 1. Vá até Entra, selecione a aba **Provisionamento** no menu esquerdo e depois **selecione Nova configuração** no menu superior. ![Overview page of Document360 SCIM SSO with configuration options and application provisioning details.](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/new config.png) 1. A **página de configuração do novo provisionamento** será exibida. Preencha os campos na seção **de credenciais de administrador** usando os parâmetros do Document360 conforme mostrado abaixo. | Entra | Document360 | | --- | --- | | URL do locatário | SCIM Base URL | | Token secreto | Token secreto primário | NOTA Não clique em **Testar conexão** ou **Criar** neste estágio. A configuração SSO no Document360 deve ser concluída primeiro antes que a conexão de provisionamento SCIM possa ser estabelecida com sucesso. ![Configuration settings for Document360 SCIM SSO with highlighted tenant URL and secret token.](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/tenant url.png) #### Defina papéis e grupos padrão no Document360 1. Navegue de volta para o Document360 e ative a **opção Ativar sincronização de grupos** . Quando ativado, usuários e grupos de leitores são automaticamente atribuídos com base nos mapeamentos de grupos IdP. 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. NOTA O papel padrão se aplica apenas a **Usuários** . Não afeta usuários provisionados como Leitores provisionados via `userType = "reader"` ou o mapeamento de atributos legado `isTeamAccount = False` . Revisores provisionados via `userType = "reviewer"` não são afetados por esse padrão. Para informações sobre mapeamento de atributos, [veja Gerenciar usuários e leitores com SCIM no Entra](https://docs.document360.com/docs/pt/scim-with-entra#assign-attribute-mapping). 1. 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. 2. Clique **em Próximo** para continuar. NOTA Para detalhes completos sobre o gerenciamento de usuários, leitores e grupos via SCIM, incluindo mapeamento de atributos, fluxos de trabalho de provisionamento e desprovisionamento, [veja Gerenciar usuários e leitores com SCIM no Entra](https://docs.document360.com/docs/pt/scim-with-entra). #### 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 de 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).** 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/Configure-Okta-more-settings.png) 1. Clique **em Criar** para completar a configuração do SSO. A configuração do SSO Empresarial no Document360 é criada com sucesso. --- ## Passo 5: Complete o provisionamento SCIM na Entra #### Teste e salve a conexão SCIM 1. Navegue de volta para o Entra, onde a página **de configuração de novo provisionamento** está exibida. 2. Depois que todos os campos necessários forem preenchidos, clique **em Testar conexão** para verificar a configuração. ![Configuration settings for Document360 SCIM SSO with tenant URL and secret token fields.](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/test connection(1).png) 1. Uma mensagem de confirmação aparecerá assim que a conexão de provisionamento SCIM entre Entra e Document360 for bem-sucedida. 2. Clique **em Criar** para finalizar a configuração. O provisionamento SCIM entre Entra e Document360 foi criado com sucesso. NOTA Para mais detalhes sobre como gerenciar usuários, leitores e grupos no Entra, veja [Gerenciar usuários e leitores com SCIM no Entra](https://docs.document360.com/docs/pt/scim-with-entra). --- ## Melhores práticas - **Crie um aplicativo que não seja Galeria.** Sempre use a opção **Integrar qualquer outro aplicativo que você não encontrar na galeria** ao criar seu aplicativo Entra. Aplicativos de galeria não suportam provisão SCIM personalizada. - **Armazene ambos os tokens secretos de forma segura.** Trate os tokens SCIM primários e secundários como senhas. Armazene-os em um gerenciador de segredos ou cofre de senhas, não em arquivos de texto simples ou repositórios de código. - **Não teste a conexão SCIM antes de salvar a configuração do Document360.** O teste falhará nessa etapa. Sempre complete e salve a configuração SSO do Document360 primeiro, depois volte ao Entra para testar. - **Defina o mapeamento de atributos no nível do usuário, não no nível do grupo.** Ao configurar o `userType` atributo ou `isTeamAccount` , sempre defina-o no nível do usuário para evitar conflitos de provisão para usuários que pertencem a múltiplos grupos. - **Alinhe o timeout ocioso com sua política de segurança.** Ative **o Logout do usuário ocioso do SSO** e defina a duração para corresponder aos requisitos de gerenciamento de sessões da sua organização. --- ## FAQ **Por que preciso usar um aplicativo que não seja da Galeria em vez de procurar por Document360 na Galeria Entra?** Aplicativos de galeria no Entra não suportam provisão SCIM personalizada. Para habilitar o SCIM entre Entra e Document360, você deve criar um aplicativo que não seja de galeria selecionando **Criar seu próprio aplicativo** e **Integrar qualquer outro aplicativo que não encontrar na galeria**. Se um aplicativo de galeria já estiver configurado, você precisará criar um novo aplicativo que não seja de galeria e reconfigurar sua configuração de SSO. **O que acontece com os usuários existentes do Document360 quando configuro SSO?** Usuários existentes não são convertidos automaticamente. Como parte da configuração de nomes e opções de login do SSO, você pode optar por convidar contas de usuários e leitores existentes para o SSO. Usuários convertidos mantêm todos os seus papéis e permissões existentes.