Configurar o SSO com o Okta

Crie um aplicativo SAML para o Lingo.dev no Okta, atribua pessoas a ele, conecte-o à sua organização e provisione membros via SCIM.

Este guia mostra como conectar o Okta ao Lingo.dev via SAML 2.0. Você precisa de uma conta de administrador do Okta com permissão para criar integrações de aplicativos e deve ser Proprietário de uma organização do Lingo.dev no plano Enterprise. Para saber como o SSO funciona no Lingo.dev, consulte Login único.

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

Criar a integração do aplicativo #

  1. Entre no Console de administração do Okta.
  2. Acesse Aplicativos → Aplicativos (Aplicativos e recursos → Aplicativos nas versões mais recentes do Console de administração) e selecione Criar integração de aplicativo.
  3. Escolha SAML 2.0 e selecione Avançar.
  4. Em Nome do aplicativo, digite Lingo.dev. Selecione Avançar.

Configurar o SAML #

Preencha os campos abaixo e mantenha os demais com os valores padrão:

Campo do OktaValor
URL de login únicohttps://auth.lingo.dev/auth/v1/sso/saml/acs (a URL ACS no Lingo.dev)
Usar para a URL do destinatário e a URL de destinoSelecionado
URI do público (ID da entidade do SP)https://auth.lingo.dev/auth/v1/sso/saml/metadata (o ID da entidade no Lingo.dev)
RelayState padrãoVazio
Formato do ID de nomeEndereço de e-mail
Nome de usuário do aplicativoE-mail

Em Declarações de atributos, adicione um atributo:

NomeFormato do nomeValor
emailNão especificadouser.email

Com o Formato do ID de nome definido como Endereço de e-mail e o atributo email adicionado, o Okta envia o endereço de e-mail de que o Lingo.dev precisa.

As organizações mais recentes do Okta não exibem mais Declarações de atributos durante a criação do aplicativo. Nesse caso, adicione o atributo depois de selecionar Concluir: na aba Login do aplicativo, vá até a seção Declarações de atributos e selecione Adicionar expressão. Digite email em Nome e user.profile.email em Expressão e selecione Salvar.

Selecione Avançar. Na etapa Comentários, selecione Sou cliente do Okta e estou adicionando um aplicativo interno e, em seguida, Concluir.

Copiar a URL de metadados #

Na aba Login do aplicativo, copie a URL de metadados da seção Detalhes dos metadados. Ela tem o formato https://your-company.okta.com/app/exk.../sso/saml/metadata.

Atribuir pessoas #

  1. Abra a aba Atribuições do aplicativo.
  2. Selecione Atribuir e depois Atribuir a pessoas ou Atribuir a grupos.
  3. Selecione Atribuir ao lado de cada pessoa ou grupo e depois Concluído.

Somente as pessoas atribuídas ao aplicativo podem entrar no Lingo.dev pelo Okta.

Conectar no Lingo.dev #

  1. Abra Configurações → SSO.
  2. Cole a URL de metadados do Okta 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 o login #

  1. Abra uma janela de navegação privativa e acesse a página de login do Lingo.dev.
  2. Selecione Continuar com SSO, digite o e-mail de uma pessoa atribuída ao aplicativo e selecione Entrar.
  3. Entre no Okta.

Você retorna ao Lingo.dev como membro da organização. Confira o e-mail exibido na página de organizações: ele corresponde à conta usada pelo Okta para fazer login, não necessariamente ao e-mail que você digitou. Se já houver uma sessão do Okta no navegador, como a do administrador que configurou o aplicativo, o Okta continuará usando essa conta. Um administrador que não esteja atribuído ao aplicativo recebe a mensagem "O usuário não está atribuído a este aplicativo". Por isso, o teste precisa ser feito em uma janela privativa.

Inicie o teste pelo Lingo.dev. O bloco do próprio aplicativo SAML no painel do Okta não faz seu login: você chega à página inicial do Lingo.dev, mas continua sem estar conectado. Para entrar pelo painel, adicione o favorito descrito em Entrar pelo painel do Okta.

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

Entrar pelo painel do Okta #

Para que os membros tenham um bloco do Lingo.dev que faça o login, adicione um aplicativo de favorito que abra o link de login pelo painel. Depois, oculte o ícone do aplicativo SAML para que os membros vejam apenas o favorito.

  1. No Lingo.dev, abra Configurações → SSO e copie o Link de login pelo painel. Ele tem o formato https://lingo.dev/auth/sso?domain=example.com.
  2. No Console de administração do Okta, acesse Aplicativos → Aplicativos (Aplicativos e recursos → Aplicativos nas versões mais recentes do Console de administração) e selecione Explorar catálogo de aplicativos.
  3. Busque Aplicativo de favorito, selecione-o e depois selecione Adicionar integração.
  4. Em Configurações gerais, digite Lingo.dev como nome e cole o link como URL. Deixe a opção Não exibir o ícone do aplicativo para os usuários desmarcada. Selecione Concluído.
  5. Na aba Atribuições do favorito, atribua as mesmas pessoas ou grupos que você atribuiu ao aplicativo SAML.
  6. Abra o aplicativo SAML do Lingo.dev. Na aba Geral, selecione Editar em Configurações do aplicativo.
  7. Em Visibilidade do aplicativo, selecione Não exibir o ícone do aplicativo para os usuários e Não exibir o ícone do aplicativo no aplicativo Okta Mobile. Selecione Salvar.

