> ## 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 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](https://support.legora.com/pt/integration-overview-entra-id-single-sign-on.md).

> [!NOTE]
>
> 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?](https://support.legora.com/pt/how-do-i-manage-authentication-for-my-organization.md).
>
> 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](mailto: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](https://support.legora.com/pt/integration-overview-entra-id-single-sign-on.md).

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](https://support.legora.com/pt/it-admin-guide-legora-s-new-authentication-protocol.md).

## 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](mailto:support@legora.com).