Administração

Gerenciamento de identidade da Phrase

O conteúdo de toda a Central de Ajuda é traduzido automaticamente de inglês pelo Phrase Language AI.

Login único da plataforma

A Plataforma de Localização Phrase permite acessar os diferentes produtos Phrase por meio de uma única página de login ou cadastro. Acesse https://eu.phrase.com (para os centros de dados da UE) ou https://us.phrase.com (para o centro de dados dos EUA) para se cadastrar ou fazer login pela plataforma.

Novos usuários que se cadastram na plataforma, bem como usuários existentes da Phrase, podem navegar por todos os produtos disponíveis no painel da plataforma sem precisar se autenticar em cada um deles.

Depois de fazer login na plataforma, selecione o menu suspenso Painel no canto superior esquerdo para alternar entre os produtos contratados conforme necessário. O seletor de produtos também está disponível na interface de cada produto para todos os usuários com um perfil de usuário da plataforma.

Requisitos de acesso ao produto

  • O acesso aos produtos é definido pelo plano adquirido

  • Phrase TMS e Phrase Strings

  • Phrase Orchestrator

    • Acesso ao TMS ou ao Strings

  • Phrase Custom AI, Phrase Language AI e Phrase Analytics

Nota

Para mais informações sobre os planos da plataforma, os recursos disponíveis em cada plano e os limites de uso, visite a página de preços da Phrase.

Usuários existentes do TMS ou do Strings podem fazer login pela página de login da plataforma inserindo o nome de usuário e a senha ou por meio do SSO da plataforma.

Importante

Quando o SSO está habilitado, não é possível alterar o e-mail de um usuário na interface. Para usuários gerenciados por SCIM, as alterações de e-mail são feitas através do provedor de identidade.

Status de associação de identidade

Os usuários podem ser membros de várias organizações da Phrase e alternar entre elas conforme necessário. Para cumprir as políticas de retenção de dados, os usuários (exceto os proprietários) que são membros de uma organização, mas não têm acesso a nenhum produto, terão seus dados pessoais (por exemplo, nome e e-mail) anonimizados automaticamente após 12 meses de inatividade.

Cada usuário na plataforma Phrase tem um status de associação de identidade Interno ou Externo, com base em como sua conta foi criada e qual organização a gerencia.

  • Usuário interno

    Um usuário criado diretamente em uma organização ou provisionado via SSO/SCIM. A organização Interna (organização de origem) gerencia totalmente a identidade do usuário, incluindo informações de perfil e configurações de login.

  • Usuário externo

    Um usuário que pertence a outra organização como Interno e foi convidado para colaborar em uma organização adicional. A organização Externa pode atribuir tarefas, mas não pode editar o perfil ou as credenciais de login do usuário.

Os usuários podem ser Internos em uma organização por vez (ou em mais de uma, se elas estiverem no mesmo grupo de organizações) e podem aparecer como Externos em outras.

O status de associação é exibido na página Usuários do painel da Plataforma.

Solução de problemas de login

Em caso de problemas de login, tente estas etapas de solução de problemas:

  1. Tente o modo anônimo

    Como primeiro passo, abra uma janela anônima (modo anônimo do navegador) e tente fazer login. Se conseguir fazer login, limpe o cache, os cookies e o histórico de navegação relacionados aos sites da Phrase.

  2. Verifique as credenciais

    Se limpar os cookies e o cache não funcionar, certifique-se de que as credenciais de login corretas estejam sendo usadas.

    • Se existirem várias contas no Phrase, insira o nome de usuário em vez do endereço de e-mail.

    • Certifique-se de fazer login no centro de dados correto.

  3. Redefina a senha

    Se a senha for esquecida, clique em Esqueceu a senha? na página de login e siga o fluxo de redefinição de senha.

    Após redefinir a senha, certifique-se de que o navegador não preencha automaticamente os campos de login com credenciais desatualizadas. Confirme se o teclado está definido para o idioma correto para evitar a inserção incorreta de credenciais.

    O reCAPTCHA na página de recuperação de senha pode não carregar devido a restrições de rede regionais. Se isso acontecer, tente uma conexão de rede diferente, como uma VPN ou dados móveis. Se o reCAPTCHA ainda não carregar, entre em contato com o suporte da Phrase.

  4. Alterne entre organizações (se aplicável)

    Uma conta pode estar associada a várias organizações. Se estiver conectado à organização incorreta, mude de organização.

  5. Verifique as restrições de endereços IP confiáveis

    Um administrador pode restringir o acesso ao Phrase TMS ativando a configuração Endereços IP confiáveis em Configurações → Acesso e segurança → Acesso do usuário, limitando o login a uma lista definida de intervalos de IP permitidos. Um usuário que se conecta a partir de uma rede fora dessa lista verá um bloqueio ou erros de conexão, mesmo com as credenciais corretas.

    Se o login falhar persistentemente apesar das credenciais corretas, verifique com o administrador da organização se a rede ou o endereço IP atual está incluído na lista permitida.

