Configurar o SSO com o Okta

Crie uma aplicação SAML para o Lingo.dev no Okta, atribua acesso às pessoas, ligue a aplicação à sua organização e aprovisione membros através de SCIM.

Este guia explica como ligar o Okta ao Lingo.dev através de SAML 2.0. Precisa de uma conta de administrador do Okta com permissões para criar integrações de aplicações e tem de ser Proprietário de uma organização do Lingo.dev no 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 Okta.

Criar a integração da aplicação #

  1. Inicie sessão na consola de administração do Okta.
  2. Aceda a Aplicações → Aplicações (Aplicações e recursos → Aplicações nas consolas de administração mais recentes) e selecione Criar integração de aplicação.
  3. Escolha SAML 2.0 e selecione Seguinte.
  4. Em Nome da aplicação, introduza Lingo.dev. Selecione Seguinte.

Configurar o SAML #

Preencha estes campos e deixe os restantes com os valores predefinidos:

Campo do OktaValor
URL de início de sessão únicohttps://auth.lingo.dev/auth/v1/sso/saml/acs (o URL ACS no Lingo.dev)
Usar este URL como URL do destinatário e URL de destinoSelecionado
URI do público-alvo (ID de entidade do SP)https://auth.lingo.dev/auth/v1/sso/saml/metadata (o ID de entidade no Lingo.dev)
RelayState predefinidoVazio
Formato do ID de nomeEmailAddress
Nome de utilizador da aplicaçãoE-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 EmailAddress e este atributo email, o Okta envia o endereço de e-mail de que o Lingo.dev precisa.

Nas organizações mais recentes do Okta, a secção Declarações de atributos já não aparece durante a criação da aplicação. Nesse caso, adicione o atributo depois de selecionar Concluir: no separador Início de sessão da aplicação, na secção Declarações de atributos, selecione Adicionar expressão. Introduza email em Nome e user.profile.email em Expressão e, em seguida, selecione Guardar.

Selecione Seguinte. No passo Comentários, escolha Sou cliente do Okta e estou a adicionar uma aplicação interna e selecione Concluir.

Copiar o URL dos metadados #

No separador Início de sessão da aplicação, copie o URL dos metadados da secção Detalhes dos metadados. O URL tem um formato semelhante a https://your-company.okta.com/app/exk.../sso/saml/metadata.

Atribuir acesso às pessoas #

  1. Abra o separador Atribuições da aplicação.
  2. Selecione Atribuir e, em seguida, Atribuir a pessoas ou Atribuir a grupos.
  3. Selecione Atribuir junto de cada pessoa ou grupo e, em seguida, Concluído.

Só as pessoas a quem atribuiu acesso à aplicação podem iniciar sessão no Lingo.dev através do Okta.

Estabelecer a ligação no Lingo.dev #

  1. Abra Definições → SSO.
  2. Cole o URL dos metadados do Okta em URL dos 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 de navegação privada e aceda à página de início de sessão do Lingo.dev.
  2. Selecione Continuar com SSO, introduza o e-mail de uma pessoa a quem atribuiu acesso à aplicação e selecione Iniciar sessão.
  3. Inicie sessão no Okta.

Regressa ao Lingo.dev como membro da organização. Verifique o e-mail apresentado na página de organizações: corresponde à conta com que o Okta iniciou sessão, não necessariamente ao e-mail que introduziu. Se já existir uma sessão do Okta no navegador, por exemplo, a do administrador que configurou a aplicação, o Okta continua com essa conta. Um administrador sem acesso atribuído à aplicação recebe a mensagem "O utilizador não está atribuído a esta aplicação". É por isso que deve fazer o teste numa janela de navegação privada.

Inicie o teste a partir do Lingo.dev. O mosaico da própria aplicação SAML no painel do Okta não inicia sessão: abre a página inicial do Lingo.dev, mas a sessão continua por iniciar. Para iniciar sessão a partir do painel, adicione o marcador indicado em Iniciar sessão a partir do painel do Okta.

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

Iniciar sessão a partir do painel do Okta #

Para disponibilizar aos membros um mosaico do Lingo.dev que lhes permita iniciar sessão, adicione uma Bookmark App que abra a ligação de início de sessão a partir do painel. Depois, oculte o ícone da própria aplicação SAML, para que os membros vejam apenas o marcador.

  1. No Lingo.dev, abra Definições → SSO e copie a Ligação de início de sessão a partir do painel. A ligação tem um formato semelhante a https://lingo.dev/auth/sso?domain=example.com.
  2. Na consola de administração do Okta, aceda a Aplicações → Aplicações (Aplicações e recursos → Aplicações nas consolas de administração mais recentes) e selecione Explorar catálogo de aplicações.
  3. Procure e selecione Bookmark App e, em seguida, selecione Adicionar integração.
  4. Em Definições gerais, introduza Lingo.dev como nome e cole a ligação como URL. Deixe a opção Não apresentar o ícone da aplicação aos utilizadores desmarcada. Selecione Concluído.
  5. No separador Atribuições do marcador, atribua acesso às mesmas pessoas ou grupos que na aplicação SAML.
  6. Abra a aplicação SAML do Lingo.dev. No separador Geral, selecione Editar em Definições da aplicação.
  7. Em Visibilidade da aplicação, selecione Não apresentar o ícone da aplicação aos utilizadores e Não apresentar o ícone da aplicação na aplicação Okta Mobile. Selecione Guardar.

