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 #
- Entre 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 Criar integração de aplicativo.
- Escolha SAML 2.0 e selecione Avançar.
- 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 Okta | Valor |
|---|---|
| URL de login único | https://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 destino | Selecionado |
| 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ão | Vazio |
| Formato do ID de nome | Endereço de e-mail |
| Nome de usuário do aplicativo |
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 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 #
- Abra a aba Atribuições do aplicativo.
- Selecione Atribuir e depois Atribuir a pessoas ou Atribuir a grupos.
- 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 #
- Abra Configurações → SSO.
- Cole a URL de metadados do Okta em URL de metadados do provedor de identidade.
- Em Domínios de e-mail, digite os domínios de e-mail da sua empresa, separados por vírgulas.
- Selecione Conectar.
Se um domínio for recusado, consulte Regras de domínio.
Testar o login #
- Abra uma janela de navegação privativa e acesse a página de login do Lingo.dev.
- Selecione Continuar com SSO, digite o e-mail de uma pessoa atribuída ao aplicativo e selecione Entrar.
- 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.
- 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. - 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.
- Busque Aplicativo de favorito, selecione-o e depois selecione Adicionar integração.
- Em Configurações gerais, digite
Lingo.devcomo 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. - Na aba Atribuições do favorito, atribua as mesmas pessoas ou grupos que você atribuiu ao aplicativo SAML.
- Abra o aplicativo SAML do Lingo.dev. Na aba Geral, selecione Editar em Configurações do aplicativo.
- 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.
- No Lingo.dev, gere uma chave SCIM.
- No Console de administração do Okta, abra o aplicativo SAML do Lingo.dev. Na aba Geral, selecione Editar em Configurações do aplicativo.
- Defina Provisionamento como SCIM e selecione Salvar. A aba Provisionamento será adicionada ao aplicativo.
- Na aba Provisionamento, abra Integração e selecione Editar.
Preencha estes campos:
| Campo do Okta | Valor |
|---|---|
| URL base do conector SCIM | https://api.lingo.dev/v2/scim (a URL base do SCIM no Lingo.dev) |
| Campo de identificador exclusivo dos usuários | userName |
| Ações de provisionamento compatíveis | Enviar 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ção | Cabeç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 #
- Verifique se o grupo do Okta tem o mesmo nome de uma função do Lingo.dev, como
Translator. - Na aba Enviar grupos do aplicativo, selecione Enviar grupos e depois Localizar grupos por nome.
- 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 #
| Problema | Soluçã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.