Login social na plataforma

A plataforma Phrase oferece suporte ao login social por meio dos seguintes provedores sociais:

  • Google

  • Microsoft

  • GitHub

Acesse https://eu.phrase.com ou https://us.phrase.com para se cadastrar ou fazer login conectando a conta social desejada. Contas sociais legadas do TMS ou Strings também podem ser usadas para fazer login na plataforma Phrase.

Usuários conectados podem conectar ou desconectar seu perfil Phrase a um dos provedores sociais disponíveis nas configurações do perfil do usuário.

O cadastro ou login social não está disponível para usuários que foram convidados a participar de uma organização Phrase:

  • Novos usuários podem se cadastrar fornecendo nome de usuário e senha ou via SSO na página de cadastro da plataforma Phrase.

    Depois de fazer login, acesse as configurações do perfil do usuário na plataforma para ativar o login social por meio do provedor social desejado.

  • Usuários existentes que foram convidados a participar de outra organização Phrase devem redefinir a senha para aceitar o convite.

    Depois de redefinir a senha, faça login usando a conexão existente com a conta social.

SSO da plataforma

O logon único (SSO) permite que os usuários da plataforma façam login por meio de aplicativos de terceiros. A plataforma Phrase permite integrações com provedores de identidade (IdPs) compatíveis com SCIM 2.0 e o protocolo SAML 2.0 (Microsoft Entra ID, Okta, Google Workspace, etc.).

Os usuários têm acesso enquanto estiverem logados no sistema IdP da organização.

Por padrão, os usuários podem fazer login na plataforma Phrase tanto via SSO quanto por meio das credenciais existentes de nome de usuário e senha. Se necessário, o uso de SSO pode ser obrigatório para restringir a possibilidade de fazer login com nome de usuário e senha.

parâmetro uniqueID

A página de login SSO oferece suporte ao parâmetro de URL uniqueId que preenche previamente o Identificador Global Único para os usuários. Inserir uma cadeia de caracteres nesse parâmetro faz com que o campo Identificador Único seja preenchido previamente para o usuário.

Exemplo:

https://eu.phrase.com/idm-ui/signin/sso?uniqueId=YOUR_ID

Os clientes podem adicionar a URL com este parâmetro aos favoritos do navegador para não precisarem memorizar este valor de ID para iniciar o login SSO.

Habilitar SSO usando SAML 2.0

A configuração do SSO deve ser realizada por administradores de TI com acesso de administrador ao IdP escolhido. Apenas os proprietários da plataforma podem configurar o SSO na plataforma Phrase.

Após o login via SAML, o first_name e o last_name dos usuários são sempre atualizados no perfil de usuário da organização Phrase para corresponder aos respectivos valores presentes no IdP do cliente quando esses atributos estão presentes na solicitação de login SAML. Para evitar isso, recomenda-se remover esses atributos da solicitação de login SAML.

