Configurar o SSO com o Microsoft Entra ID

Crie uma aplicação empresarial para o Lingo.dev no Microsoft Entra ID, atribua utilizadores, ligue-a à sua organização e aprovisione membros através de SCIM.

Este guia explica como ligar o Microsoft Entra ID ao Lingo.dev através de SAML 2.0. Precisa, no mínimo, da função de Administrador de Aplicações na Cloud no Entra e tem de ser Proprietário de uma organização do Lingo.dev com o plano Enterprise. Para saber como funciona o SSO no Lingo.dev, consulte Início de sessão único.

Mantenha a página Definições → SSO aberta no Lingo.dev. Vai copiar dois valores dessa página para o Entra.

Criar a aplicação empresarial #

  1. Inicie sessão no centro de administração do Microsoft Entra.
  2. Aceda a Entra ID → Aplicações empresariais → Todas as aplicações e selecione Nova aplicação.
  3. Selecione Criar a sua própria aplicação.
  4. Introduza Lingo.dev como nome, escolha Integrar qualquer outra aplicação que não encontre na galeria (Fora da galeria) e selecione Criar.

Configurar o SAML #

  1. Na nova aplicação, abra Início de sessão único e escolha SAML.
  2. Em Configuração SAML básica, selecione Editar.
  3. Em Identificador (ID da entidade), selecione Adicionar identificador e cole https://auth.lingo.dev/auth/v1/sso/saml/metadata (o ID da entidade no Lingo.dev).
  4. Em URL de resposta (URL do serviço consumidor de asserções), selecione Adicionar URL de resposta e cole https://auth.lingo.dev/auth/v1/sso/saml/acs (o URL ACS no Lingo.dev).
  5. Por agora, deixe URL de início de sessão, Estado de reencaminhamento e URL de fim de sessão em branco. Selecione Guardar. Vai definir o URL de início de sessão depois de estabelecer a ligação, em Iniciar sessão a partir das Minhas Aplicações da Microsoft.

Mantenha os Atributos & Afirmações predefinidos. As aplicações criadas no centro de administração do Entra enviam o endereço de e-mail do utilizador na afirmação emailaddress, a partir de user.mail, e um ID de nome em formato de e-mail. Certifique-se de que todos os utilizadores que iniciam sessão têm um endereço de e-mail no Entra.

Uma aplicação criada sem as afirmações predefinidas, por exemplo através da API do Microsoft Graph, não envia um endereço de e-mail. Nesse caso, o início de sessão falha com a mensagem "O seu fornecedor de identidade não enviou um endereço de e-mail." Em Atributos & Afirmações, adicione a afirmação de e-mail com o atributo de origem user.mail.

Copiar o URL de metadados #

Em Certificados SAML, copie o URL de metadados de federação da aplicação.

Atribuir utilizadores e grupos #

  1. Na aplicação, abra Utilizadores e grupos e selecione Adicionar utilizador/grupo.
  2. Em Utilizadores e grupos, selecione Nenhum selecionado, escolha os utilizadores ou grupos e selecione Selecionar.
  3. Selecione Atribuir.
  4. Abra Propriedades, defina Atribuição necessária? como Sim e selecione Guardar.

Com Atribuição necessária? definida como Sim, apenas os utilizadores atribuídos podem iniciar sessão no Lingo.dev através do Entra. Com Não, todos os utilizadores do seu inquilino podem aceder à aplicação, incluindo contas de convidado. Ainda assim, o Lingo.dev só permite que contas dos domínios ligados adiram à organização; termina a sessão de todas as outras. Nas aplicações criadas através da API do Microsoft Graph, o valor inicial é Não. A atribuição de grupos requer o Microsoft Entra ID P1 ou P2. No plano gratuito, atribua os utilizadores um a um.

Estabelecer a ligação no Lingo.dev #

  1. Abra Definições → SSO.
  2. Cole o URL de metadados de federação da aplicação em URL de metadados do fornecedor de identidade.
  3. Em Domínios de e-mail, introduza os domínios de e-mail da sua empresa, separados por vírgulas.
  4. Selecione Ligar.

