> ## Documentation Index > Fetch the complete documentation index at: https://support.legora.com/llms.txt > Use this file to discover all available pages before exploring further. # SAML SSO Guia de Integração > Configure o logon único SAML 2.0 para uma organização na autenticação global de Legora. Este artigo foi traduzido automaticamente. ## Visão geral Este guia é para administradores de TI que conectam um provedor de identidade SAML 2.0 à autenticação global de Legora. Os membros então fazem login em Legora com suas credenciais de trabalho. As mesmas etapas se aplicam quando você seleciona **SAML**, **ADFS** ou **PingFederate** em Legora. O Microsoft Entra ID na autenticação global de Legora usa OpenID Connect. Consulte [Visão geral da integração - Logon único do Entra ID](https://support.legora.com/pt-BR/integration-overview-entra-id-single-sign-on.md). > [!NOTE] > > Sua organização deve usar a autenticação global de Legora e sua função deve incluir **Gerenciar segurança de autenticação**. Consulte [Como faço para gerenciar a autenticação da minha organização?](https://support.legora.com/pt-BR/how-do-i-manage-authentication-for-my-organization.md). > > Se sua organização ainda não mudou, o suporte Legora configura o logon único (SSO). Entre em contato com [support@legora.com](mailto:support@legora.com). ## Como funciona Você cria um aplicativo SAML em seu provedor de identidade e fornece os detalhes do provedor de serviços Legora. Em seguida, você insere os detalhes do seu provedor de identidade em Legora. Essa troca é o que permite Legora confiar no login. ## Pré-requisitos Você precisa de ambos antes de começar: * Acesso de administrador ao provedor de identidade SAML 2.0 da sua organização. * **Gerencie a segurança da autenticação** na organização Legora. ## Configure a conexão Execute primeiro as etapas do provedor de identidade e depois as etapas Legora. Os valores do provedor de serviços são os mesmos para todas as organizações na autenticação global de Legora. ### Crie o aplicativo SAML Comece no console de administração do seu provedor de identidade. 1. Crie um novo aplicativo SAML 2.0 para Legora. 2. Se a organização já tiver um aplicativo Legora SAML, mantenha esse aplicativo e crie este ao lado dele. A seção de migração abaixo indica quando isso se aplica. ### Insira os detalhes do provedor de serviços de Legora Copie esses valores para o novo aplicativo. Eles não mudam por região. * **ID da entidade**, **URI de público** ou **Identificador**: `https://sso.legora.com` * **URL ACS**, **URL de logon único** ou **URL de resposta**: `https://sso.legora.com/api/oauth/saml` `https://sso.legora.com` é um serviço de login, não um site. Abrir esse endereço raiz mostra **404 Not Found** por design. Use o URL completo do ACS. Depois de criar a conexão, **ACS URL** na conexão mostra o mesmo URL de resposta. **ID da entidade** na conexão mostra o identificador do seu provedor de identidade. Insira `https://sso.legora.com` no provedor de identidade como ID da entidade Legora. Legora requer uma reivindicação `email`. `given_name` e `family_name` são recomendados. Mapeie os atributos do seu provedor de identidade para esses nomes. ### Adicione o provedor de identidade em Legora Insira os detalhes do seu provedor de identidade para que Legora possa direcionar os membros para a página de login correta. 1. No seu nome no menu, selecione **Configurações** > **Pessoas** > **Autenticação**. 2. Em **SSO**, selecione **Adicionar** e escolha **SAML**, **ADFS** ou **PingFederate**. 3. Insira um **Nome de exibição**. Os membros veem esse nome na tela de login. 4. Insira os detalhes do seu provedor de identidade. Use um destes: * **URL de metadados**: Legora busca o endpoint de login e o certificado deste endereço. Esta é a escolha habitual. * Ou insira o **ID da entidade**, o **URL do terminal de login** e o **Certificado de assinatura (PEM)** do seu provedor de identidade. 5. Selecione **Criar conexão**. Legora abre a nova conexão. **Editar** em uma conexão SAML altera apenas o nome de exibição. Para alterar os metadados, crie uma nova conexão. ### Teste e ligue a conexão Confirme a conexão antes que os membros confiem nela. 1. No seu provedor de identidade, atribua um usuário de teste ao aplicativo Legora SAML. 2. Em Legora, abra a conexão e selecione **Testar conexão**. Uma janela de login é aberta. 3. Faça login com o usuário de teste. Você deve retornar para Legora. 4. Ative o **Status** para que os membros possam fazer login com esta conexão. Se o teste falhar, compare o URL do ACS e o ID da entidade no seu provedor de identidade com os valores das etapas anteriores. Confirme também se a afirmação inclui `email`. ## Migrando para a autenticação global de Legora Use esta seção somente quando a organização já tiver um aplicativo SAML para Legora e você estiver migrando essa organização para a autenticação global de Legora. A primeira configuração é concluída depois que você ativa o **Status**. Um aplicativo SAML está vinculado ao ID da entidade do provedor de serviços. Você não pode apontar o aplicativo existente para a autenticação global de Legora. Crie um novo aplicativo SAML com os valores acima. Deixe o aplicativo existente inalterado até que a migração seja concluída. Para testar durante a migração, no seu nome no menu, selecione **Configurações** > **Pessoas** > **Migração de autenticação**. Execute o teste de conexão e confirme se aparece **Aprovado**. Legora não oferece suporte a mais de um aplicativo SAML no mesmo locatário do Microsoft Entra. Mova essas conexões para o OpenID Connect. Consulte [Visão geral da integração - Logon único do Entra ID](https://support.legora.com/pt-BR/integration-overview-entra-id-single-sign-on.md). Para URLs de retorno de chamada de integração, regras de firewall e o resto da mudança, consulte [Guia de administração de TI: autenticação global de Legora](https://support.legora.com/pt-BR/it-admin-guide-legora-s-new-authentication-protocol.md). ## Solução de problemas Comece com a afirmação e os dois URLs Legora. ### O login falha ou o usuário não é encontrado Legora requer uma reivindicação `email` e rejeita uma afirmação que marca o e-mail como não verificado. Confirme se o provedor de identidade envia `email` e se `given_name` e `family_name` usam esses nomes quando você os envia. Confirme também se o usuário de teste está atribuído ao aplicativo. ### O URL de resposta ou ID da entidade foi rejeitado O URL do ACS e o ID da entidade no seu provedor de identidade devem corresponder exatamente aos valores deste guia. Use `https://sso.legora.com` sem barra final e use o URL ACS completo `https://sso.legora.com/api/oauth/saml`. Se essas verificações não resolverem o problema, entre em contato com [support@legora.com](mailto:support@legora.com).