Para configurar o SSO, siga estas etapas:

  1. Selecione Configurações da organização no menu de navegação à esquerda do painel da Plataforma.

    A página Configurações da organização é aberta e a guia SSO é exibida.

  2. Selecione a guia SSO e clique em Habilitar SSO.

    A página de configuração de SSO é exibida.

  3. Preencha a seção Autorizar SSO:

    • Forneça um identificador exclusivo (por exemplo, o nome da organização ou uma string aleatória) no campo Identificador globalmente exclusivo.

      Os usuários da organização deverão usar o identificador exclusivo ao fazer login na plataforma Phrase.

    • Selecione a opção necessária no menu suspenso Tipo de identificador:

      Nome de usuário:

      Os usuários da plataforma são associados às identidades de usuário do IdP pelo nome de usuário. O atributo de formato NameID é usado para fazer a correspondência entre os usuários:

      urn:oasis:names:tc:SAML:1.1:nameid-format:unspecified

      Endereço de e-mail:

      Os usuários da plataforma são associados às identidades de usuário do IdP pelo e-mail. O atributo de formato NameID é usado para fazer a correspondência entre os usuários:

      urn:oasis:names:tc:SAML:1.1:nameid-format:emailAddress

  4. Use as informações fornecidas pelo IdP para preencher os campos obrigatórios na seção Configurar SAML no Phrase e, em seguida, clique em Salvar.

    Os campos na seção Adicionar o Phrase ao seu provedor de identidade são preenchidos automaticamente.

  5. Copie os links fornecidos na seção Adicionar o Phrase ao seu provedor de identidade e insira-os na configuração SAML do seu IdP.

Nota

É necessário assinar a resposta SAML para configurar com êxito o SSO da plataforma.

Mais informações podem ser encontradas na documentação específica do IdP (por exemplo, Opções de assinatura de certificado no Microsoft Azure AD).

Nota

O Phrase exige que as declarações SAML usem os nomes de atributo firstname, lastname e username. Alguns provedores de identidade enviam esses valores com nomes de declaração padrão diferentes. Por exemplo, um provedor de identidade envia o nome e o sobrenome do usuário com os nomes de declaração givenname e surname por padrão e não envia uma declaração username. Esses valores não são mapeados automaticamente para os nomes de atributo que o Phrase espera. Se o mapeamento de declaração não for atualizado, os usuários que aceitarem um convite receberão um erro de "atributos obrigatórios ausentes" e não conseguirão fazer login.

Para evitar isso, configure o mapeamento de declaração SAML para o aplicativo Phrase no IdP da seguinte forma:

  • Remapeie a declaração de saída que contém o primeiro nome do usuário para firstname.

  • Remapeie a declaração de saída que contém o sobrenome do usuário para lastname.

  • Adicione uma declaração username, por exemplo, mapeada para o nome principal do usuário.

O Phrase espera que os atributos SAML tenham os nomes firstname, lastname e username. Alguns provedores de identidade usam nomes padrão diferentes (por exemplo, givenname e surname) que não são mapeados automaticamente, portanto, atualize o mapeamento de declaração em seu provedor de identidade se desejar enviá-los.

O endereço de e-mail sempre vem do NameID SAML. Os usuários existentes são identificados por esse endereço, e nenhum outro atributo é verificado no login. Usuários existentes que aceitam um convite não precisam de atributos. Os outros atributos são necessários apenas da seguinte forma:

  • Novo usuário que aceita um convite: firstname e lastname. Se nenhum username for enviado, o Phrase gera um a partir do endereço de e-mail.

  • Provisionamento JIT: firstname, lastname e username.

  • Criação de usuário SCIM: username.

Se um atributo obrigatório estiver faltando, o usuário verá um erro de "atributos obrigatórios ausentes". No login SAML, o nome e o sobrenome são atualizados no perfil do usuário apenas quando ambos são enviados. Para evitar a substituição de perfis existentes, remova ambos os atributos da solicitação SAML.

Impor SSO

Selecionar Exigir que os usuários façam login com SSO força os usuários a usar o SSO para fazer login.

Exigir que os usuários façam login com SSO impede que usuários que não fizeram login via SSO anteriormente acessem a organização.

Se um colaborador externo precisar de acesso fora do SSO, selecione a opção Exigir login SSO para domínios especificados.

Opções:

  • Permitir todos os métodos de login

  • Exigir que todos os usuários façam login via logon único

  • Exigir logon único para domínios específicos

    Forneça os identificadores e o tipo de identificador e clique em Salvar.

Todos os usuários obrigados a fazer login com SSO são exibidos na página Usuários do painel da Plataforma.

Provisionamento automático de usuários

O provisionamento automático de usuários abrange apenas usuários gerenciados pela empresa no Phrase, não usuários cadastrados por conta própria.