Mantenha as atribuições de acesso à aplicação SAML. A aplicação continua a permitir o início de sessão; está apenas oculta.

Os membros passam a ver um único mosaico do Lingo.dev. Ao selecioná-lo, abrem o Lingo.dev, que os encaminha para o Okta e de volta, já com sessão iniciada, sem lhes pedir um e-mail.

Aprovisionar membros com SCIM #

O Okta pode gerir os membros do Lingo.dev através de SCIM e definir as suas funções através de grupos. Primeiro, configure 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. Na consola de administração do Okta, abra a aplicação SAML do Lingo.dev. No separador Geral, selecione Editar em Definições da aplicação.
  3. Defina Aprovisionamento como SCIM e selecione Guardar. A aplicação passa a ter um separador Aprovisionamento.
  4. No separador Aprovisionamento, abra Integração e selecione Editar.

Preencha estes campos:

Campo do OktaValor
URL base do conector SCIMhttps://api.lingo.dev/v2/scim (o URL base de SCIM no Lingo.dev)
Campo do identificador único dos utilizadoresuserName
Ações de aprovisionamento suportadasEnviar novos utilizadores, Enviar atualizações de perfil e Enviar grupos. Deixe as ações de importação desmarcadas. O Okta não importa utilizadores 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 for bem-sucedido, feche-o e selecione Guardar.

No separador Aprovisionamento, abra Para a aplicação e selecione Editar. Ative Criar utilizadores, Atualizar atributos dos utilizadores e Desativar utilizadores e selecione Guardar.

O Okta não envia ninguém para o Lingo.dev enquanto não guardar a opção Criar utilizadores. A partir daí, cada pessoa a quem atribuir acesso fica com um convite pendente no Lingo.dev e torna-se membro no primeiro início de sessão por SSO.

Quando anula a atribuição de acesso de uma pessoa ou a desativa no Okta, o Okta desativa-a no Lingo.dev, removendo-a da organização. Consulte Remover pessoas.

Definir funções com grupos do Okta #

  1. Certifique-se de que o grupo do Okta tem o mesmo nome que uma função do Lingo.dev, como Translator.
  2. No separador Enviar grupos da aplicação, selecione Enviar grupos e, em seguida, Procurar grupos pelo nome.
  3. Encontre o grupo e selecione Guardar.

Envie um grupo diferente do que usa para atribuir acesso à aplicação. O Okta não permite usar o mesmo grupo para ambas as finalidades. Como o Okta só envia membros com acesso atribuído à aplicação, atribua esse acesso a todas as pessoas do grupo enviado, diretamente ou através de outro grupo.

O Okta associa o grupo à função com o mesmo nome. Os membros recebem essa função e as pessoas que remover do grupo perdem-na. Se não existir uma função com o nome do grupo, o envio apresenta um erro com a mensagem "Não existe nenhuma função com o nome". Crie a função no Lingo.dev e volte a enviar o grupo.

Se deixar de enviar um grupo e o Okta perguntar se pretende eliminá-lo na aplicação, a opção Eliminar remove a função dos respetivos membros. A função mantém-se no Lingo.dev.

Resolução de problemas #

ProblemaSolução
O Lingo.dev apresenta "O início de sessão único não foi concluído" depois de iniciar sessão no Okta.Verifique o URI do público-alvo (ID de entidade do SP) e o URL de início de sessão único. Têm de corresponder exatamente ao ID de entidade e ao URL ACS no Lingo.dev, sem barra no final.
O Lingo.dev apresenta "O seu fornecedor de identidade não enviou um endereço de e-mail".Defina Formato do ID de nome como EmailAddress e Nome de utilizador da aplicação como E-mail e adicione a declaração do atributo email: user.email no assistente de configuração ou user.profile.email no separador Início de sessão.
O Okta indica que não tem acesso atribuído à aplicação.No separador Atribuições, atribua acesso à pessoa ou a um grupo a que pertença. Se introduziu o e-mail de uma pessoa com acesso atribuído, mas o Okta apresenta a sua conta de administrador, o navegador manteve a sua sessão do Okta. Termine a sessão no Okta ou use uma janela de navegação privada.
O Lingo.dev apresenta "O início de sessão único demorou demasiado tempo a concluir. Tente novamente."O início de sessão no Okta demorou mais de cerca de 5 minutos, por exemplo, durante a configuração inicial da autenticação multifator. Tente novamente a partir do Lingo.dev. A tentativa seguinte será bem-sucedida.
O Lingo.dev apresenta "Tem sessão iniciada, mas não foi possível adicionar a sua conta à organização."Volte a iniciar sessão com SSO. Se o problema persistir, peça a um Proprietário que verifique se Definições → SSO apresenta Ligado desde.
O Lingo.dev apresenta "O início de sessão único não está configurado para" o seu domínio.Adicione o domínio em Definições → SSO ou verifique o e-mail que introduziu.
A opção Testar configuração do conector ou o aprovisionamento 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 com acesso atribuído no Okta não aparece em Definições → Equipa, no separador Convites.Verifique se Criar utilizadores está ativado em Para a aplicação. Para as pessoas a quem atribuiu acesso antes de guardar esta opção, abra a lista de tarefas de aprovisionamento do Okta e volte a tentar processá-las.

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