A página Usuários na seção Usuários do painel Administrador lista todas as contas de usuário na sua instância do Looker.
Como visualizar e pesquisar usuários
A página Usuários mostra as seguintes informações:

Os grupos de guias agrupam os usuários por tipo:
- A guia Usuários padrão mostra os usuários que fazem login diretamente no Looker, seja pelo processo de autenticação normal ou pela API Looker.
- A guia Usuários incorporados mostra os usuários de incorporação assinada que são autenticados por um aplicativo de terceiros.
- A guia Contas de serviço mostra as contas de serviço somente de API que são autenticadas pela API Looker usando chaves de API.
- A guia Suporte do Looker mostra os analistas de suporte do Looker que receberam acesso à sua instância do Looker.
O campo Filtrar lista limita os usuários mostrados. É possível filtrar por ID do usuário, nome ou endereço de e-mail. Para filtrar por ID do usuário, insira um ID para mostrar esse usuário. Para nome e endereço de e-mail, quando você digita qualquer string, a lista de usuários exibida mostra todos os usuários cujo nome ou endereço de e-mail contém a string inserida no campo de filtro. A Lista de filtros substitui a função de pesquisa na versão anterior da página Usuários.
Clique no cabeçalho da coluna Usuário para classificar a tabela por nome de usuário em ordem crescente ou decrescente.
Cada linha lista o nome, o ID e o endereço de e-mail do usuário e inclui um ícone que indica o tipo de acesso que ele tem. Mantenha o cursor sobre o ícone para ver o que ele representa.
Clique na linha para editar o usuário. Os usuários que não podem ser editados são indicados por um cadeado no ícone do usuário. Esses usuários são criados pelo sistema (como membros do grupo Todos os usuários) ou gerenciados externamente pelo protocolo LDAP, SAML ou OpenID Connect.
A coluna Credencial ativa lista os tipos de acesso que o usuário tem à sua instância do Looker. Essa coluna aparece apenas na guia Usuários padrão.
A coluna Grupos lista todos os grupos a que o usuário pertence.
A coluna Papéis lista todos os papéis atribuídos ao usuário.
Clique no botão Adicionar para criar novos usuários e contas de serviço.
Clique no menu de três pontos Opções para desativar o usuário, usar o comando sudo como o usuário ou excluir o usuário.
Adicionar usuários padrão
Para adicionar um usuário padrão, siga estas etapas:
- Clique no botão Adicionar para abrir um menu suspenso.
- Clique no item de menu Usuários para abrir a página Adicionar novos usuários.
- Na página Adicionar um novo usuário, digite ou cole uma lista separada por vírgulas de endereços de e-mail no campo Endereços de e-mail.
- No campo Grupos, selecione os grupos que serão atribuídos aos usuários. Para ver a lista de grupos, comece a digitar no campo Grupos. Todos os nomes de grupos que incluem esse texto vão aparecer.
- No campo Papéis, selecione os papéis que serão atribuídos aos usuários.
- Clique no botão Salvar para criar os usuários e, se você tiver marcado a caixa de seleção Enviar e-mails de configuração, para enviar e-mails de inscrição.
Como criar uma conta de serviço somente de API
É possível criar contas somente de API (geralmente chamadas de contas de serviço) na página Usuários em uma instância do Looker. Essas contas podem receber o papel de administrador do Looker e as credenciais da API Looker. No entanto, essas contas não podem fazer login no Looker pela UI.
A prática recomendada é criar contas de serviço dedicadas para scripts de API, uma para cada script. Dessa forma, é possível configurar uma conta de serviço com o conjunto específico de permissões que permite que o script execute a função dele e apenas essa função. Por exemplo, para um script de API que executa consultas, é possível criar uma conta de serviço com a permissão access_data, mas nenhuma outra.
As contas de serviço dedicadas para scripts de API permitem aumentar a segurança compartimentando o acesso de um script. Além disso, se você precisar interromper um script, poderá desativar (ou excluir) a conta de serviço dele. Leia a seção Como remover o acesso do usuário nesta página antes de excluir qualquer conta de usuário.
As contas de serviço usam licenças de acordo com os papéis que têm. Se uma conta de serviço receber vários papéis, ela vai consumir uma licença do nível mais alto disponível entre esses papéis. Por exemplo, se uma conta de serviço tiver as permissões de Leitor e Desenvolvedor, ela vai usar uma licença de Desenvolvedor.
Para adicionar uma conta de serviço, siga estas etapas:
- Clique no botão Adicionar para abrir um menu suspenso.
- Clique no item de menu Conta de serviço para abrir a página Adicionar uma nova conta de serviço.
- No campo Nome da conta de serviço, insira um nome para a conta de serviço.
- A chave Criar conjunto padrão de credenciais da API está ativada por padrão. Se você não quiser que as credenciais de API sejam criadas para a conta, clique no botão para desativar essa opção.
- Selecione os Grupos e os Papéis que serão atribuídos à conta de serviço.
- Clique no botão Salvar.
É possível ver e editar as contas de serviço na guia Contas de serviço da página Usuários. Para editar uma conta de serviço, clique na linha dela para exibir a página Editar usuário. Na página Editar usuário, você pode fazer o seguinte:
- Ativar ou desativar a conta de serviço
- Editar o nome da conta de serviço
- Gerenciar as chaves de API da conta de serviço
- Atribuir diferentes grupos e papéis
- Edite os atributos de usuário associados à conta de serviço.
Como migrar contas de usuário para contas de serviço
Nas instâncias do Looker (original), algumas contas de usuário padrão podem ser migradas para contas de serviço somente de API. Para se qualificar para a migração, a conta de usuário padrão precisa atender a todos os seguintes critérios:
- A conta não usa um provedor de identidade, como o Google, SAML ou OpenID Connect, como método de autenticação no Looker.
- A conta não tem uma senha configurada para as credenciais de e-mail.
- O usuário não fez login na instância do Looker nos últimos sete dias.
O Looker sinaliza os usuários padrão que atendem a esses critérios na coluna Usuário da guia Usuários padrão na página Usuários. Além disso, um banner aparece na parte de cima da página Usuários para indicar que alguns usuários padrão são possíveis contas de serviço.
Se uma conta de usuário padrão atender aos critérios de migração, as duas opções a seguir estarão disponíveis para migrar uma conta padrão para uma conta de serviço:
A opção Migrar aparece no menu de três pontos Opções na linha da conta de usuário qualificada. Selecione esse item de menu para abrir a caixa de diálogo Migrar usuário. Clique em Migrar para migrar o usuário. Clique em Cancelar para sair da caixa de diálogo sem migrar.
Clique na linha da conta de usuário qualificada para acessar a página Editar usuário. Na parte de baixo da página Editar usuário, clique no botão Migrar. Na caixa de diálogo que aparece, clique em OK para confirmar a migração ou em Cancelar para sair da caixa de diálogo sem migrar.
Se uma conta de usuário não atender aos critérios de migração, as opções de migração não serão mostradas para esse usuário. No entanto, se um usuário tiver um login com e-mail e senha configurado (indicado por um botão Enviar link de redefinição em vez de Enviar link de configuração), o Looker vai exigir sete dias consecutivos de inatividade para acionar automaticamente o prompt de migração. Os administradores podem usar o endpoint de API DELETE /users/{user_id}/credentials_email para remover a credencial de e-mail, o que vai qualificar imediatamente a conta para migração e ignorar o requisito de inatividade de sete dias.
A migração de uma conta de usuário para uma conta de serviço não cria credenciais de API, mas as credenciais de API associadas à conta de usuário serão migradas para a conta de serviço.
Como editar usuários
Para editar um usuário, clique na linha dele. Na página Editar usuário, ajuste as seguintes configurações conforme necessário.
Conta
Ativar ou desativar a conta de um usuário. Considere desativar a conta de usuário em vez de excluí-la. Esse campo aparece apenas para usuários padrão e contas de serviço.
Nome
Adicione ou edite o nome do usuário, se aplicável. Esse campo não exige um valor, mas pode ser útil para fins organizacionais. Esse campo aparece apenas para usuários padrão e incorporados.
Sobrenome
Adicione ou edite o sobrenome do usuário, se aplicável. Esse campo não exige um valor, mas pode ser útil para fins organizacionais. Esse campo aparece apenas para usuários padrão e incorporados.
Nome da conta de serviço
Edite o nome da conta de serviço. Este campo aparece apenas para contas de serviço.
Adicione ou edite o endereço de e-mail do usuário. Quando o usuário faz login no Looker, o endereço de e-mail serve como nome de usuário. Este campo aparece apenas para usuários padrão.
Localidade
O campo Localidade define o idioma da interface do usuário e a localidade do modelo para um usuário. Este campo aparece apenas para usuários padrão.
Se você quiser que o usuário veja determinados textos da interface do usuário (UI) em um idioma específico, o Looker oferece suporte às traduções da UI mostradas na tabela a seguir. Insira o código no campo Localidade.
Se você quiser que o usuário veja uma versão localizada de um ou mais modelos de dados, insira o título do arquivo de strings do modelo para essa localidade no campo Localidade.
Se você quiser que o usuário veja tanto a localização do modelo quanto as traduções da UI integrada do Looker, o arquivo de strings do modelo precisa ter o mesmo nome do código de localidade apropriado na tabela a seguir, e esse código precisa ser inserido no campo Localidade.
Para confirmar a configuração de Localidade, clique em Salvar na parte de baixo da página.
| Idioma | Código de localidade e nome do arquivo de strings |
|---|---|
| Inglês | en |
| Tcheco | cs_CZ |
| Alemão | de_DE |
| Espanhol (Espanha) | es_ES |
| Finlandês | fi_FI |
| Francês (Canadá) | fr_CA |
| Francês (França) | fr_FR |
| Hindi | hi_IN |
| Italiano | it_IT |
| Japonês | ja_JP |
| Coreano | ko_KR |
| Lituano | lt_LT |
| Norueguês (Bokmål) | nb_NO |
| Holandês | nl_NL |
| Polonês | pl_PL |
| Português (Brasil) | pt_BR |
| Português | pt_PT |
| Russo | ru_RU |
| Sueco | sv_SE |
| Tailandês | th_TH |
| Turco | tr_TR |
| Ucraniano | uk_UA |
| Chinês simplificado | zh_CN |
| Chinês tradicional | zh_TW |
Para usuários sem uma Localidade definida, o Looker usa a localidade escolhida na página Localização do painel Administrador como a localidade padrão. Se nenhuma localidade for definida, o Looker usará en como padrão.
Como definir uma localidade personalizada
Os desenvolvedores do Looker podem criar localidades personalizadas para usar apenas na localização de modelos. Os códigos de localidade personalizados são designados pelos títulos dos arquivos de string criados no processo de localização do modelo. Para aplicar essa localidade personalizada aos usuários, siga estas etapas:
Insira o código de localidade personalizado no campo Localidade. Quando você começa a digitar no campo, o texto preexistente desaparece.
Clique em Criar "your_custom_locale_code".
Clique em Salvar, na parte inferior da página. O código será adicionado ao menu suspenso de localidade do usuário.
A interface do Looker não é compatível com localidades personalizadas. Se você usar uma localidade personalizada no campo Localidade de um usuário, a UI vai usar como padrão o idioma definido na localidade da instância.
Formato de número
A configuração padrão de formato de número do Looker para números que aparecem em tabelas de dados e visualizações é 1.234,56. No entanto, o formato de número pode ser definido como qualquer um dos seguintes:
- 1,234.56: separador de milhares com vírgulas; separador decimal com um ponto.
- 1.234,56: separador de milhares com pontos; separador decimal com vírgula
- 1 234,56: separador de milhares com espaços; separador decimal com vírgula
Para mais informações e exemplos de uso da configuração Formato de número, consulte a página de documentação Como localizar a formatação de números.
Este campo aparece apenas para usuários padrão.
Fuso horário
Se você tiver ativado os fusos horários específicos dos usuários na sua instância do Looker, poderá selecionar o fuso horário que será usado quando esse usuário executar uma consulta no Looker.
Enviar link de configuração / Enviar link de redefinição
Se o usuário nunca tiver feito login, esse botão vai ser rotulado como Enviar link de configuração. Se o usuário já tiver feito login, esse botão vai ser rotulado como Enviar link de redefinição. Se você precisar definir ou redefinir uma senha, clique nesse botão para enviar um link ao endereço de e-mail do usuário que você especificou anteriormente. Consulte a página de documentação Requisitos de senha para saber como especificar requisitos de complexidade de senha no Looker. Se o usuário não redefinir a senha em até uma hora, o link de redefinição vai expirar.
Este campo aparece apenas para usuários padrão.
Segredo de dois fatores
Essa opção aparece se você tiver ativado a autenticação de dois fatores (2FA) na instância. Clique no botão Redefinir para redefinir a 2FA do usuário. Isso faz com que o Looker solicite que o usuário leia novamente um QR code com o app autenticador Google Authenticator na próxima vez que tentar fazer login na instância do Looker.
Este campo aparece apenas para usuários padrão.
Chaves de API
Uma chave de API é usada para acessar a API Looker. As chaves de API têm as mesmas permissões da conta de usuário ou de serviço em que foram criadas.
As chaves de API são criadas no Looker e consistem em um ID do cliente e uma chave secreta do cliente. O Looker exige uma chave de API para executar comandos com a API Looker.
Esse campo aparece apenas para usuários padrão e contas de serviço.
Usuários padrão individuais
Os administradores não podem criar chaves de API para usuários padrão individuais. No entanto, eles podem ativar ou desativar a capacidade dos usuários de gerenciar as próprias chaves de API.
Para ativar ou desativar a capacidade de um usuário de gerenciar as próprias chaves de API, na página Administrador > Usuários > Editar usuário, use o campo Chaves de API para ativar ou desativar a capacidade do usuário de criar, visualizar e excluir chaves de API da conta de usuário.
Depois que você permitir que um usuário gerencie as próprias chaves de API, ele poderá fazer isso na página Conta.
Os administradores do Looker podem monitorar quais usuários têm a capacidade de gerenciar chaves de API na Análise de atividade do sistema do usuário usando o campo Pode gerenciar credenciais da API3. Os administradores do Looker podem monitorar quais usuários têm chaves de API na Análise de Atividade do Sistema Usuário usando o campo Tem credenciais de API.
Depois que um usuário configura uma chave de API, a entrada dele na página Usuários no painel de admin Administrador mostra API (além de qualquer outro tipo de credencial do Looker que ele tenha) na coluna Credencial ativa. Os administradores do Looker também podem clicar no botão Ver chaves de API para abrir a página Chaves de API de um usuário, onde podem ver os IDs do cliente, mas não as chaves secretas do cliente para as chaves de API do usuário.
Contas de serviço somente de API
Os administradores do Looker gerenciam as chaves de API para contas de serviço somente de API.
Para gerar chaves de API para uma conta de serviço somente de API, na seção Chaves de API da página Administrador > Usuários > Editar usuário, clique no botão Gerenciar. A página Chaves de API é aberta e mostra as chaves de API atuais. Clique no botão Criar nova chave de API para gerar uma nova chave.
Grupos
Lista os grupos de que o usuário é membro. Para adicionar o usuário a um novo grupo, selecione o grupo no menu suspenso. Para remover o usuário de um grupo, clique no X ao lado do nome do grupo na lista.
Os usuários também podem ser adicionados a grupos na página Grupos no painel de admin Admin.
Papéis
Lista as funções atribuídas ao usuário. Para adicionar uma nova função ao usuário, selecione-a no menu suspenso. Para remover uma função do usuário, clique no X ao lado do nome da função na lista.
Os papéis também podem ser adicionados na página Administrador Papéis.
Atributos do usuário
Define e cancela a definição dos valores dos atributos do usuário. Os valores atribuídos a um usuário individual sempre substituem os valores atribuídos como resultado da associação a um grupo. As configurações do sistema não são editáveis.
Solução de problemas de erros 500 ao salvar um usuário
Se você tentar salvar o perfil de um usuário na página Editar usuário (como adicionar um papel, grupo ou atributo de usuário) e encontrar um 500 Internal Server Error, uma possível causa é uma restrição de limite de parâmetro de consulta.
Causa
Quando você salva um perfil de usuário na página Editar usuário, os papéis, grupos e atributos de usuário são enviados no payload da solicitação POST. Se a instância do Looker tiver um número muito grande desses parâmetros configurados, o número total poderá exceder o limite de parâmetros de consulta padrão do sistema (especificamente, 4.096). Quando esse limite é excedido, o servidor retorna um erro 500.
Alternativas e soluções
Para resolver ou contornar esse erro, tente uma das seguintes opções:
- Atribuir funções usando a página Administrador ou a API Funções: para atribuir uma função rapidamente sem acionar esse erro, acesse a página Funções, edite a função e adicione o usuário a ela. Como alternativa, use o método
set_user_rolesda API Looker. - Limpar atributos de usuário não utilizados: para resolver o problema subjacente e fazer com que a UI Editar usuário funcione normalmente, reduza o número total de atributos de usuário configurados na instância. Exclua os atributos de usuário não utilizados usando a página Administrador Atributos do usuário ou a API Looker.
Como remover o acesso de usuários
Para remover o acesso de uma conta de usuário ou de conta de serviço ao Looker, desative ou exclua a conta. Na maioria das situações, a prática recomendada é desativar a conta.
As diferenças entre desativar e excluir uma conta são descritas na tabela a seguir:
| Descrição | Desativado | Excluído |
|---|---|---|
| O usuário pode fazer login na instância do Looker | Não | Não |
| A pasta pessoal do usuário | Ainda existe | Excluído |
| Looks e dashboards na pasta pessoal do usuário | Ainda existem | Movido para a pasta Lixeira |
| Looks e dashboards que o usuário salvou em uma pasta compartilhada | Ainda existem na pasta "Compartilhados" | Ainda existem na pasta "Compartilhados" |
| Programações criadas pelo usuário | As programações estão desativadas | As programações foram excluídas |
| Programações baseadas no conteúdo do usuário, mas criadas por outra pessoa | As programações continuam em execução | O conteúdo do usuário é excluído, assim como as programações baseadas nele. |
| Programações que listam o usuário como destinatário e são criadas por outro usuário com a capacidade de enviar conteúdo para contas de e-mail externas | As programações vão continuar sendo executadas e entregues normalmente (o usuário será tratado como usuário externo). | As programações continuam sendo executadas e entregues normalmente (o usuário será tratado como um usuário externo) |
| Programações que têm a opção Executar programação como destinatário ativada e listam o usuário como destinatário | As programações vão continuar sendo executadas, mas não serão entregues ao usuário desativado na próxima execução | As programações continuam sendo executadas, mas não são entregues a todos os usuários com o erro run_as_recipient was specified on ScheduledPlan but recipient is not a Looker user |
| Quadros criados pelo usuário | Ainda existem | Ainda existem |
| Alertas criados pelo usuário | Permanecem ativos, mas não ficam visíveis nem editáveis no painel em que o alerta está definido, a menos que sejam atribuídos por um administrador. Os administradores podem editar ou atribuir o alerta a si mesmos na página de administração de gerenciamento de Alertas no painel Administrador. | Os alertas são excluídos imediatamente dos painéis e da página de administração de Alertas no painel Administrador. |
| Informações de uso histórico do usuário | Mantido | A maioria é excluída |
Como desativar usuários
Para impedir que uma conta de usuário ou de conta de serviço acesse o Looker, a prática recomendada é desativar a conta. Quando você desativa uma conta, o histórico de uso e o conteúdo pessoal dela são mantidos. Para mais detalhes sobre as diferenças entre desativar e excluir contas, consulte a tabela na seção Remover o acesso do usuário nesta página.
Se você estiver usando uma instância do Looker (Google Cloud Core), desativar um usuário não vai afetar as permissões do IAM dele. Remova as permissões do IAM do Looker para garantir que um usuário não possa acessar a instância.
Para desativar uma conta, selecione Desativar no menu de três pontos Opções à direita da linha do usuário.