A Plataforma Phrase oferece suporte a dois tipos de provisionamento de usuários usando recursos de SAML/SSO para automatizar o acesso aos aplicativos da Plataforma:

  • Just-in-Time (JIT)

  • SCIM

Novos usuários são criados automaticamente na organização da Plataforma assim que o acesso ao Phrase é provisionado para eles no provedor de identidade (IdP) escolhido.

Todos os novos usuários são criados como membros da organização da Plataforma relevante e não têm acesso a nenhum dos produtos por padrão. O proprietário ou administrador da organização da Plataforma precisará convidá-los para o produto necessário separadamente.

Se necessário, a atribuição padrão de produto e função pode ser modificada ao configurar o provisionamento automático nas configurações da organização da Plataforma.

Os usuários criados devem confirmar seu vínculo com a organização. Para fazer isso, um e-mail com um link de verificação é enviado ao usuário provisionado. Antes da verificação, o usuário não tem permissão para fazer login com SSO.

Nota

Para dispensar a confirmação do vínculo, entre em contato com o Gerente de Sucesso do Cliente dedicado.

Usuários provisionados não têm permissão para alterar suas credenciais do Phrase, pois elas são gerenciadas no IdP.

Quando um usuário é desprovisionado por meio do IdP e, consequentemente, removido de sua última organização no Phrase, sua conta inicia automaticamente um período de retenção de 30 dias. Durante este período de carência, a identidade não é excluída imediatamente, permitindo a restauração caso a remoção tenha sido acidental.

Configurar o Provisionamento Automático

Para habilitar ou desabilitar o provisionamento automático, é necessária a colaboração com o Suporte Técnico da Phrase para garantir a configuração adequada e evitar possíveis problemas, como contas duplicadas ou usuários não atribuídos.

Para facilitar a configuração e o gerenciamento contínuo dos usuários, recomendam-se as seguintes práticas:

  1. Comece com um teste em pequena escala.

    Antes de implementar o provisionamento automático para toda a organização, recomenda-se provisionar um pequeno grupo de usuários para verificar se tudo está funcionando corretamente.

  2. Atribua todos os usuários por meio do provedor de identidade (IdP).

    Após um teste bem-sucedido, atribua todos os usuários ao aplicativo Phrase por meio do IdP. Em seguida, o SCIM automatizará o provisionamento e as atualizações de usuários em toda a organização.

  3. Converta usuários existentes em usuários gerenciados pela empresa.

    Entre em contato com o Suporte Técnico da Phrase para converter os usuários atuais em usuários gerenciados pela empresa. O SCIM só pode atualizar e excluir usuários marcados como gerenciados pela empresa, tornando esta etapa essencial.

    Antes da conversão, confirme se o e-mail, o nome de usuário, o nome e o sobrenome de cada identidade Phrase existente correspondem exatamente aos respectivos valores no provedor de identidade. Incompatibilidades de atributos impedem que o SCIM vincule ou atualize as identidades corretamente.

  4. Atribua à organização, por meio do IdP, os usuários adicionados antes da ativação do provisionamento automático SCIM.

    Usuários adicionados antes de habilitar o provisionamento automático SCIM devem ser atribuídos à organização por meio do IdP. Se eles não forem atribuídos, poderão ser excluídos durante a sincronização SCIM.

Provisionamento Just-in-Time (JIT)

O provisionamento Just-in-Time (JIT) é um método baseado no protocolo SAML usado para criar usuários quando eles fazem login pela primeira vez em um aplicativo por meio do SAML SSO. Isso elimina a necessidade de provisionar usuários ou criar contas de usuário manualmente, e todos os usuários criados têm acesso automático aos produtos daquela organização.

A configuração de provisionamento JIT deve ser realizada por administradores de TI com acesso de administrador ao IdP escolhido.

