Configurar o SSO com o Microsoft Entra ID

Crie um aplicativo empresarial para o Lingo.dev no Microsoft Entra ID, atribua usuários, conecte o aplicativo à sua organização e provisione membros via SCIM.

Este guia mostra como conectar o Microsoft Entra ID ao Lingo.dev via SAML 2.0. Você precisa ter, no mínimo, a função de Administrador de Aplicativos de Nuvem no Entra e ser Proprietário de uma organização do Lingo.dev no plano Enterprise. Para saber como o SSO funciona no Lingo.dev, consulte Logon único.

Deixe a página Configurações → SSO aberta no Lingo.dev. Você vai copiar dois valores dessa página para o Entra.

Criar o aplicativo empresarial #

  1. Entre no centro de administração do Microsoft Entra.
  2. Acesse Entra ID → Aplicativos empresariais → Todos os aplicativos e selecione Novo aplicativo.
  3. Selecione Criar seu próprio aplicativo.
  4. Digite Lingo.dev como nome, escolha Integrar qualquer outro aplicativo que você não encontre na galeria (Fora da galeria) e selecione Criar.

Configurar o SAML #

  1. No novo aplicativo, abra Logon único e escolha SAML.
  2. Em Configuração básica de SAML, 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 do Consumidor de Declaração), selecione Adicionar URL de resposta e cole https://auth.lingo.dev/auth/v1/sso/saml/acs (a URL do ACS no Lingo.dev).
  5. Deixe os campos URL de logon, Estado de retransmissão e URL de logout em branco por enquanto. Selecione Salvar. Você vai definir a URL de logon após a conexão, em Entrar pelo Microsoft Meus Aplicativos.

Mantenha os Atributos & Declarações padrão. Os aplicativos criados no centro de administração do Entra enviam o e-mail do usuário na declaração emailaddress, a partir de user.mail, e um ID de nome no formato de e-mail. Verifique se todos os usuários que vão entrar têm um endereço de e-mail no Entra.

Um aplicativo criado sem as declarações padrão, por exemplo, pela API do Microsoft Graph, não envia um endereço de e-mail. Nesse caso, a entrada falha com a mensagem "Seu provedor de identidade não enviou um endereço de e-mail." Em Atributos & Declarações, adicione a declaração de e-mail com o atributo de origem user.mail.

Copiar a URL de metadados #

Em Certificados SAML, copie a URL de metadados de federação do aplicativo.

Atribuir usuários e grupos #

  1. No aplicativo, abra Usuários e grupos e selecione Adicionar usuário/grupo.
  2. Em Usuários e grupos, selecione Nenhum selecionado, escolha os usuários ou grupos e selecione Selecionar.
  3. Selecione Atribuir.
  4. Abra Propriedades, defina Atribuição necessária? como Sim e selecione Salvar.

Com Atribuição necessária? definida como Sim, apenas os usuários atribuídos podem entrar no Lingo.dev pelo Entra. Com Não, todos os usuários do seu locatário podem acessar o aplicativo, incluindo contas de convidados. Ainda assim, o Lingo.dev só permite que contas dos domínios conectados entrem na organização; as demais são desconectadas em seguida. Aplicativos criados pela API do Microsoft Graph começam com Não. Para atribuir grupos, é necessário ter o Microsoft Entra ID P1 ou P2. No plano gratuito, atribua os usuários um por um.

Conectar no Lingo.dev #

  1. Abra Configurações → SSO.
  2. Cole a URL de metadados de federação do aplicativo em URL de metadados do provedor de identidade.
  3. Em Domínios de e-mail, digite os domínios de e-mail da sua empresa, separados por vírgulas.
  4. Selecione Conectar.

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

Testar a entrada #

  1. Abra uma janela de navegação privada e acesse a página de entrada do Lingo.dev.
  2. Selecione Continuar com SSO, digite o e-mail de um usuário atribuído e selecione Entrar.
  3. Entre com a Microsoft.

Você volta ao Lingo.dev como membro da organização. Confira o e-mail exibido na página de organizações: ele corresponde à conta autenticada pela Microsoft, não necessariamente ao e-mail que você digitou. Se já houver uma sessão da Microsoft aberta no navegador, por exemplo, com a conta do administrador que configurou o aplicativo, a Microsoft vai continuar com essa conta sem pedir senha. Por isso, o teste precisa ser feito em uma janela privada.

Inicie o teste pelo Lingo.dev, e não pelo botão Testar no Entra. Enquanto você não definir a URL de logon, o bloco do Lingo.dev no Microsoft Meus Aplicativos não vai autenticar você: ele abre a página inicial do Lingo.dev, ainda sem uma sessão iniciada.

Se o seu locatário usa os padrões de segurança, a Microsoft pede que cada usuário registre um aplicativo autenticador na primeira entrada. Isso pode ultrapassar o tempo de espera do Lingo.dev (cerca de 5 minutos), e a primeira tentativa falha com a mensagem "O logon único demorou demais para ser concluído. Tente novamente." A nova tentativa funciona.

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

Entrar pelo Microsoft Meus Aplicativos #

Defina a URL de logon para que os usuários possam entrar pelo bloco do Lingo.dev no Meus Aplicativos.

  1. No Lingo.dev, abra Configurações → SSO e copie o Link de entrada do painel. Ele tem o formato https://lingo.dev/auth/sso?domain=example.com.
  2. No Entra, abra o aplicativo do Lingo.dev e selecione Logon único.
  3. Em Configuração básica de SAML, selecione Editar.
  4. Cole o link em URL de logon. Selecione Salvar.

