--- title: "OneLogin com SAML SSO" slug: "saml-sso-with-onelogin" updated: 2026-10-12T08:21:03Z published: 2026-10-12T08:21:03Z canonical: "docs.document360.com/saml-sso-with-onelogin" --- > ## 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. # OneLogin com SAML SSO **O OneLogin** é um Provedor de Identidade (IdP) que simplifica o gerenciamento de acesso do usuário ao permitir que eles façam login em múltiplos aplicativos com um único conjunto de credenciais. Com o SSO SAML configurado entre o OneLogin e o Document360, seus membros da equipe e leitores podem acessar o Document360 usando suas credenciais OneLogin existentes. 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 OneLogin 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 de leitores SCIM | Sim | | Provisão de usuários SCIM | Não | | Mapeamento de grupos SCIM | Não | | Herança de configuração SSO (projetos pai-filho) | Sim | NOTA Atributos de usuário e mapeamento de grupos não são suportados no OneLogin. Apenas leitores podem ser gerenciados via SCIM a partir do OneLogin. Usuários e grupos não podem ser adicionados a partir do OneLogin. --- ## Antes de começar - Você tem uma conta OneLogin ativa com acesso de administrador. - Você tem acesso **de Proprietário** ou **Administrador** no seu projeto Document360. - Abra o Document360 e o OneLogin em duas abas separadas do navegador. Você precisará alternar entre elas várias vezes durante a configuração. --- ## Passo 1: Inicie a configuração do SSO no Document360 #### Criar SSO no Document360 1. No Document360, navegue até **Configurações** () > **Usuários e permissões** > **SSO Empresarial**. 2. Clique **em Criar SSO** > **SAML**. ![SSO configuration and user permissions settings.](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/SSO-configurations.png) 1. Selecione **OneLogin** como seu provedor de identidade na etapa **Escolher IdP** . ![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) --- ## Passo 2: Criar uma aplicação SAML no OneLogin #### Adicione o SCIM Provisioner com o app SAML 1. Faça login no seu Portal de Administração OneLogin. 2. No menu superior, selecione **Aplicações**. 3. Clique **em Adicionar App**. ![OneLogin applications page showing options to add an app and download JSON.](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/add app.png) 1. Na barra de busca, digite **SCIM** e selecione **SCIM Provisioner com SAML (SCIM v2 Enterprise, SCIM2 PATCH for Groups)** na lista e clique **em Salvar**. #### Baixe o certificado X.509 1. No seu aplicativo OneLogin, navegue até a aba **SSO** . 2. Clique **em Ver Detalhes** para baixar o certificado X.509. ![Configuration settings for SAML2.0 with highlighted SSO and View Details options.](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/view details(1).png) NOTA Guarde este arquivo de certificado. Você precisará enviá-lo depois ao configurar o Document360 com o OneLogin. --- ## Passo 3: Configure o Provedor de Serviço no OneLogin #### Copie os parâmetros do SP do Document360 e insira o OneLogin 1. No Document360, vá na etapa **Configurar SP** e copie os parâmetros que você precisa. ![Configuration settings for OneLogin service provider with highlighted callback paths.](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/saml-onelogin-sp.png) 1. Vá para OneLogin e navegue até a aba **Configuração** . Insira os parâmetros do Document360 usando o mapeamento abaixo. | OneLogin | Document360 | | --- | --- | | URL da Audiência SAML | ID da entidade do provedor de serviço | | URL de Consumidor SAML | Caminho de retorno | ![Configuration settings for SCIM Provisioner with SAML, including audience and consumer URLs.](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/configuration(1).png) --- ## Passo 4: Complete a configuração do SSO no Document360 #### Configure o Provedor de Identidade no Document360 1. No OneLogin, navegue até a aba **SSO** e copie os parâmetros exibidos lá. ![Configuration settings for SCIM Provisioner with SAML, including issuer and endpoint URLs.](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/configure idp(1).png) 1. No Document360, clique **em Próximo** para ir ao **passo Configurar IdP** . 2. No **campo Configurar uma conexão existente** , você pode herdar de uma configuração SSO já criada que tenha o SCIM ativado em um projeto pai. Ao selecionar e herdar essa conexão, a configuração atual do SSO será definida como a configuração SSO herdada pelo filho e herdará automaticamente a configuração SCIM do pai. NOTA Para mais informações sobre herança, [veja Herdar de outra aplicação](/docs/pt/saml-sso-with-onelogin#inherit-from-another-application). 1. Insira os parâmetros do OneLogin no Document360 usando o mapeamento abaixo. | OneLogin | Document360 | | --- | --- | | URL do Emissor | ID da Entidade | | Endpoint SAML 2.0 (HTTP) | URL de login | | Certificado X.509 | Certificado SAML | 1. Anexe o certificado X.509 previamente baixado no campo **de certificado SAML** no Document360. 2. Ative ou desative a **opção Permitir login iniciado por IDP** de acordo com os requisitos do seu projeto. ![Configuration settings for Single Sign-On with highlighted URLs and options.](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/saml-onelogin-idp.png) 1. Clique **em Próximo** para navegar até a etapa **de provisionamento do SCIM** . --- ## Passo 5: Configurar o provisionamento SCIM O provisionamento SCIM automatiza o gerenciamento do ciclo de vida do leitor entre o OneLogin e o Document360. Quando ativado, os leitores adicionados ou desativados no OneLogin são sincronizados automaticamente 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. NOTA Atributos de usuário e mapeamento de grupos não são suportados no OneLogin SCIM. Apenas contas de leitor podem ser provisionadas via SCIM a partir do OneLogin. #### Ative o SCIM no Document360 1. Ative a opção **Ativar provisão SCIM** . ![Settings for enabling SCIM provisioning in OneLogin configuration interface.](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/saml-onelogin-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 no OneLogin serão então exibidos. #### Configure SCIM no OneLogin 1. No OneLogin, navegue até a aba **Configuração** e role para baixo até a seção **de Conexão da API** . 2. Insira os parâmetros do Document360 usando o mapeamento abaixo. | Document360 | OneLogin | | --- | --- | | SCIM Base URL | SCIM Base URL | | Token secreto primário | Token Portador SCIM | ![Configuration settings for SCIM Provisioner with SAML in OneLogin interface.](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/token.png) 1. Clique **em Habilitar** para ativar o provisionamento SCIM no OneLogin. 2. Clique **em Salvar** para criar com sucesso o aplicativo SAML com SCIM ativado. ![Configuration settings for SCIM Provisioner with options to enable API connection.](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/enable.png) #### Habilitar o provisionamento SCIM no OneLogin 1. No OneLogin, vá para a aba **Provisão** . 2. Selecione a caixa **de seleção Habilitar provisionamento** e clique **em Salvar**. ![OneLogin provisioning settings with options to enable and manage user actions.](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/enable workflow.png) O SCIM Provisioner com aplicação SAML foi criado com sucesso. NOTA Na página de provisionamento, você pode gerenciar os usuários realizando as seguintes ações: Criar usuário, Excluir usuário, Atualizar usuário. Você também pode personalizar essas ações ainda mais usando as opções suspensas disponíveis. #### Atribuir função padrão e grupos no Document360 1. Navegue de volta para o Document360. 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. ![Configuration settings for SCIM provisioning with highlighted tokens and roles.](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/saml-onelogin-scim-group.png) 1. 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).** 5. Escolha se convida **Todos os usuários** ou **apenas usuários selecionados** para SSO usando os botões de rádio. ![Settings for creating a new SSO with options for users and customization.](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. SAML SSO com SCIM foi configurado com sucesso. Agora você pode gerenciar leitores diretamente do seu OneLogin IdP. --- ## Herdar de outra aplicação Ao criar uma nova configuração de SSO no Document360, você pode herdar as configurações SCIM de uma conexão SSO existente. Isso simplifica o processo de configuração, evita repetições de etapas de configuração e ajuda os administradores a economizar tempo, garantindo consistência entre integrações. ### Configuração SSO herdada por filho Na página **Configurar IdP** , selecione o campo **Configurar uma conexão existente** e escolha o aplicativo pai habilitado para SSO SCIM do qual você deseja herdar. Selecionar essa opção designa o projeto atual como o projeto filho, herdando todas as propriedades relevantes do pai. NOTA Uma vez criada a configuração SSO, as configurações de provisionamento SCIM serão herdadas do aplicativo pai e não poderão ser modificadas no aplicativo filho. ### Configuração SSO herdada pelo pai A aplicação mãe exibirá uma lista de todos os projetos que herdaram sua configuração. Quaisquer alterações feitas na aplicação mãe serão automaticamente refletidas na aplicação filha. - Se o SCIM for ativado no projeto pai depois que projetos filhos já o herdaram, os usuários e grupos serão automaticamente provisionados para todos os projetos filhos em segundo plano. - Habilitar a herança facilita o gerenciamento de múltiplas configurações de SSO com o SCIM ativado, já que todas as configurações são controladas a partir de um único aplicativo pai. Isso economiza tempo e reduz o esforço necessário para gerenciar cada configuração individualmente. --- ## Gerenciando o Document360 com o OneLogin Depois de configurar com sucesso o aplicativo SAML com SCIM no Document360 usando o OneLogin, você pode gerenciar os leitores diretamente do OneLogin, com todas as alterações refletidas automaticamente no Document360. ### Adicione um leitor 1. No menu superior do OneLogin, expanda o menu **suspenso Usuários** e selecione **Usuários**. 2. Clique **em Novo Usuário**, insira os dados necessários do usuário e clique **em Salvar**. ![User management interface displaying user details and options for adding new users.](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/users.png) Um novo usuário agora é criado com sucesso. #### Atribuir aplicação ao usuário 1. Após criar o usuário, vá em **Aplicativo** no menu esquerdo. 2. Clique no ícone **+** no canto superior direito para adicionar uma aplicação. 3. Selecione a aplicação com SAML providenciado pelo SCIM ativado e clique **em Continuar**. ![Assigning a new login to a user with application selection options displayed.](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/add app to user.png) 1. Insira o endereço de e-mail do usuário no campo **do nome de usuário SCIM** e clique **em Salvar**. O usuário agora é atribuído com sucesso à aplicação. #### Aprovar status de usuário 1. No menu superior do OneLogin, clique **em Aplicações** e selecione **Aplicações**. 2. Escolha o aplicativo SAML provisionado por SCIM e abra a **aba Usuários** . 3. Clique no status do usuário, que aparece como **Pendente**, e então selecione **Aprovar** no diálogo de confirmação. ![User provisioning status in the application interface.](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/pending.png) O usuário agora é aprovado e adicionado com sucesso ao Document360. ### Verificar no Document360 Para verificar se o usuário foi adicionado com sucesso ao Document360: 1. No Document360, navegue até **Configurações () > Usuários e permissões > Leitores e grupos**. ![User management interface displaying reader accounts and their access details.](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/readers and groups(1).png) O leitor é adicionado automaticamente no Document360. O selo **SSO-SCIM** ao lado do nome indica que o SCIM está ativado. NOTA Atributos de usuário e mapeamento de grupos não são suportados no OneLogin. Você só pode gerenciar leitores via SCIM. Usuários e grupos não podem ser adicionados pelo OneLogin. ### Gerencie usuários no Document360 Quando o SCIM está ativado, editar o nome de um usuário ou excluir um usuário diretamente no Document360 é desativado. Essas ações devem ser gerenciadas pelo seu IdP para manter ambas as plataformas sincronizadas. ![Overview of reader management settings and user access in Document360 platform.](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/badge(2).png) No entanto, você ainda pode gerenciar o acesso ao conteúdo dentro do Document360. #### Gerencie o acesso ao conteúdo 1. No Document360, navegue até **Configurações** () > **Usuários e permissões** > **Leitores & grupos**. 2. Selecione o usuário desejado e clique **em Gerenciar acesso ao conteúdo**. 3. Atribua o nível **de acesso ao conteúdo** 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 content access.png) O acesso ao conteúdo agora é atribuído com sucesso ao usuário. ### Excluir um usuário 1. No menu superior do OneLogin, clique **em Usuários** e selecione o usuário que deseja excluir. 2. Expanda o menu **suspenso Mais Ações** e clique **em Deletar**. ![User management interface showing user details and delete action option.](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/delete(2).png) 1. No diálogo de confirmação, clique **em Excluir** novamente. O usuário foi deletado com sucesso e não aparecerá mais no OneLogin. NOTA Quando você exclui um usuário no OneLogin, ele não será removido do Document360. Em vez disso, o status do usuário mudará de Ativo para Inativo. --- ## Melhores práticas - **Use o app SCIM correto no OneLogin.** Procure e selecione **SCIM Provisioner com SAML (SCIM v2 Enterprise, SCIM2 PATCH for Groups)** especificamente. Usar um app diferente não funcionará com o Document360. - **Gerencie apenas leitores através do OneLogin SCIM.** Atributos de usuário e mapeamento de grupos não são suportados. Planeje seu fluxo de trabalho de gerenciamento de usuários de acordo. - **Aprove usuários provisionados rapidamente.** Usuários adicionados no OneLogin aparecem no Document360 com o status Pendente. Aprove-os no OneLogin para ativar o acesso. - **Não exclua usuários no Document360 quando o SCIM estiver ativado.** Deletar um usuário diretamente no Document360 é desativado quando o SCIM está ativo. Gerencie exclusões do OneLogin. Note que usuários excluídos no OneLogin tornam-se Inativos no Document360, não deletados. - **Use a herança para configurações de múltiplos projetos.** Se você tem vários projetos do Document360 que compartilham a mesma configuração de SSO, use a herança pai-filho para gerenciar todas as configurações em um só lugar. --- ## FAQ **Por que não posso adicionar usuários e grupos pelo OneLogin?** Atributos de usuário e mapeamento de grupos não são suportados na integração SCIM do OneLogin com o Document360. Apenas contas de leitor podem ser provisionadas via SCIM a partir do OneLogin. Se você precisar gerenciar usuários e grupos via SCIM, considere usar o Okta ou o Microsoft Entra como seu provedor de identidade. **O que acontece quando eu excluo um usuário no OneLogin?** Quando você exclui um usuário no OneLogin, o usuário não é removido do Document360. Em vez disso, o status dele muda de Ativo para Inativo no Document360. **Posso herdar configurações SCIM de um projeto pai?** Sim. Ao criar uma nova configuração de SSO no Document360, você pode selecionar uma configuração SSO já habilitada para SCIM como pai. O projeto atual herdará todas as configurações relevantes. Uma vez criadas, as configurações SCIM herdadas não podem ser modificadas no aplicativo filho.