Para configurar o provisionamento JIT via SAML SSO, siga estas etapas:

  1. Selecione Configurações da organização no menu de navegação à esquerda no painel da Plataforma.

    A página Configurações da organização é aberta e a guia SSO é apresentada.

  2. Selecione a guia SSO.

    A página de configuração de SSO é exibida.

  3. Role para baixo até Configuração de provisionamento automático e selecione Contatar suporte para habilitar as opções de configuração.

    Nota

    O provisionamento automático SAML e SCIM não podem ser habilitados ao mesmo tempo.

  4. Assim que as configurações forem habilitadas, selecione Provisionamento automático SAML (Just in time) no menu suspenso Provisionamento automático.

  5. Selecione o tipo de Gerenciamento de funções.

    • Padrão atribui acesso a todos os produtos da Phrase com funções padrão no momento do provisionamento.

    • Personalizado permite selecionar uma função para produtos específicos da Phrase que será aplicada a todos os novos usuários no momento do provisionamento.

      Se a função do usuário estiver vazia, os usuários não serão provisionados para o produto.

  6. Use os atributos na tabela Declarações de atributo para mapear atributos do IdP para dados no Phrase.

    Isso é necessário para garantir que os dados dos usuários estejam alinhados entre os dois sistemas.

  7. Clique em Gravar.

    A configuração é salva.

Provisionamento SCIM

O protocolo SCIM é um padrão de nível de aplicativo que permite o gerenciamento e a troca seguros de dados de identidade entre domínios.

Funcionalidade SCIM suportada:

  • Criar usuário gerenciado pela empresa

    • O usuário é provisionado para todos os aplicativos ativos na organização à qual pertence na Plataforma.

    • O usuário tem a função de Linguista no Phrase TMS e a função de Tradutor no Phrase Strings.

      Se necessário, a atribuição padrão de produto e função pode ser modificada ao configurar o provisionamento automático nas configurações da organização da Plataforma.

    • Uma identidade de usuário criada por SCIM não pode ser mesclada com uma existente. Apenas identidades novas são suportadas.

    • Uma identidade provisionada por SCIM não pode ingressar em uma organização diferente com o mesmo endereço de e-mail, a menos que a segunda organização pertença ao mesmo cliente. Nesse caso, entre em contato com o Suporte da Phrase para solicitar um grupo de organizações; uma vez configurado, o SCIM provisiona a identidade para qualquer organização dentro desse grupo. Se a segunda organização pertencer a um cliente diferente, envie o convite para um endereço de e-mail diferente, ou um alias do endereço, para criar um perfil separado para a nova organização.

  • Editar atributos do usuário gerenciado pela empresa

    A edição de atributos no IdP é refletida na Plataforma Phrase.

  • Excluir usuário gerenciado pela empresa

    • Quando o IdP envia uma solicitação de exclusão de usuário, a associação desse usuário é removida da organização Phrase. Se for a última organização à qual ele pertence, a conta entra em um período de retenção de 30 dias antes da exclusão permanente.

    • Se um usuário gerenciado por SCIM for membro de várias organizações, a solicitação de exclusão de uma organização removerá sua associação dessa organização. Somente após receber uma solicitação de exclusão da última organização da qual ele é membro, a contagem regressiva de exclusão de 30 dias começará.

Configurar provisionamento SCIM

Nota

Devido a melhorias constantes, a interface do usuário pode não ser exatamente a mesma que é apresentada no vídeo.

A configuração do SCIM deve ser realizada por administradores de TI com acesso de administrador ao IdP escolhido.

Para configurar as propriedades do SCIM, siga estas etapas:

  1. Selecione Configurações da organização no menu de navegação à esquerda no painel da Plataforma.

    A página Configurações da organização é aberta e a guia SSO é apresentada.

  2. Selecione a guia SSO.

    A página de configuração de SSO é exibida.

  3. Role para baixo até Configuração de provisionamento automático e selecione Contatar suporte para habilitar as opções de configuração.

    Nota

    O provisionamento automático SAML e o SCIM não podem ser habilitados ao mesmo tempo.

  4. Assim que as configurações forem habilitadas, selecione SCIM no menu suspenso Provisionamento automático.

    Os detalhes da configuração do SCIM são apresentados.

  5. Configure a autenticação conforme descrito abaixo.

  6. Copie a URL base do SCIM v2 e as credenciais geradas. Esses dados são usados nas configurações do IdP.

  7. Selecione o tipo de Gerenciamento de funções.

    • Padrão atribui acesso a todos os produtos da Phrase com funções padrão no momento do provisionamento.

    • Personalizado permite selecionar uma função para produtos específicos da Phrase que será aplicada a todos os novos usuários no momento do provisionamento.

    • O SCIM permite configurar o acesso ao produto e a função por usuário com base nas informações definidas no IdP durante o provisionamento.

  8. Selecione o tipo de Política de exclusão.

    • Desativação de usuário

    • Exclusão definitiva

  9. Clique em Gravar.

    A configuração é salva.

