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.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?.Se sua organização ainda não mudou, o suporte Legora configura o logon único (SSO). Entre em contato com 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.- Crie um novo aplicativo SAML 2.0 para Legora.
- 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.- No seu nome no menu, selecione Configurações > Pessoas > Autenticação.
- Em SSO, selecione Adicionar e escolha SAML, ADFS ou PingFederate.
- Insira um Nome de exibição. Os membros veem esse nome na tela de login.
- 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.
- Selecione Criar conexão. Legora abre a nova conexão.
Teste e ligue a conexão
Confirme a conexão antes que os membros confiem nela.- No seu provedor de identidade, atribua um usuário de teste ao aplicativo Legora SAML.
- Em Legora, abra a conexão e selecione Testar conexão. Uma janela de login é aberta.
- Faça login com o usuário de teste. Você deve retornar para Legora.
- Ative o Status para que os membros possam fazer login com esta conexão.
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. 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.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çãoemail 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. Usehttps://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.