Mantenha as pessoas atribuídas ao aplicativo SAML. Ele continua fazendo o login delas; está apenas oculto.

Agora, os membros veem um único bloco do Lingo.dev. Ele abre o Lingo.dev, que os redireciona ao Okta e depois os traz de volta, já conectados, sem pedir um e-mail.

Provisionar membros com SCIM #

O Okta pode gerenciar os 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 Console de administração do Okta, abra o aplicativo SAML do Lingo.dev. Na aba Geral, selecione Editar em Configurações do aplicativo.
  3. Defina Provisionamento como SCIM e selecione Salvar. A aba Provisionamento será adicionada ao aplicativo.
  4. Na aba Provisionamento, abra Integração e selecione Editar.

Preencha estes campos:

Campo do OktaValor
URL base do conector SCIMhttps://api.lingo.dev/v2/scim (a URL base do SCIM no Lingo.dev)
Campo de identificador exclusivo dos usuáriosuserName
Ações de provisionamento compatíveisEnviar novos usuários, Enviar atualizações de perfil e Enviar grupos. Deixe as ações de importação desmarcadas. O Okta não importa usuários nem grupos do Lingo.dev.
Modo de autenticaçãoCabeçalho HTTP. Cole a chave SCIM como token Bearer.

Selecione Testar configuração do conector. Quando o teste passar, feche-o e selecione Salvar.

Na aba Provisionamento, abra Para o aplicativo e selecione Editar. Ative Criar usuários, Atualizar atributos de usuário e Desativar usuários e selecione Salvar.

O Okta só envia pessoas ao Lingo.dev depois que você salva a opção Criar usuários. A partir daí, cada pessoa que você atribuir terá um convite pendente no Lingo.dev e se tornará membro no primeiro login por SSO.

Quando você remove a atribuição de uma pessoa ou a desativa no Okta, o Okta também a desativa no Lingo.dev, removendo seu vínculo como membro. Consulte Remover pessoas.

Definir funções com grupos do Okta #

  1. Verifique se o grupo do Okta tem o mesmo nome de uma função do Lingo.dev, como Translator.
  2. Na aba Enviar grupos do aplicativo, selecione Enviar grupos e depois Localizar grupos por nome.
  3. Localize o grupo e selecione Salvar.

Envie um grupo diferente do usado para atribuir acesso ao aplicativo. O Okta não permite usar o mesmo grupo para as duas finalidades. Como o Okta envia apenas membros atribuídos ao aplicativo, atribua todas as pessoas do grupo enviado ao aplicativo, diretamente ou por meio de outro grupo.

O Okta vincula o grupo à função de mesmo nome. Os membros do grupo recebem essa função, e as pessoas removidas dele a perdem. Se nenhuma função tiver o nome do grupo, o envio exibirá um erro com "Nenhuma função com o nome". Crie a função no Lingo.dev e envie o grupo novamente.

Se você parar de enviar um grupo e o Okta perguntar se deseja excluí-lo no aplicativo, selecionar Excluir removerá a função dos membros desse grupo. A função permanece no Lingo.dev.

Solução de problemas #

ProblemaSolução
O Lingo.dev exibe "O login único não foi concluído" depois que você entra no Okta.Confira a URI do público (ID da entidade do SP) e a URL de login único. Elas devem corresponder exatamente ao ID da entidade e à URL ACS no Lingo.dev, sem barra no final.
O Lingo.dev exibe "Seu provedor de identidade não enviou um endereço de e-mail".Defina Formato do ID de nome como Endereço de e-mail e Nome de usuário do aplicativo como E-mail. Adicione também a declaração do atributo email: user.email no assistente de configuração ou user.profile.email na aba Login.
O Okta informa que você não está atribuído ao aplicativo.Na aba Atribuições, atribua a pessoa ou um grupo do qual ela faz parte. Se você digitou o e-mail de uma pessoa atribuída, mas o Okta exibe sua conta de administrador, o navegador manteve sua sessão do Okta. Saia do Okta ou use uma janela privativa.
O Lingo.dev exibe "O login único demorou demais para ser concluído. Tente novamente."O login no Okta levou mais de cerca de 5 minutos, por exemplo, durante a configuração inicial da autenticação multifator. Tente novamente pelo Lingo.dev. A próxima tentativa funcionará.
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 para verificar se Configurações → SSO exibe Conectado desde.
O Lingo.dev exibe "O login único não está configurado para" seu domínio.Adicione o domínio em Configurações → SSO ou confira o e-mail que você digitou.
Testar configuração do conector ou o provisionamento falha com 401 Unauthorized.A chave SCIM foi substituída ou revogada. Cole a chave atual em Integração ou gere uma nova no Lingo.dev.
Uma pessoa atribuída no Okta não aparece em Configurações → Equipe, na aba Convites.Verifique se Criar usuários está ativado em Para o aplicativo. Para as pessoas atribuídas antes de você salvar essa opção, abra a lista de tarefas de provisionamento do Okta e tente processá-las novamente.

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