Autenticação SCIM

O Phrase suporta três opções de autenticação para solicitações SCIM de um provedor de identidade (IdP). Selecione uma em Configurações da organização > SSO > Configuração de provisionamento automático > Autenticação SCIM.

SCIM_authentication_options.png

Opção

Quando usar

OAuth2 (recomendado)

O IdP suporta a concessão de credenciais do cliente OAuth 2.0, por exemplo, Okta OAuth 2 ou Microsoft Entra ID Concessão de credenciais do cliente OAuth2. O OAuth2 usa tokens de acesso de curta duração e o segredo nunca é enviado com as solicitações SCIM.

Bearer v2

O IdP suporta apenas um token Bearer estático (Cabeçalho HTTP ou Token Secreto).

Legado

Disponível apenas para configurações existentes. Migre para OAuth2 ou Bearer v2.

Importante

A geração de credenciais Bearer v2 ou OAuth2 impede que o endpoint SCIM legado aceite solicitações para a organização. Atualize a configuração no IdP imediatamente. Não é possível voltar à opção Legado.

Configurar OAuth2

Para configurar o OAuth2, siga estas etapas:

  1. Certifique-se de que o SSO esteja ativado e o provisionamento SCIM esteja ativado (entre em contato com o Suporte da Phrase para ativar o SCIM).

  2. Em Autenticação SCIM, selecione OAuth2 e clique em Gerar credenciais.

  3. Copie o ID do cliente e o Segredo do cliente.

    O Segredo do cliente é exibido apenas uma vez. Armazene-o com segurança.

  4. Copie a URL base do SCIM v2, por exemplo https://eu.phrase.com/idm/scim/v2/<id>.

  5. No IdP, configure o aplicativo SCIM com estes valores:

    • URL base do conector SCIM: a URL base SCIM v2 da etapa 3

    • Modo de autenticação: Credenciais de cliente OAuth 2.0

    • URL do endpoint de token: https://eu.phrase.com/idm/oauth/token para o data center da UE ou https://us.phrase.com/idm/oauth/token para o data center dos EUA

    • ID do cliente e Segredo do cliente: os valores da etapa 2, enviados no corpo da solicitação (client_secret_post)

    • Escopo: deixe vazio

  6. Clique em Salvar no Phrase e teste a conexão no IdP.

Os tokens de acesso são válidos por 4 horas. Quando o token atual expira, o IdP solicita um novo com o ID do cliente e o Segredo do cliente.

Nota

O Phrase não emite tokens de atualização.

Configurar Bearer V2

Para configurar o Bearer v2, siga estas etapas:

  1. Certifique-se de que o SSO esteja ativado e o provisionamento SCIM esteja ativado (entre em contato com o Suporte da Phrase para ativar o SCIM).

  2. Em Autenticação SCIM, selecione Bearer v2 e clique em Gerar credenciais.

  3. Copie o token gerado e a URL base do SCIM v2.

    O token é exibido apenas uma vez. Armazene-o com segurança.

  4. No IdP, insira a URL base do SCIM v2, selecione Cabeçalho HTTP ou Token Bearer como método de autenticação e insira o token copiado.

  5. Clique em Gravar.

Fazer a rotação ou alterar as credenciais
  • Clicar em Gerar credenciais novamente cria novas credenciais e invalida imediatamente as anteriores. Não há período de sobreposição. Atualize o IdP logo após a regeneração para evitar falhas no provisionamento.

  • Alternar entre Bearer v2 e OAuth2 invalida as credenciais e os tokens de acesso ativos do método anterior.

  • Desativar o SCIM mantém as credenciais, mas o Phrase rejeita todas as solicitações SCIM até que o SCIM seja ativado novamente.

