Skip to main content
Este artigo foi traduzido automaticamente.

Visão geral

Este guia é para administradores de TI que ligam um fornecedor de identidade SAML 2.0 à autenticação global de Legora. Os membros fazem então login em Legora com as suas credenciais de trabalho. Os mesmos passos aplicam-se quando seleciona SAML, ADFS ou PingFederate em Legora. O Microsoft Entra ID na autenticação global de Legora utiliza o OpenID Connect. Consulte Visão geral da integração - Logon único do Entra ID.
A sua organização deve utilizar a autenticação global de Legora e a sua função deve incluir Gerir a segurança da autenticação. Consulte Como gerir a autenticação da minha organização?.Se a sua organização ainda não tiver sido alterada, o suporte Legora configura o logon único (SSO). Entre em contacto com support@legora.com.

Como funciona

Cria uma aplicação SAML no seu fornecedor de identidade e fornece os dados do fornecedor de serviços Legora. Em seguida, introduz os dados do seu fornecedor de identidade em Legora. Esta troca é o que permite Legora confiar no login.

Pré-requisitos

Precisa de ambos antes de começar:
  • Acesso de administrador ao fornecedor de identidade SAML 2.0 da sua organização.
  • Gerencie a segurança da autenticação na organização Legora.

Configure a ligação

Execute primeiro os passos do fornecedor de identidade e depois os passos Legora. Os valores do fornecedor de serviços são os mesmos para todas as organizações na autenticação global de Legora.

Crie a aplicação SAML

Comece na consola de administração do seu fornecedor de identidade.
  1. Crie uma nova aplicação SAML 2.0 para Legora.
  2. Se a organização já tiver uma aplicação Legora SAML, mantenha essa aplicação e crie esta ao lado. A secção de migração abaixo indica quando isto se aplica.

Introduza os dados do fornecedor de serviços de Legora

Copie estes valores para o novo aplicativo. 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 website. A abertura deste endereço raiz mostra 404 Not Found por design. Utilize o URL completo do ACS. Depois de criar a ligação, ACS URL na ligação mostra o mesmo URL de resposta. ID da entidade na ligação mostra o identificador do seu fornecedor de identidade. Introduza https://sso.legora.com no fornecedor de identidade como ID da entidade Legora. Legora requer uma reclamação email. given_name e family_name são recomendados. Mapeie os atributos do seu fornecedor de identidade para esses nomes.

Adicione o fornecedor de identidade em Legora

Introduza os dados do seu fornecedor de identidade para que Legora possa direcionar os membros para a página de início de sessão correta.
  1. No seu nome no menu, selecione Definições > Pessoas > Autenticação.
  2. Em SSO, selecione Add e escolha SAML, ADFS ou PingFederate.
  3. Introduza um Nome de visualização. Os membros veem esse nome no ecrã de login.
  4. Introduza os dados do seu fornecedor de identidade. Use um destes:
    • URL de metadados: Legora procura o endpoint de login e o certificado deste endereço. Esta é a escolha habitual.
    • Ou introduza o ID da entidade, o URL do terminal de início de sessão e o Certificado de subscrição (PEM) do seu fornecedor de identidade.
  5. Selecione Criar ligação. Legora abre a nova ligação.
Editar numa ligação SAML altera apenas o nome de apresentação. Para alterar os metadados, crie uma nova ligação.

Teste e ligue a ligação

Confirme a ligação antes que os membros confiem nela.
  1. No seu fornecedor de identidade, atribua um utilizador de teste à aplicação Legora SAML.
  2. Em Legora, abra a ligação e selecione Testar ligação. É aberta uma janela de login.
  3. Faça login com o utilizador de teste. Deve retornar para Legora.
  4. Ative o Estado para que os membros possam iniciar sessão com esta ligação.
Se o teste falhar, compare o URL do ACS e o ID da entidade no seu fornecedor de identidade com os valores dos passos anteriores. Confirme também se a afirmação inclui email.

Migração para a autenticação global de Legora

Utilize esta secção apenas quando a organização já tiver uma aplicação SAML para Legora e estiver a migrar essa organização para a autenticação global de Legora. A primeira configuração é concluída depois de ativar o Estado. Uma aplicação SAML está ligada ao ID da entidade do fornecedor de serviços. Não pode apontar a aplicação existente para a autenticação global de Legora. Crie uma nova aplicação SAML com os valores acima. Deixe a aplicação existente inalterada até que a migração esteja concluída. Para testar durante a migração, no seu nome no menu, selecione Definições > Pessoas > Migração de autenticação. Execute o teste de ligação e confirme se aparece Aprovado. Legora não suporta mais do que uma aplicação SAML no mesmo tenant do Microsoft Entra. Mova estas ligações para o OpenID Connect. Consulte Visão geral da integração - Logon único do Entra ID. Para obter os URLs de retorno de chamada de integração, as regras de firewall e o resto da alteração, consulte Guia de administração de TI: autenticação global de Legora.

Solução de problemas

Comece pela afirmação e pelos dois URLs Legora.

O login falha ou o utilizador 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 fornecedor de identidade envia email e se given_name e family_name utilizam estes nomes quando os envia. Confirme também se o utilizador de teste está atribuído à aplicação.

O URL de resposta ou ID da entidade foi rejeitado

O URL do ACS e o ID da entidade no seu fornecedor de identidade devem corresponder exatamente aos valores deste guia. Utilize https://sso.legora.com sem barra final e utilize o URL ACS completo https://sso.legora.com/api/oauth/saml. Se estas verificações não resolverem o problema, por favor contacte support@legora.com.
Última modificação em 6 de novembro de 2026