Configurações de administrador: usuários

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:

  1. As guias agrupam os usuários por tipo:

    • A guia Usuários padrão mostra os usuários que fazem login no Looker diretamente, seja pelo processo de autenticação normal ou pela API Looker.
    • A guia Inserir usuários mostra usuários de incorporação assinada que foram autenticados por um aplicativo de terceiros.
    • A guia Suporte do Looker mostra os analistas do suporte do Looker que receberam acesso à sua instância.
  2. O campo Filtrar lista limita quais usuários são mostrados. Você pode filtrar por ID, nome ou endereço de e-mail do usuário. Para filtrar por ID do usuário, digite um ID do usuário para mostrar esse usuário. Para nome e endereço de e-mail, quando você digita qualquer string, a lista de usuários mostrada 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.

  3. Clicar no cabeçalho da coluna Usuário classifica a tabela por nome de usuário em ordem crescente ou decrescente.

  4. 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.

  5. A coluna Credencial ativa lista os tipos de acesso que o usuário tem à sua instância do Looker.

  6. A coluna Grupo lista todos os grupos a que o usuário pertence.

  7. A coluna Papel lista todas as funções atribuídas ao usuário.

  8. Clique no botão Adicionar usuários para criar novos usuários.

  9. Clique no menu de três pontos Opções para desativar o usuário, fazer sudo como o usuário ou excluir o usuário.

    A exclusão de um usuário é irreversível. Considere as necessidades de compliance e segurança da sua organização antes de fazer isso.

Como adicionar usuários

Para adicionar um usuário, clique no botão Adicionar usuários.

Na página Como adicionar um novo usuário, digite ou cole uma lista de endereços de e-mail separados por vírgulas e selecione os grupos e papéis que serão atribuídos a cada um deles. Para ver a lista de grupos, comece a digitar no campo Grupos. Todos os nomes de grupos que incluem esse texto vão aparecer. Clique no botão Salvar para criar os usuários e, se você tiver selecionado a caixa de seleção Enviar e-mails de configuração, envie e-mails de inscrição.

Editar usuários

Para editar um usuário, clique na linha dele. Na página Editar usuário, ajuste as configurações a seguir 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.

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.

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.

E-mail

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 é usado como nome de usuário.

Localidade

O campo Locale define o idioma da interface do usuário e a localidade do modelo para um usuário.

Se você quiser que o usuário visualize um determinado texto da interface do usuário (IU) em um idioma específico, o Looker oferece suporte às traduções de IU mostradas na tabela a seguir. Insira o código no campo Localidade.

Se você quiser que o usuário acesse uma versão localizada de um ou mais modelos de dados, digite o título do arquivo de strings do modelo para essa localidade no campo Locale.

Se você quiser que o usuário acesse a localização do modelo e as traduções da UI integradas do Looker, o arquivo de strings do modelo precisa ter o mesmo nome do código de localidade apropriado na tabela abaixo. e esse código deve ser inserido no campo Locale.

Para confirmar a configuração de Locale, clique em Save na parte de baixo da página.

Idioma Código de localidade e nome de 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 estiver definida, o Looker vai 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 de modelos. Para aplicar essa localidade personalizada aos usuários, siga estas etapas:

  1. Insira o código da localidade personalizada no campo Localidade. Conforme você começa a digitar no campo, qualquer texto preexistente desaparece.

  2. Clique em Create "your_custom_locale_code".

  3. 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 oferece suporte a localidades personalizadas. Se você usar uma localidade personalizada no campo Localidade de um usuário, a UI vai adotar o idioma definido na localidade da instância por padrão.

Formato de número

A configuração de formato de número padrão do Looker para números que aparecem em tabelas de dados e visualizações é 1.234,56. No entanto, o formato do número pode ser definido como um dos seguintes:

  • 1,234,56: milhares separados por vírgulas. decimais separados por um ponto
  • 1.234,56: milhares separados por pontos. decimais separados por vírgula
  • 1 234,56: milhares separados por espaços e decimais separados por vírgula

Para mais informações e exemplos de como usar a configuração Formato de número, consulte a página de documentação Como localizar a formatação de números.

Fuso horário

Se você tiver ativado os Fusos horários específicos do usuário na sua instância do Looker, poderá selecionar o fuso horário que será usado quando esse usuário executar uma consulta no Looker.

Se o usuário nunca fez login, o botão é Enviar link de configuração. Se o usuário já tiver feito login anteriormente, esse botão será marcado como Enviar link de redefinição. Se precisar definir ou redefinir uma senha, clique neste botão para enviar um link ao endereço de e-mail do usuário especificado 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 uma hora, o link de redefinição vai expirar.

Segredo de dois fatores

Essa opção vai aparecer se você ativar a autenticação de dois fatores (2FA) na sua instância. Clique no botão Redefinir para redefinir a autenticação de dois fatores para o usuário. Isso faz com que o Looker solicite que o usuário faça a leitura de um código QR novamente com o app Google Authenticator na próxima vez que tentar fazer login na instância do Looker.

Chaves de API

Uma chave de API é usada para acessar a API Looker. As chaves de API são criadas pelo Looker e consistem em um ID e uma chave secreta do cliente. O Looker exige uma chave de API para executar comandos com a API Looker.

