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:
- 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
subpara OIDC). - 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.
- 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:
- No painel "Admin" do Looker, acesse Admin > SAML ou Admin > OpenID Connect.
- Acesse a opção Merge Users Using e selecione a caixa Looker Email/Password.
- 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_emailEspecifique o novo endereço de e-mail no corpo da solicitação. - 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:
- No painel "Admin" do Looker, acesse Admin > Users e identifique a conta original e a duplicada do usuário.
- 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.
- 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.
- Exclua a conta de usuário duplicada.
- 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 - 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:
- Use a API Looker para recuperar a lista de conteúdo e agendamentos associados ao ID do usuário duplicado.
- Chame os endpoints de atualização (como
update_dashboard,update_lookouupdate_schedule_plan) para mudar o proprietário desses recursos para o ID de usuário original. - 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.
- 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):
- Ative o Google OAuth na instância do Looker (original).
- Ative a opção Merge Users Using com a opção Looker Email/Password ativada nas configurações do Google OAuth.
- 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.
- 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.