Se um domínio for recusado, consulte Regras de domínio.

Testar o início de sessão #

  1. Abra uma janela privada do navegador e aceda à página de início de sessão do Lingo.dev.
  2. Selecione Continuar com SSO, introduza o e-mail de um utilizador atribuído e selecione Iniciar sessão.
  3. Inicie sessão com a Microsoft.

Ao regressar ao Lingo.dev, já é membro da organização. Verifique o e-mail apresentado na página das organizações: corresponde à conta usada para iniciar sessão na Microsoft, não necessariamente ao e-mail que introduziu. Se já tiver sessão iniciada na Microsoft no navegador, por exemplo com a conta do administrador que configurou a aplicação, a Microsoft continua com essa conta sem pedir uma palavra-passe. É por isso que o teste tem de ser feito numa janela privada.

Inicie o teste a partir do Lingo.dev, em vez de usar o botão Testar no Entra. Enquanto não definir o URL de início de sessão, o mosaico do Lingo.dev nas Minhas Aplicações da Microsoft não inicia a sessão: abre a página inicial do Lingo.dev, mas continua sem sessão iniciada.

Se o seu inquilino utilizar predefinições de segurança, a Microsoft pede a cada utilizador que registe uma aplicação de autenticação no primeiro início de sessão. Este processo pode ultrapassar o tempo de espera do Lingo.dev (cerca de 5 minutos), fazendo com que a primeira tentativa falhe com a mensagem "O início de sessão único demorou demasiado tempo a ser concluído. Tente novamente." A tentativa seguinte funciona.

Quando o teste funcionar, pode exigir SSO. Primeiro, atribua à sua própria conta SSO a função de Proprietário, conforme descrito em Ativar.

Iniciar sessão a partir das Minhas Aplicações da Microsoft #

Defina o URL de início de sessão para que o mosaico do Lingo.dev nas Minhas Aplicações inicie a sessão dos utilizadores.

  1. No Lingo.dev, abra Definições → SSO e copie a Ligação de início de sessão no painel. O formato é semelhante a https://lingo.dev/auth/sso?domain=example.com.
  2. No Entra, abra a aplicação Lingo.dev e selecione Início de sessão único.
  3. Em Configuração SAML básica, selecione Editar.
  4. Cole a ligação em URL de início de sessão. Selecione Guardar.

A partir de agora, o mosaico do Lingo.dev nas Minhas Aplicações abre essa ligação. O Lingo.dev encaminha o utilizador para a Microsoft e, depois, de volta ao Lingo.dev com a sessão iniciada, sem pedir um endereço de e-mail.

Aprovisionar membros com SCIM #

O Entra pode gerir os membros do Lingo.dev através de SCIM e definir as respetivas funções através de grupos. Comece por configurar o SSO seguindo este guia. Para saber como funciona o SCIM no Lingo.dev, consulte Aprovisionar membros com SCIM.

  1. No Lingo.dev, gere uma chave SCIM.
  2. No Entra, abra a aplicação empresarial Lingo.dev e selecione Aprovisionamento.
  3. Defina o Modo de aprovisionamento como Automático.
  4. Em Credenciais de administrador, cole o URL base de SCIM do Lingo.dev, https://api.lingo.dev/v2/scim, em URL do inquilino. Cole a chave SCIM em Token secreto.
  5. Selecione Testar ligação e, em seguida, Guardar.
  6. Mantenha os mapeamentos de atributos predefinidos. O Lingo.dev obtém userName a partir de userPrincipalName e o e-mail profissional a partir de mail.
  7. Em Definições, defina Âmbito como Sincronizar apenas utilizadores e grupos atribuídos.
  8. Selecione Iniciar aprovisionamento.

O convite é enviado para o endereço mail do utilizador, pelo que todos os utilizadores que atribuir precisam de ter esse endereço num domínio ligado. Não há problema se userPrincipalName for diferente de mail.

Cada utilizador que atribuir fica com um convite pendente no Lingo.dev e torna-se membro quando inicia sessão com SSO pela primeira vez.