Para gerar chaves de API, clique no botão Editar chaves. A página Editar chaves de API do usuário é aberta e mostra as chaves de API atuais. Clique no botão Nova chave de API para gerar uma nova chave.

As chaves de API têm as mesmas permissões da conta de usuário que as criou.

É recomendável criar contas de usuário dedicadas para scripts de API, uma conta de usuário para cada script. Dessa forma, é possível configurar uma conta de usuário com o conjunto específico de permissões que permite que o script execute a função e somente ela. Por exemplo, para um script de API que executa consultas, você pode criar uma conta de usuário com a permissão access_data, mas sem outras permissões.

Com as contas de usuário dedicadas para scripts de API, você aumenta a segurança compartimentando o acesso de um script. Além disso, se for necessário interromper um script, desative (ou exclua) a conta de usuário dele. Leia a seção Remover acesso do usuário nesta página antes de excluir qualquer conta de usuário.

Grupos

Lista os grupos dos quais o usuário participa. Para adicionar o usuário a um novo grupo, selecione o grupo no menu suspenso ou clique em 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 Administrador.

Papéis

Lista as funções atribuídas ao usuário. Para adicionar um novo papel ao usuário, selecione-o na lista suspensa ou remova um papel do usuário clicando no X ao lado do nome do papel na lista.

Também é possível adicionar funções na página de administração de Funções.

Atributos do usuário

Define e redefine os 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. Não é possível editar as configurações do sistema.

Como remover o acesso de usuários

Para remover o acesso de um usuário ao Looker, desative ou exclua a conta dele. Na maioria das situações, a prática recomendada é desativar a conta.

As diferenças entre desativar e excluir uma conta de usuário estã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 existe Movido para a pasta Lixeira
Looks e dashboards que o usuário salvou em uma pasta compartilhada Ainda existem na pasta compartilhada 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 com base no conteúdo do usuário, mas criadas por outro usuário As programações continuam sendo executadas O conteúdo do usuário for excluído. programações com base nesse conteúdo são excluídas
Programações que listam o usuário como destinatário e são criadas por outro usuário com a capacidade de entregar conteúdo a contas de e-mail externas As programações vão continuar sendo executadas e entregues normalmente (o usuário será tratado como um usuário externo) As programações continuam sendo executadas e entregues normalmente (o usuário é tratado como externo)
Programações com a opção Executar programação como destinatário ativada e que 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 serão entregues a todos os usuários com o erro run_as_recipient was specified on ScheduledPlan but recipient is not a Looker user
Boards criados pelo usuário Ainda existe Ainda existe
Alertas criados pelo usuário Continuam 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 um alerta por conta própria na página do administrador de gerenciamento de Alertas no painel do administrador. Os alertas são excluídos imediatamente dos painéis e da página de administração Alertas no painel Administrador.
Informações de uso histórico do usuário Mantida A maioria é excluída

Como desativar usuários

Para impedir o acesso do usuário ao Looker, normalmente é uma prática recomendada desativar a conta de usuário. Quando você desativa uma conta de usuário, o histórico de uso e o conteúdo pessoal do usuário são mantidos. Para detalhes sobre as diferenças entre desativar e excluir usuários, consulte a tabela na seção Como remover o acesso do usuário desta página.

Para desativar uma conta de usuário, selecione Desativar usuário 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 um 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 Como remover o acesso do usuário desta página.

Para excluir uma conta de usuário, selecione Excluir usuário no menu de três pontos Opções à direita da linha do usuário.

Como falsificar a identidade (sudoing) de usuários

O Sudoing permite navegar pelo Looker como se você fosse um usuário diferente, com todos os privilégios e habilidades dele.

O sudoing também é uma maneira útil de confirmar que você configurou corretamente as permissões e outros recursos ou de visualizar o desenvolvimento no LookML de um usuário antes que ele confirme e envie as alterações.

As permissões see_users e sudo são necessárias para usar o sudo como outro usuário. Os administradores podem usar o sudo como qualquer outro usuário, incluindo outros administradores. Usuários não administradores podem somente executar o sudo como usuários que não são administradores.

Para usar o sudo como usuário, selecione Sudo as this user no menu de três pontos Options à 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. Qualquer mudança feita nesse estado vai afetar o usuário que você está emulando.

Se você estiver no Modo de Desenvolvimento, as mudanças não vão aparecer para outros usuários até que você implante as mudanças 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 sudo como um usuário diferente.

O sudo como um usuário de incorporação assinada e a interação direta com uma instância do Looker, e não por um iframe incorporado, podem causar resultados inesperados. Além das restrições das permissões regulares, os usuários incorporados assinados são restritos pelo iframe incorporado. No entanto, essas restrições podem não estar presentes quando alguém usa o sudo como um usuário de incorporação assinado e interage fora de um iframe.

Para conexões de banco de dados que usam o OAuth, como o Snowflake e o Google BigQuery, um administrador que está usando o sudo como outro usuário vai usar o token de acesso do usuário sudoed ao executar consultas. Para conexões do Snowflake, se o token de acesso do usuário tiver expirado, o administrador não poderá criar um novo token em nome do usuário com sudo; o usuário precisa fazer login no Snowflake e reautorizar o Looker.