--- title: "Configure SAML SSO com Okta" slug: "saml-sso-with-okta" updated: 2026-10-12T08:21:03Z published: 2026-10-12T08:21:03Z canonical: "docs.document360.com/saml-sso-with-okta" --- > ## 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. # Configure SAML SSO com Okta Conecte o Okta ao Document360 via SAML para que seus usuários e leitores façam login no Document360 com suas credenciais Okta em vez de uma senha separada. A configuração inclui provisionamento SCIM opcional para manter usuários e leitores sincronizados automaticamente. Com Okta e SAML, você pode: - Permita que os usuários façam login no portal da base de conhecimento e leitores acessem o site da base de conhecimentos. - Permita que as pessoas façam login diretamente pelo painel da Okta. - Adicione, atualize e desative usuários e leitores no Okta, e sincronize os grupos do Okta com o SCIM. - Reutilize configurações SCIM de uma configuração SSO em um projeto pai. --- ## Antes de começar - Você precisa de uma conta Okta com acesso de administrador. Se não tiver uma, [cadastre-se no Okta](https://developer.okta.com/signup/). - Você precisa do cargo de Proprietário ou Administrador no seu projeto Document360. - Abra o Document360 e o Okta em duas abas do navegador. Você vai alternar entre elas durante a configuração. - Se você planeja configurar o SCIM, tenha um local seguro preparado, como um gerenciador de senhas, para armazenar dois tokens secretos. AVISO Duas escolhas nessa configuração não podem ser desfeitas: - **Provedor de identidade**: Você não pode alterar o IDP depois de criar a configuração. - **Converter contas existentes para SSO**: Usuários e leitores convertidos perdem o login com senha imediatamente e precisam fazer login pelo Okta. Cada um deles recebe um e-mail sobre a mudança. --- ## Passo 1: Inicie a configuração do SSO no Document360 1. Vá para **Configurações** () > **Usuários e permissões** > **SSO Empresarial**. 2. Selecione **Criar SSO** e depois selecione **SAML.** 3. Na etapa **Escolher IDP** , selecione **Okta**. ![The Choose IDP step showing the identity provider options.](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/SAML-create-sso-step-1.png) O **passo Configurar SP** mostra os parâmetros que você vai inserir no Okta. Mantenha essa aba aberta. ![The Configure SP step showing the callback path, service provider entity ID, and signed out callback path](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/Configure-SP-Okta.png) --- ## Passo 2: Criar o app SAML no Okta ### Criar a integração com o aplicativo 1. Faça login no Okta e depois selecione **Administrador** no canto superior direito para abrir o Console de Administrador. 2. Na navegação à esquerda, expanda **Aplicações e Recursos** e então selecione **Aplicações**. ![The Applications page in the Okta Admin Console](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/Okta-applications.png) 3. Selecione **Criar Integração com App**. 4. Selecione **SAML 2.0** e depois selecione **Próximo**. ![The Create app integration dialog with SAML 2.0 selected](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/Okta-create-app-integration.png) ### Entra em cenários gerais 1. Na aba **Configurações Gerais** , insira o nome de um **aplicativo**, como *Document360 SSO*. 2. (Opcional) Faça upload de um logo e defina a visibilidade do app. 3. Selecione **Próximo**. A aba **Configurar SAML** se abre. ![The General Settings tab for the SAML app in Okta](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/Okta-saml-general-setting.png) ### Insira os parâmetros do Document360 1. Na **aba Configurar SAML** , copie estes valores da etapa **Configure** SP do Document360: | Cópia do Document360 | Cole no Okta | | --- | --- | | **Caminho de retorno** | **URL de login único** | | **ID da entidade do provedor de serviço** | **URI de audiência (ID de Entidade SP)** | 2. Defina **o formato do ID do Nome** para **Endereço de E-Mail**. 3. Defina **o nome de usuário da Aplicação** para **E-mail**. 4. Selecione **Mostrar Configurações Avançadas**, ative **Habilitar Logout Único** e cole o **caminho de retorno de chamada Desconectado** do Document360 na **URL de Logout Único**. 5. Selecione **Próximo**. ![The Configure SAML tab in Okta with the single sign-on URL and audience URI filled in](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/Configure-okta-saml-settings.png) ### Complete a página de Feedback 1. Selecionar **: Este é um aplicativo interno que criamos**. 2. Selecione **Acabamento**. ![The Feedback page in Okta with the internal app option selected](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/configure-okta-saml-feedback.png) O Okta cria o app. ### Instruções de adicionar atributo As instruções de atributo informam ao Okta quais dados de usuário enviar para o Document360. NOTA Os nomes dos atributos são diferenciados em maiúsculas e minúsculas. Insira-os exatamente como mostrado. 1. No app, selecione a **aba Logar** e role até **as instruções de atributo**. ![The Sign On tab of the Okta app, showing the Attribute statements section](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/configure-okta-saml-sign-on.png) 2. Expanda **Mostrar configuração legada** e então selecione **Editar** ao lado de **instruções de atributo Perfil**. ![The Edit option for profile attribute statements under Show legacy configuration](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/configure-okta-saml-attribute-statements.png) 3. Adicione essas três instruções de atributo. Selecione **Adicionar Outro** para adicionar a segunda e terceira linhas. | Nome | Formato do nome | Valor | | --- | --- | --- | | `urn:oasis:names:tc:SAML:2.0:nameid` | Referência URI | `user.email` | | `name` | Não especificado | `user.email` | | `email` | Não especificado | `user.email` | 4. Selecione **Salvar**. ### Atribua pessoas ao app Apenas as pessoas designadas ao app no Okta podem fazer login no Document360 com o Okta. 1. No app, selecione a **aba Atribuições** . 2. **Selecione Atribuir**, e depois selecione **Atribuir a Pessoas** ou **Atribuir a Grupos**. 3. **Selecione Atribuir** ao lado de cada pessoa ou grupo que deve fazer login no Document360, selecione **Salvar e Voltar**, e então **selecione Pronto**. --- ## Passo 3: Insira os dados do Okta no Document360 ### Obtenha os valores de configuração no Okta Na aba **Logon-On** do app, selecione **Ver instruções de configuração SAML**. Os valores que você precisa abrem em uma nova página. ![Opening View SAML setup instructions from the Sign On tab in Okta](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/6_GIF-Okta_app_signon_setup_instructions.gif) ![The Okta SAML setup instructions page showing the sign-on URL, issuer, and X.509 certificate](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/Okta_setup_instructions_page.png) ### Complete a etapa Configurar IdP 1. Mude para a aba Document360 e depois selecione **Next** para ir para a **etapa Configurar IdP** . 2. (Opcional) Para reutilizar configurações SCIM de um projeto pai, selecione uma configuração SSO com SCIM ativado em **Configurar uma conexão existente**. Essa configuração se torna uma configuração filho e herda as configurações SCIM do pai, e a etapa **SCIM** fica bloqueada. Para saber mais, leia [Herdar de outro aplicativo](/help/docs/pt/scim-with-okta#inherit-from-another-application). 3. Copie estes valores das instruções de configuração do Okta: | Cópia do Okta | Colar no Document360 | | --- | --- | | **URL de Login Único do Provedor de Identidade** | **URL de login** | | **Emissora do Provedor de Identidade** | **ID da Entidade** | 4. Deixe **o tipo de vinculação** definido para **Httppost**, que corresponde ao padrão do Okta. 5. Baixe o **Certificado X.509** da Okta e depois faça o upload em **um certificado SAML**. Você pode enviar um arquivo PEM, CRT ou CER de até 10 MB. 6. Para permitir que as pessoas façam login pelo painel do Okta, ative **Permitir login iniciado pelo IdP**. Para saber mais, leia [Permitir que as pessoas façam login pelo seu painel de IdP](/help/docs/pt/saml#let-people-sign-in-from-your-idp-dashboard). ![The Configure IdP step in Document360 with the Okta sign-on URL, entity ID, and certificate entered](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/Configure-IdP-Okta.png) 7. Selecione **Próximo**. O passo **SCIM** abre. --- ## Passo 4: (Opcional) Configurar o provisionamento SCIM O SCIM mantém o Document360 sincronizado com o Okta: quando você adiciona, atualiza ou desativa usuários e leitores no Okta, o Document360 atualiza automaticamente. Agora você configura o SCIM nas duas abas e testa no Passo 6 após criar a configuração. Se você não precisar do SCIM, deixe **o Habilitar o provisionamento SCIM** desligado e vá para [o Passo 5](/docs/pt/saml-sso-with-okta#step-5-name-the-configuration-and-create-it). AVISO O Document360 mostra os tokens secretos primário e secundário apenas uma vez. Copie ambos e armazene-os de forma segura antes de criar a configuração. Depois disso, eles ficam mascarados e não podem ser recuperados. Se você regenerar um token, o antigo para de funcionar, e você precisa atualizá-lo no Okta para continuar sincronizando. ### Ative o SCIM no Document360 1. Na etapa **SCIM** , ative **Habilitar provisão SCIM**. ![The Enable SCIM provisioning toggle on the SCIM step in Document360](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/Configure-SCIM-Okta.png) 2. No diálogo de confirmação, revise os termos, selecione a caixa de seleção e então selecione **Concordar**. A **URL base do SCIM** e os tokens secretos primário e secundário aparecem. ![The SCIM base URL and secret tokens shown after SCIM provisioning is turned on](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/Enable%20SCIM%20provisioning.png) 3. Copie ambos os tokens secretos e armazene-os de forma segura. ### Ative o SCIM no app Okta 1. No Console de Administração do Okta, expanda **Aplicações e Recursos**, selecione **Aplicações** e então abra seu aplicativo Document360. 2. Na aba **Geral** , selecione **Editar** ao lado de **Configurações do App**. 3. Em **Provisão**, selecione **SCIM** e depois **selecione Salvar**. ![The SCIM option selected under Provisioning in the Okta app settings](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/enable_scim_provisioning.png) ### Conecte o Okta ao Document360 1. Na aba **Provisão** , selecione **Editar** ao lado de **Conexão SCIM**. ![The Edit option for the SCIM connection on the Provisioning tab in Okta](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/edit-provisioning.png) 2. Na **URL base do conector SCIM**, cole a **URL base SCIM** do Document360. 3. No **campo Identificador único para usuários**, insira `userName`. 4. Em **Ações de Provisão Suportadas**, selecione apenas **Push New Users**, **Push Profile Updates** e **Push Groups**. 5. No **modo Autenticação**, selecione **Cabeçalho HTTP**. 6. Em **HTTP Header**, cole o token secreto principal do Document360 na **Autorização**. ![The SCIM connection settings in Okta with the base URL, unique identifier, provisioning actions, and authorization header](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/scim-connection.png) 7. Selecione **Salvar**. NOTA Ainda não selecione **Configuração do Conector de Teste** . O teste falha até você criar a configuração no Document360 no Passo 5. ### Defina o papel padrão e os grupos no Document360 1. Mude para a aba Document360. Para atribuir usuários e leitores com base em seus grupos do Okta, ative **Habilitar sincronização de grupos**. 2. **No papel padrão**, mantenha **o Contribuidor** ou selecione outro papel. Esse papel se aplica apenas aos usuários. Leitores não recebem um papel. 3. Nos **grupos de usuários** e **grupos de leitores**, selecione os grupos para adicionar novos usuários e leitores. Esses grupos se aplicam independentemente de a sincronização de grupos estar ativada ou não. ![The group sync toggle, default role, and user and reader group fields on the SCIM step](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/Configure-SCIM-Okta-Group-Sync.png) 4. Selecione **Próximo**. Para aprender sobre mapeamento de atributos, provisionamento e desprovisionamento, leia [Gerenciando usuários e leitores com SCIM no Okta](/help/docs/pt/scim-with-okta). --- ## Passo 5: Nomeie a configuração e crie-a 1. No **nome SSO**, insira um nome para essa configuração. 2. No **texto do botão Login**, insira o texto do botão de login. 3. (Opcional) Para desconectar usuários após um período de inatividade, ative **o timeout SSO da sessão ociosa** e defina a **duração do tempo limite (HH:MM).** 4. Em **Converter contas existentes da equipe e leitores para SSO**, em **Enviar convite para**, selecione **Todos os usuários** ou **Usuários selecionados**. Veja o aviso [em Antes de começar](/docs/pt/saml-sso-with-okta#before-you-begin). ![The final setup step with SSO name, login button text, idle timeout, and account conversion options](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/Configure-Okta-more-settings.png) 5. **Selecione Criar**. A configuração aparece na lista **de SSO Empresarial** . Para confirmar que funciona, faça login no Document360 com uma conta Okta que você atribuiu ao app. Se você configurar o SCIM, complete o Passo 6. --- ## Passo 6: Teste a conexão SCIM no Okta Pule essa etapa se você não configurou o SCIM. 1. No Console de Administração do Okta, abra seu app Document360 e vá até a aba **Provisioning** . 2. Selecione **Editar** ao lado de **Conexão SCIM** e depois selecione **Configuração do Conector de Teste**. Um diálogo de confirmação mostra que o teste foi bem-sucedido. ![The Okta confirmation dialog showing a successful connector test and the detected provisioning features](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/test%20confirmation.png) 3. Selecione **Fechar** e depois **selecione Salvar**. O Okta não envia nenhuma alteração no Document360 até que você ative **Criar Usuários**, **Atualize Atributos de Usuário** e **desative usuários** em **Provisão** > **ao App**. Para isso, leia [Provisão Okta para o Document360](/help/docs/pt/scim-with-okta#provision-okta-to-document360). Para atribuir usuários, leitores e grupos, leia [Gerenciando usuários e leitores com SCIM no Okta](/help/docs/pt/scim-with-okta). --- ## Melhores práticas - **Teste primeiro com um grupo pequeno.** Antes de implementar o SSO para todos, faça login com algumas contas de teste para detectar mapeamento de atributos ou problemas de acesso. - **Armazene os dois tokens secretos, como senhas.** Mantenha-os em um gerenciador de senhas ou cofre secreto, nunca em arquivos de texto simples ou repositórios de código. - **Ajuste o tempo de espera à sua política de segurança.** Defina a duração do tempo de espera às regras de sessão da sua organização. --- ## FAQ **Por que existem dois tokens SCIM secretos?** Dois tokens permitem substituir um sem quebrar a sincronização. Se o token principal estiver exposto, mude o Okta para o token secundário primeiro e depois regenere o token primário. O provisionamento continua rodando enquanto você o substitui. **Posso usar o mesmo app Okta para SAML SSO e provisionamento SCIM?** Sim. Com SAML, você ativa o SCIM no mesmo app da Okta. Com o OpenID Connect, o SCIM precisa de um app separado de Token Portador OAuth do catálogo da Okta. **O que acontece com os usuários e leitores existentes do Document360 quando configuro o SSO?** Nada, a menos que você escolha converter as contas deles no Passo 5. Usuários e leitores convertidos mantêm seus papéis e permissões. Para saber como o login deles muda, veja o aviso [em Antes de começar](/docs/pt/saml-sso-with-okta#before-you-begin).