O Entra faz o aprovisionamento em ciclos, aproximadamente a cada 40 minutos, pelo que as alterações e remoções chegam ao Lingo.dev no ciclo seguinte. Para enviar já um utilizador, utilize Aprovisionar a pedido.

Quando anula a atribuição de um utilizador, o Entra envia uma desativação, não uma eliminação, e o Lingo.dev remove-o da organização. Consulte Remover pessoas.

Definir funções com grupos do Entra #

  1. Certifique-se de que o grupo do Entra tem o mesmo nome que uma função do Lingo.dev, como Translator.
  2. Atribua o grupo à aplicação em Utilizadores e grupos.

O Entra associa o grupo à função com o mesmo nome e aprovisiona os respetivos membros, atribuindo-lhes essa função. As pessoas que remover do grupo perdem a função. Se o grupo for a única atribuição de um utilizador, removê-lo do grupo também o remove do Lingo.dev.

Resolução de problemas #

ProblemaSolução
A Microsoft apresenta AADSTS700016: "A aplicação com o identificador '…' não foi encontrada no diretório".O Identificador (ID da entidade) não corresponde exatamente a https://auth.lingo.dev/auth/v1/sso/saml/metadata. Corrija-o em Configuração SAML básica.
A Microsoft apresenta AADSTS50011: "O URL de resposta não corresponde aos URLs de resposta configurados para a aplicação".Defina o URL de resposta (URL do serviço consumidor de asserções) exatamente como https://auth.lingo.dev/auth/v1/sso/saml/acs.
A Microsoft apresenta AADSTS50105: o utilizador não está atribuído à aplicação.Em Utilizadores e grupos, atribua o utilizador ou um grupo a que pertença.
Um utilizador não atribuído iniciou sessão, ou o Lingo.dev apresenta um e-mail que não introduziu.Atribuição necessária? está definida como Não, ou o navegador já tinha sessão iniciada na Microsoft com outra conta. Defina Atribuição necessária? como Sim em Propriedades e teste numa janela privada.
O Lingo.dev indica que o seu e-mail não pertence a um domínio que a sua organização utiliza para o início de sessão único.A Microsoft iniciou sessão com uma conta fora dos seus domínios ligados, muitas vezes uma conta de convidado ou a do administrador que criou o inquilino. Inicie sessão com uma conta profissional ou adicione o respetivo domínio em Definições → SSO.
O Lingo.dev apresenta "O seu fornecedor de identidade não enviou um endereço de e-mail".A aplicação não envia uma afirmação de e-mail, ou o utilizador não tem um endereço de e-mail no Entra. Adicione a afirmação de e-mail (user.mail) em Atributos & Afirmações e defina o e-mail do utilizador.
O Lingo.dev apresenta "O início de sessão único demorou demasiado tempo a ser concluído. Tente novamente."O início de sessão na Microsoft demorou mais de cerca de 5 minutos, muitas vezes devido ao registo de uma aplicação de autenticação. Tente novamente a partir do Lingo.dev. A tentativa seguinte funciona.
O Lingo.dev apresenta "Tem sessão iniciada, mas não foi possível adicionar a sua conta à sua organização."Volte a iniciar sessão com SSO. Se continuar a falhar, peça a um Proprietário que verifique se a página Definições → SSO apresenta Ligado desde.
O Lingo.dev apresenta "O início de sessão único não foi concluído".Compare o Identificador (ID da entidade) e o URL de resposta com os valores no Lingo.dev e tente novamente.
A ação Testar ligação ou o aprovisionamento falha com 401 Unauthorized.A chave SCIM foi substituída ou revogada. Cole a chave atual em Token secreto ou gere uma nova no Lingo.dev.
Um utilizador atribuído não aparece em Definições → Equipa, no separador Convites.Aguarde pelo próximo ciclo de aprovisionamento ou utilize Aprovisionar a pedido. Verifique se o mail do utilizador pertence a um domínio ligado.

Para outras mensagens, consulte Resolução de problemas.