Solução de problemas
  • 401 “Token de autorização não válido.” em solicitações SCIM.

    Causas possíveis:

    • A credencial está incorreta ou foi regenerada.

    • O token de acesso expirou.

    • A URL base pertence a uma organização diferente.

    • O SCIM ou o SSO está desativado.

  • 400 invalid_client do endpoint do token: O ID do cliente ou o Segredo do cliente está incorreto, ou as credenciais foram regeneradas.

Nota

Erros comuns de provisionamento SCIM se enquadram em algumas categorias.

Uma conta de usuário criada manualmente ou por meio da sincronização de usuários, em vez de via SCIM, não pode ser assumida posteriormente pelo SCIM. A solicitação de atualização do provedor de identidade é rejeitada com um erro como "Identity is not managed by organization". Trazer uma conta existente desse tipo para o gerenciamento SCIM requer uma etapa de migração suportada; a conta não pode ser reivindicada apenas por uma atualização SCIM posterior.

Uma identidade provisionada por SCIM pode ser enviada para apenas uma organização sob um determinado endereço de e-mail, a menos que as organizações pertençam ao mesmo cliente e estejam configuradas como um grupo de organizações. Se a mesma pessoa tiver contas não relacionadas em duas organizações diferentes com o mesmo endereço de e-mail, as solicitações de envio SCIM de uma ou ambas as organizações falharão. Para organizações pertencentes a clientes diferentes, cada pessoa precisa de uma conta separada por organização, usando um endereço de e-mail ou alias distinto para cada uma; para organizações no mesmo grupo, entre em contato com o Suporte da Phrase para que sejam configuradas como um grupo de organizações, de modo que uma única identidade possa ser provisionada para todas elas.

O SCIM gerencia apenas a conta de origem (Interna) do usuário em uma organização. Uma associação Externa, na qual a organização de origem da conta é diferente da organização que realiza o envio SCIM, não pode ser atualizada nem gerenciada pela configuração SCIM dessa organização.

Configurar o gerenciamento de funções SCIM

Quando o SCIM é usado, a atribuição de funções e o acesso ao produto podem ser definidos diretamente na solicitação de provisionamento do IdP usando o atributo roles.

Cada entrada no array roles da solicitação User Create do SCIM deve conter:

  • Um type, indicando o produto de destino (deve começar com phrase__)

  • Um value, especificando o nome exato da função para esse produto

Exemplo de solicitação SCIM

"roles": [
  { "type": "phrase__platform", "value": "MEMBER" },
  { "type": "phrase__tms", "value": "ADMIN" },
  { "type": "phrase__strings", "value": "none" }
]
  • A função phrase__platform é obrigatória.

  • Use none para excluir o acesso a um produto.

  • Todas as funções devem corresponder às funções configuradas e disponíveis no produto da Phrase correspondente (). A função Phrase Portal não é configurável e é inferida automaticamente da função do usuário no TMS.

  • Os nomes das funções diferenciam maiúsculas de minúsculas. Recomenda-se o uso de letras maiúsculas.

  • Solicitações sem campos obrigatórios ou que incluam funções inválidas falharão.

Se precisar de assistência ao configurar o provisionamento baseado em função SCIM ou ao solucionar erros de configuração, entre em contato com o Arquiteto de Soluções designado.

Exemplo de configuração no Okta

Para configurar o provisionamento de funções SCIM no Okta, siga estas etapas:

  1. Crie atributos personalizados para cada produto da Phrase:

    • phrase__platform

    • phrase__tms

    • phrase__strings

  2. Defina valores de função válidos para cada atributo.

  3. Mapeie esses atributos para o aplicativo SCIM no Okta.

  4. Use lógica condicional, se necessário, para mapear funções dinamicamente com base no perfil do usuário ou na associação ao grupo.

  5. Aplique mapeamentos apenas durante a criação do usuário.

    Nota

    Não há suporte para atualizar as funções de usuários existentes via SCIM.

Valores de função suportados por produto

Os valores de função diferenciam maiúsculas de minúsculas. O valor enviado pelo IdP deve corresponder exatamente a um dos seguintes, incluindo o uso de maiúsculas e minúsculas. O prefixo phrase__<product> em si não diferencia maiúsculas de minúsculas.

  • Platform (phrase__platform): MEMBER, ADMIN

  • TMS (phrase__tms): LINGUIST, PROJECT_MANAGER, ADMIN, GUEST, SUBMITTER, PORTAL_MEMBER

  • Strings (phrase__strings): Owner, Admin, ProjectManager, Developer, Designer, Translator, Guest

  • Studio (phrase__studio): PROPRIETÁRIO, ADMINISTRADOR, MEMBRO