Agora, o bloco do Lingo.dev no Meus Aplicativos abre esse link. O Lingo.dev direciona o usuário à Microsoft e o traz de volta já autenticado, sem pedir um e-mail.

Provisionar membros com SCIM #

O Entra pode gerenciar membros do Lingo.dev via SCIM e definir suas funções por meio de grupos. Primeiro, configure o SSO seguindo este guia. Para saber como o SCIM funciona no Lingo.dev, consulte Provisionar membros com SCIM.

  1. No Lingo.dev, gere uma chave SCIM.
  2. No Entra, abra o aplicativo empresarial do Lingo.dev e selecione Provisionamento.
  3. Defina Modo de provisionamento como Automático.
  4. Em Credenciais de administrador, cole a URL base do SCIM do Lingo.dev, https://api.lingo.dev/v2/scim, em URL do locatário. Cole a chave SCIM em Token secreto.
  5. Selecione Testar conexão e, depois, Salvar.
  6. Mantenha os mapeamentos de atributos padrão. O Lingo.dev obtém userName de userPrincipalName e o e-mail de trabalho de mail.
  7. Em Configurações, defina Escopo como Sincronizar somente usuários e grupos atribuídos.
  8. Selecione Iniciar provisionamento.

O convite é enviado para o endereço mail do usuário. Por isso, todo usuário atribuído precisa ter esse endereço em um domínio conectado. Não há problema se userPrincipalName for diferente de mail.

Cada usuário que você atribuir recebe um convite pendente no Lingo.dev e se torna membro na primeira entrada com SSO.

O Entra faz o provisionamento em ciclos, aproximadamente a cada 40 minutos. Assim, alterações e remoções chegam ao Lingo.dev no ciclo seguinte. Para enviar um usuário imediatamente, use Provisionar sob demanda.

Quando você remove a atribuição de um usuário, o Entra envia uma desativação, não uma exclusão, e o Lingo.dev remove esse usuário da organização. Consulte Remover pessoas.

Definir funções com grupos do Entra #

  1. Verifique se o grupo do Entra tem o mesmo nome de uma função do Lingo.dev, como Translator.
  2. Atribua o grupo ao aplicativo em Usuários e grupos.

O Entra associa o grupo à função de mesmo nome e provisiona seus membros, que recebem essa função. Quem for removido do grupo perde a função. Se o grupo era a única atribuição de um usuário, removê-lo do grupo também o remove do Lingo.dev.

Solução de problemas #

ProblemaSolução
A Microsoft exibe AADSTS700016: "O aplicativo com o identificador '…' não foi encontrado no diretório".O Identificador (ID da entidade) não corresponde exatamente a https://auth.lingo.dev/auth/v1/sso/saml/metadata. Corrija o valor em Configuração básica de SAML.
A Microsoft exibe AADSTS50011: "A URL de resposta não corresponde às URLs de resposta configuradas para o aplicativo".Defina a URL de resposta (URL do Serviço do Consumidor de Declaração) exatamente como https://auth.lingo.dev/auth/v1/sso/saml/acs.
A Microsoft exibe AADSTS50105: o usuário não está atribuído ao aplicativo.Atribua o usuário, ou um grupo do qual ele faça parte, em Usuários e grupos.
Alguém sem atribuição conseguiu entrar, ou o Lingo.dev mostra um e-mail que você não digitou.Atribuição necessária? está definida como Não, ou já havia uma sessão da Microsoft aberta no navegador com outra conta. Defina Atribuição necessária? como Sim em Propriedades e teste em uma janela privada.
O Lingo.dev informa que seu e-mail não pertence a um domínio que sua organização usa para logon único.A Microsoft autenticou uma conta de fora dos domínios conectados, geralmente uma conta de convidado ou do administrador que criou o locatário. Entre com uma conta de trabalho ou adicione o domínio dela em Configurações → SSO.
O Lingo.dev exibe "Seu provedor de identidade não enviou um endereço de e-mail".O aplicativo não envia uma declaração de e-mail, ou o usuário não tem um endereço de e-mail no Entra. Adicione a declaração de e-mail (user.mail) em Atributos & Declarações e defina o e-mail do usuário.
O Lingo.dev exibe "O logon único demorou demais para ser concluído. Tente novamente."A entrada na Microsoft ultrapassou o limite de cerca de 5 minutos, geralmente durante o registro de um aplicativo autenticador. Tente novamente pelo Lingo.dev. A próxima tentativa funciona.
O Lingo.dev exibe "Você entrou, mas não foi possível adicionar você à sua organização."Entre com SSO novamente. Se a falha persistir, peça a um Proprietário que verifique se Configurações → SSO exibe Conectado desde.
O Lingo.dev exibe "O logon único não foi concluído".Compare o Identificador (ID da entidade) e a URL de resposta com os valores no Lingo.dev e tente novamente.
Testar conexão ou o provisionamento 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 usuário atribuído não aparece em Configurações → Equipe, na aba Convites.Aguarde o próximo ciclo de provisionamento ou use Provisionar sob demanda. Verifique se o mail do usuário pertence a um domínio conectado.

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