Solução de problemas com contas duplicadas na mudança de e-mail

Este guia ajuda a solucionar e resolver contas de usuário duplicadas que o Looker cria quando o endereço de e-mail principal de um usuário muda no provedor de identidade (IdP), como o Azure Active Directory (Azure AD).

Antes de começar a solução de problemas, determine se a instância é do Looker (original) (hospedada ou auto-hospedada) ou do Looker (Google Cloud Core), porque elas oferecem suporte a diferentes opções de mesclagem de usuários:

  • Looker (original): oferece suporte a credenciais locais de e-mail e senha. Essa opção permite mesclar usuários por correspondência de e-mail quando identificadores exclusivos do IdP mudam.
  • Looker (Google Cloud Core): não oferece suporte a login local de e-mail e senha ou credenciais de e-mail. Por isso, não é possível mesclar usuários usando a opção de credenciais de e-mail e senha no Looker (Google Cloud Core).

Instâncias do Looker (original)

Use a árvore de decisões a seguir para solucionar problemas de mudanças de e-mail em instâncias do Looker (original):

As seções a seguir descrevem os cenários na árvore com mais detalhes.

Configurar as definições do provedor de identidade

Para evitar contas duplicadas quando os endereços de e-mail dos usuários mudam, configure o IdP para declarar um identificador exclusivo imutável:

  1. No IdP (como o Azure AD), encontre as configurações de mapeamento de identificador exclusivo (por exemplo, o atributo Unique User Identifier (Name ID) para SAML ou a declaração sub para OIDC).
  2. Configure esse atributo para mapear para um atributo de usuário imutável (como um ID de funcionário ou um UUID de banco de dados) em vez de um endereço de e-mail mutável.
  3. Salve as configurações. Como o identificador exclusivo permanece constante quando o endereço de e-mail muda, o Looker reconhece o usuário atual e atualiza o e-mail automaticamente no próximo login sem criar uma conta duplicada.

Evitar duplicados

Se você usar um endereço de e-mail mutável como identificador exclusivo no Looker (original) e não puder mudá-lo para um atributo imutável, siga estas etapas para configurar o Looker para mesclar usuários com base na correspondência de e-mail:

  1. No painel "Admin" do Looker, acesse Admin > SAML ou Admin > OpenID Connect.
  2. Acesse a opção Merge Users Using e selecione a caixa Looker Email/Password.
  3. Antes que o usuário faça login com o novo endereço de e-mail, crie uma credencial de e-mail do Looker na conta de usuário atual que corresponda ao novo endereço de e-mail. Use o endpoint de API do Looker create_user_credentials_email: POST /api/4.0/users/<var>USER_ID</var>/credentials_email Especifique o novo endereço de e-mail no corpo da solicitação.
  4. Peça ao usuário para fazer login. O Looker vai corresponder o novo e-mail declarado pelo IdP à credencial de e-mail pré-criada e mesclar as contas.

Limpar duplicados

Se o endereço de e-mail já tiver sido alterado e houver contas de usuário duplicadas, siga estas etapas para limpar e mesclar as contas:

  1. No painel "Admin" do Looker, acesse Admin > Users e identifique a conta original e a duplicada do usuário.
  2. Determine se a conta duplicada tem conteúdo ou agendamentos gerados pelo usuário que você precisa manter. Em caso afirmativo, siga as etapas na seção Migrar conteúdo duplicado.
  3. Nas configurações do SAML ou OIDC do Looker, verifique se a opção Merge Users Using tem a opção Looker Email/Password ativada.
  4. Exclua a conta de usuário duplicada.
  5. Na API do Looker, crie uma credencial de e-mail do Looker na conta de usuário original que use o novo endereço de e-mail: POST /api/4.0/users/<var>USER_ID</var>/credentials_email
  6. Instrua o usuário a fazer login usando SAML ou OIDC. O Looker vai mesclar as credenciais de login na conta de usuário original.

Migrar conteúdo duplicado

Se a conta duplicada contiver conteúdo gerado pelo usuário, itens de pastas pessoais, Looks, painéis ou agendamentos, você poderá migrá-los para a conta original antes de excluir a duplicada:

  1. Use a API Looker para recuperar a lista de conteúdo e agendamentos associados ao ID do usuário duplicado.
  2. Chame os endpoints de atualização (como update_dashboard, update_look ou update_schedule_plan) para mudar o proprietário desses recursos para o ID de usuário original.
  3. Como alternativa, você pode usar ferramentas como o Admin Power Pack de código aberto do Looker para realizar migrações em massa de conteúdo do usuário.
  4. Depois de transferir o conteúdo, exclua a conta de usuário duplicada.

Instâncias do Looker (Google Cloud Core)

O Looker (Google Cloud Core) não oferece suporte a credenciais de e-mail ou mesclagem de e-mail e senha. Use a árvore de decisões a seguir para processar mudanças de e-mail no Looker (Google Cloud Core):

As seções a seguir descrevem os cenários na árvore com mais detalhes.

Etapas de pré-migração

Se você estiver se preparando para migrar de uma instância do Looker (original) para o Looker (Google Cloud Core), siga estas etapas para converter os usuários em um método de autenticação com suporte do Core (como o Google OAuth):

  1. Ative o Google OAuth na instância do Looker (original).
  2. Ative a opção Merge Users Using com a opção Looker Email/Password ativada nas configurações do Google OAuth.
  3. Instrua todos os usuários a fazer login usando o Google OAuth na instância do Looker (original) para mesclar as contas antes da migração.
  4. Realize a migração para o Looker (Google Cloud Core).

Etapas pós-migração

Se a migração para o Looker (Google Cloud Core) tiver sido concluída e ainda houver contas duplicadas, realize uma das seguintes tarefas:

  • Se a instância do Looker (original) ainda estiver acessível: Entre em contato com o Google Cloud suporte para restaurar a instância, siga as etapas de mesclagem do Google OAuth na instância original e refaça a migração para o Looker (Google Cloud Core).
  • Se a instância do Looker (original) não estiver acessível: você precisa migrar manualmente o conteúdo gerado pelo usuário usando scripts da API Looker das contas antigas dos usuários para as novas e, em seguida, excluir as contas antigas ou duplicadas.

Revisão final e suporte

Se você ainda não conseguir resolver o problema de contas duplicadas, entre em contato com o suporte.