Excluir usuários
Em vez de excluir um usuário, considere desativar a conta dele. Isso impede que o usuário faça login, mas as informações, o conteúdo e o histórico dele permanecem intactos. Para saber mais sobre as diferenças entre desativar e excluir usuários, consulte a tabela na seção Remover o acesso do usuário nesta página.
Se você estiver usando uma instância do Looker (Google Cloud Core), excluir um usuário não vai afetar as permissões do IAM dele. Remova as permissões do IAM do Looker para garantir que um usuário não possa acessar a instância.
Para excluir uma conta, realize uma das seguintes ações:
- No menu de três pontos Opções à direita da linha da conta, selecione Excluir.
- Na página Editar usuário da conta, clique no botão Excluir.

Representar usuários (sudoing)
Com o Sudo, você pode navegar no Looker como se fosse um usuário diferente, com todos os privilégios e habilidades dele.
O sudo também é uma maneira útil de validar se você configurou corretamente as permissões e outros recursos ou de conferir o desenvolvimento do LookML de um usuário antes que ele confirme e envie as mudanças.
As permissões see_users e sudo são necessárias para usar o sudo como outro usuário. Os administradores podem usar o comando sudo como qualquer outro usuário, inclusive outros administradores. Os usuários não administradores só podem usar o comando sudo como outros usuários não administradores.
Para executar o sudo como um usuário, selecione Executar sudo como este usuário no menu de três pontos Opções à direita da linha do usuário:

Uma barra na parte de cima da tela avisa que você está em um estado sudo. Isso permite que você saia do estado sudo. As mudanças feitas nesse estado vão afetar o usuário que você está emulando.
Se você estiver no Modo de Desenvolvimento, as mudanças não vão ficar visíveis para outros usuários até que você as implante na produção. Se você não tiver implantado as mudanças para que outros usuários as vejam, elas não vão aparecer quando você usar o comando sudo como um usuário diferente.
Há vários pontos a serem entendidos ao usar o sudo como outro usuário:
Usar o comando sudo como um usuário de incorporação assinada e interagir com uma instância do Looker diretamente, e não por um iframe incorporado, pode causar resultados inesperados. Além das restrições das permissões normais, os usuários de incorporação assinada são restritos pelo iframe incorporado. No entanto, essas restrições podem não estar presentes quando alguém usa o comando sudo como um usuário de incorporação assinado e interage fora de um iframe.
Para conexões de banco de dados que usam OAuth, como Snowflake, Google BigQuery, Trino e Databricks, um administrador que usa o sudo como outro usuário usa o token de acesso OAuth do usuário sudo ao executar consultas. Quando os usuários autorizam uma conexão de banco de dados OAuth no Looker, uma caixa de diálogo Autorizar conexão OAuth notifica que usuários privilegiados do Looker, como administradores ou desenvolvedores, podem ter visibilidade dos dados deles. Se o token de acesso do usuário estiver expirado, o administrador não poderá criar um novo token em nome do usuário sudo. O usuário precisará fazer login no banco de dados e autorizar o Looker novamente.
Quando você usa o comando sudo como outro usuário, as chaves de API dele não são reveladas.
Só é possível usar o sudo como um usuário padrão. Não é possível usar o sudo como uma conta de serviço.