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 #
- Inicie sessão 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 Criar integração de aplicação.
- Escolha SAML 2.0 e selecione Seguinte.
- 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 Okta | Valor |
|---|---|
| URL de início de sessão único | https://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 destino | Selecionado |
| 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 predefinido | Vazio |
| Formato do ID de nome | EmailAddress |
| Nome de utilizador da aplicação |
Em Declarações de atributos, adicione um atributo:
| Nome | Formato do nome | Valor |
|---|---|---|
email | Não especificado | user.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 #
- Abra o separador Atribuições da aplicação.
- Selecione Atribuir e, em seguida, Atribuir a pessoas ou Atribuir a grupos.
- 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 #
- Abra Definições → SSO.
- Cole o URL dos metadados do Okta em URL dos metadados do fornecedor de identidade.
- Em Domínios de e-mail, introduza os domínios de e-mail da sua empresa, separados por vírgulas.
- Selecione Ligar.
Se um domínio for recusado, consulte Regras de domínio.
Testar o início de sessão #
- Abra uma janela de navegação privada e aceda à página de início de sessão do Lingo.dev.
- Selecione Continuar com SSO, introduza o e-mail de uma pessoa a quem atribuiu acesso à aplicação e selecione Iniciar sessão.
- 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.
- 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. - 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.
- Procure e selecione Bookmark App e, em seguida, selecione Adicionar integração.
- Em Definições gerais, introduza
Lingo.devcomo 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. - No separador Atribuições do marcador, atribua acesso às mesmas pessoas ou grupos que na aplicação SAML.
- Abra a aplicação SAML do Lingo.dev. No separador Geral, selecione Editar em Definições da aplicação.
- 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.
- No Lingo.dev, gere uma chave SCIM.
- 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.
- Defina Aprovisionamento como SCIM e selecione Guardar. A aplicação passa a ter um separador Aprovisionamento.
- No separador Aprovisionamento, abra Integração e selecione Editar.
Preencha estes campos:
| Campo do Okta | Valor |
|---|---|
| URL base do conector SCIM | https://api.lingo.dev/v2/scim (o URL base de SCIM no Lingo.dev) |
| Campo do identificador único dos utilizadores | userName |
| Ações de aprovisionamento suportadas | Enviar 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ção | Cabeç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 #
- Certifique-se de que o grupo do Okta tem o mesmo nome que uma função do Lingo.dev, como
Translator. - No separador Enviar grupos da aplicação, selecione Enviar grupos e, em seguida, Procurar grupos pelo nome.
- 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 #
| Problema | Soluçã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.