Migrar do SSO legado

Importante

A partir de 4 de março de 2025, as páginas de login do SSO legado do TMS e do Strings serão descontinuadas. Para garantir acesso ininterrupto aos produtos da Phrase, todas as organizações que usam SSO legado devem migrar para o SSO da Plataforma.

A migração para o SSO da Plataforma requer acesso administrativo ao provedor de identidade (IdP). A colaboração com a equipe de TI é essencial para configurar uma nova integração de SSO da Plataforma no IdP.

Cada organização da Phrase pode integrar-se a apenas um IdP. Se vários IdPs forem usados, selecione um para a configuração do SSO da Plataforma antes da migração.

Etapas de migração

  1. Configure o SSO da Plataforma no IdP (Okta, Azure, TrustBuilder ou outros IdPs).

    • Para evitar confusão entre os usuários, configure o identificador globalmente exclusivo no SSO da Plataforma para que corresponda ao usado no SSO legado.

  2. Convide os usuários e grupos existentes na integração de SSO legado para a nova integração de SSO da Plataforma no IdP.

  3. Comunique as alterações no fluxo de login:

    • Os usuários devem usar a página de login da Plataforma:

    • Ao fazer login por meio de um ícone no painel do IdP, os usuários devem selecionar o ícone atualizado do SSO da Plataforma.

    • As credenciais do usuário (e-mail/nome de usuário) permanecem inalteradas.

Assim que a migração for concluída, todo o conteúdo e as funções de usuário existentes no Phrase TMS e no Phrase Strings permanecerão inalterados.

Como resolver problemas de login por SSO quando o mesmo e-mail é usado em várias contas

Quando o identificador de E-mail é usado, o Phrase compara o e-mail enviado pelo provedor de identidade com as contas que são membros ativos da organização cuja configuração de SSO está sendo usada. Contas com o mesmo e-mail em outras organizações não são consideradas.

Se exatamente uma conta correspondente for encontrada, o login será realizado nessa conta. Se nenhuma conta correspondente for encontrada, o login falhará com um erro de "identidade não encontrada", a menos que o provisionamento just-in-time (JIT) esteja habilitado para a organização. Se mais de uma conta correspondente for encontrada dentro da mesma organização, o login falhará porque o e-mail não é exclusivo dentro dessa organização.

Contas com o mesmo e-mail em organizações diferentes não entram em conflito.

Configurações recomendadas:

  • Uma conta por organização, com o mesmo e-mail: funciona sem alterações — use o identificador de E-mail. Nenhuma alteração é necessária no provedor de identidade.

  • Um e-mail diferente por organização: use um alias por organização e configure o provedor de identidade para enviar esse alias para o aplicativo correspondente. O e-mail no Phrase deve corresponder exatamente ao que o provedor de identidade envia.

  • Duas contas na mesma organização (por exemplo, uma conta de Administrador e uma conta de Gerente de Projetos): use um usuário separado no provedor de identidade para cada conta, ou o identificador de Nome de usuário com um nome de usuário distinto por conta.

Se você preferir uma única conta e um único login em todas as organizações, entre em contato com o Suporte da Phrase. Contas pertencentes à mesma pessoa em organizações diferentes podem ser mescladas em uma única conta que seja membro de todas elas. A mesclagem não está disponível para identidades criadas via SCIM.

Se o provisionamento JIT estiver habilitado para uma organização e um usuário que tenta fazer login via SSO ainda não for membro dessa organização, o SSO cria uma nova conta usando o e-mail fornecido. Convide membros existentes para a organização antes de habilitar o SSO para evitar a criação indesejada de contas.

Esse artigo foi útil?
★ ★ ★ ★ ★

Sorry about that! In what way was it not helpful?

The article didn’t address my problem.
I couldn’t understand the article.
The feature doesn’t do what I need.
Other reason.

Note that feedback is provided anonymously so we aren't able to reply to questions.
If you'd like to ask a question, submit a request to our Support team.
Thank you for your feedback.