A página Usuários na seção Usuários do menu Administrador lista todas as contas de usuário na instância do Looker.
Página "Novos usuários"
Ative o recurso New Users Labs para visualizar a página Users reformulada. Se o recurso Nova página de usuários do Labs não estiver ativado, consulte a seção Página de usuários desta página de documentação.
Como ver e pesquisar usuários
A página Usuários mostra as seguintes informações:
As guias agrupam seus usuários por tipo:
- A guia Usuários padrão mostra os usuários que fazem login diretamente no Looker, por meio do processo de autenticação regular ou da API Looker.
- A guia Incorporar usuários mostra os usuários do SSO incorporado que são autenticados por um aplicativo de terceiros.
- A guia Suporte do Looker mostra os analistas que têm acesso à sua instância do Looker.
O campo Lista de filtros limita quais usuários são exibidos. É possível filtrar por ID de usuário, nome ou endereço de e-mail. Para filtrar por User-ID, digite um código para ser exibido. Para o nome e o 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.
Ao clicar no cabeçalho da coluna Usuário, a tabela é classificada 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, além de 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. Esses usuários são criados pelo sistema, por exemplo, participantes 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 do usuário à sua instância do Looker.
A coluna Grupo lista todos os grupos a que o usuário pertence.
A coluna Papel lista todos os papéis atribuídos ao usuário.
Clique no botão Adicionar usuários para criar novos usuários.
Clique no menu de três pontos Opções para desativar o usuário, sudo como o usuário ou excluir o usuário.
A exclusão de um usuário é irreversível. Considere as necessidades de conformidade 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 os 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 grupo que incluam esse texto aparecerão. 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.
Editar usuários
Para editar um usuário, clique na linha dele e ajuste as configurações:
Guia "Perfil"
A guia Perfil permite definir informações descritivas sobre o usuário e atribuir grupos e papéis a ele.
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.
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 o nome de usuário.
Enviar link de configuração / Enviar link de redefinição de senha
Se o usuário nunca tiver feito login, esse botão vai aparecer como Enviar link de configuração. Se o usuário tiver feito login anteriormente, esse botão aparecerá como Enviar link de redefinição de senha. Se você quiser enviar um e-mail de configuração a um novo usuário ou redefinir uma senha para um usuário existente, clique neste botão para enviar um link para o endereço de e-mail do usuário especificado anteriormente. O URL enviado ao usuário é mostrado nesse campo. Consulte a página de documentação Requisitos de senha para saber como especificar os requisitos de complexidade da senha no Looker. Se o usuário não definir a senha em até uma hora, o link de redefinição da senha vai expirar.
Editar chaves API3
Uma chave de API3 é usada para acessar a API Looker. As chaves de API3 são criadas pelo Looker e consistem em um ID e uma chave secreta do cliente. O Looker exige uma chave de API3 para executar comandos com a API Looker.
Para gerar chaves de API, clique no botão Editar chaves. A página Editar chaves de API3 do usuário é aberta e mostra as chaves de API3 existentes. Clique no botão Nova API3 key para gerar uma nova chave.
As chaves de API3 têm as mesmas permissões da conta de usuário de que foram criadas.
A prática recomendada é 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 um conjunto específico de permissões que permitem que o script execute a função dele e apenas a função dele. Por exemplo, para um script de API que executa consultas, é possível criar uma conta de usuário com a permissão access_data, mas sem outras permissões.
Isso permite aumentar a segurança compartimentalizando o acesso de um script. Além disso, se for necessário interromper um script, desative (ou exclua) a conta de usuário do script. Leia a seção Como remover o acesso do usuário nesta página antes de excluir qualquer conta de usuário.
Fuso horário
Se você tiver ativado Fusos horários específicos do usuário na sua instância do Looker, será possível selecionar o fuso horário que será usado quando esse usuário executar uma consulta no Looker.
Localidade
O campo Locale define o idioma da interface do usuário e a localidade do modelo de um usuário.
O Looker oferece suporte às traduções de IU mostradas na tabela abaixo. Digite o código no campo Locale.
Para que o usuário veja 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.
Para que o usuário veja ambas a localização do modelo e as traduções da IU integradas do Looker, o arquivo de strings do modelo precisa ter o mesmo nome que o código de localidade apropriado na tabela abaixo, e esse código deve ser inserido no campo Localidade.
Para confirmar a configuração de Localidade, clique em Salvar na parte de baixo da página.
| Idioma | Nome de arquivo de código e strings de localidade |
|---|---|
| Inglês | en |
| Tcheco | cs_CZ |
| Alemão | de_DE |
| Espanhol | es_ES |
| Francês | 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 e, se nenhuma localidade for definida, o Looker usará como padrão o en.
Definir uma localidade personalizada
Os desenvolvedores do Looker podem criar localidades personalizadas para usar somente para 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 Locale. Conforme você começa a digitar no campo, qualquer texto preexistente desaparece.
Clique em Criar "código_da_localidade_personalizada".
Clique em Salvar, na parte inferior da página. O código será adicionado ao menu suspenso de localidade do usuário.
A IU do Looker não é compatível com localidades personalizadas. Se você usar uma localidade personalizada no campo Locale de um usuário, a IU dele será definida como o idioma definido na localidade da instância.
Formato de número
A configuração padrão do 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: milhares separados por vírgulas, decimais com um ponto final
- 1.234,56: com separadores de ponto por ponto e decimal com uma vírgula
- 1.224,56: milhares separados por espaços, decimais separados por uma vírgula.
Para ver mais informações e exemplos de como usar a configuração Formato de número, consulte a página de documentação Formatação de números.
Grupos
Lista os grupos em que o usuário é membro. Para adicionar o usuário a um novo grupo, selecione o grupo no menu suspenso e remova o usuário clicando no X ao lado do nome do grupo na lista.
Os usuários também podem ser adicionados a grupos na página de administrador do Grupos.
Papéis
Lista os papéis atribuídos ao usuário. É possível adicionar um novo papel ao usuário. Para isso, selecione o papel no menu suspenso e remova o papel dele clicando no X ao lado do nome do papel na lista.
As funções também podem ser adicionadas na página de administrador das Funções.
Guia "Atributos do usuário"
A guia Atributos do usuário é exibida e permite definir e cancelar a definição de atributos do usuário. Os valores atribuídos a um usuário individual sempre substituem os valores atribuídos a esse usuário como membro de um grupo. As configurações do sistema não são editáveis.
Página "Usuários"
Se o recurso Página de novos usuários Labs não estiver ativado, o Looker exibirá a versão anterior da página Usuários:
Como ver e pesquisar usuários
A página Usuários mostra as seguintes informações para cada usuário:
É possível classificar a tabela pelo ID ou pela coluna Nome clicando no cabeçalho da coluna.
Para pesquisar nas colunas Nome e Credenciais, digite um termo na caixa de pesquisa no canto superior direito e pressione Enter.
Como adicionar usuários
Para adicionar um usuário, clique no botão Adicionar usuários.
Digite ou cole uma lista de endereços de e-mail separados por vírgulas e selecione as funções e os grupos para atribuir a cada um deles. Clique no botão Adicionar usuários para criar os usuários e, se você tiver marcado a caixa de seleção Enviar e-mails de configuração, enviar e-mails de inscrição.
Editar usuários
Para editar um usuário, clique no botão Editar à direita da linha do usuário. Na página Editar usuário, ajuste as configurações:
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.
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 o nome de usuário.
Localidade
O campo Locale define o idioma da interface do usuário e a localidade do modelo de um usuário.
Se você quiser que o usuário veja 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. Digite o código no campo Locale.
Se você quiser que o usuário visualize 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 Locale.
Se você quer que o usuário veja a localização do modelo e as traduções da IU integradas do Looker, o arquivo de strings do modelo precisa ter o mesmo nome que o código de localidade apropriado na tabela abaixo, e esse código deve ser inserido no campo Localidade.
Para confirmar a configuração de Localidade, clique em Salvar na parte de baixo da página.
| Idioma | Nome de arquivo de código e strings de localidade |
|---|---|
| Inglês | en |
| Tcheco | cs_CZ |
| Alemão | de_DE |
| Espanhol | es_ES |
| Francês | 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 e, se nenhuma localidade for definida, o Looker usará como padrão o en.
Definir uma localidade personalizada
Os desenvolvedores do Looker podem criar localidades personalizadas para usar somente para 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 Locale. Conforme você começa a digitar no campo, qualquer texto preexistente desaparece.
Clique em Criar "código_da_localidade_personalizada".
Clique em Salvar, na parte inferior da página. O código será adicionado ao menu suspenso de localidade do usuário.
No momento, a IU do Looker não é compatível com localidades personalizadas. Se você usar uma localidade personalizada no campo Locale de um usuário, a IU dele será definida como o idioma definido na localidade da instância.
Formato de número
A configuração padrão do 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: milhares separados por vírgulas, decimais com um ponto final
- 1.234,56: com separadores de ponto por ponto e decimal com uma vírgula
- 1.224,56: milhares separados por espaços, decimais separados por uma 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 Formatação de números.
Fuso horário
Se você tiver ativado Fusos horários específicos do usuário na sua instância do Looker, será possível 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 aparecer como Enviar link de configuração. Se o usuário tiver feito login anteriormente, esse botão aparecerá 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. O URL enviado ao usuário será exibido neste campo. Consulte a página de documentação Requisitos de senha para saber como especificar os requisitos de complexidade da senha no Looker. Se o usuário não redefinir a senha dentro de uma hora, o link de redefinição da senha expirará.
Segredo fator
Essa opção será exibida se você tiver ativado a autenticação de dois fatores (2FA) na instância. Clique no botão Redefinir para redefinir a 2FA para o usuário. Isso faz com que o Looker solicite uma nova leitura de um código QR com o app Google Authenticator na próxima vez que ele tentar fazer login na instância do Looker.
Chaves de API3
Uma chave de API3 é usada para acessar a API Looker. As chaves de API3 são criadas pelo Looker e consistem em um ID e uma chave secreta do cliente. O Looker exige uma chave de API3 para executar comandos com a API Looker.
Para gerar chaves de API, clique no botão Editar chaves. A página Editar chaves de API3 do usuário é aberta e mostra as chaves de API3 existentes. Clique no botão Nova API3 key para gerar uma nova chave.
As chaves de API3 têm as mesmas permissões da conta de usuário de que foram criadas.
A prática recomendada é 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 um conjunto específico de permissões que permitem que o script execute a função dele e apenas a função dele. Por exemplo, para um script de API que executa consultas, é possível criar uma conta de usuário com a permissão access_data, mas sem outras permissões.
Isso permite aumentar a segurança compartimentalizando o acesso de um script. Além disso, se precisar interromper um script, basta desativar ou excluir a conta de usuário do script. Leia a seção Como remover o acesso do usuário nesta página antes de excluir qualquer conta de usuário.
Papéis individuais
Permite selecionar as funções que esse usuário deve ter, para atribuir funções individualmente. Consulte a página Papéis para mais informações sobre como configurar papéis ou a página de documentação Gerenciamento de permissões para uma discussão mais ampla sobre as permissões do Looker.
Geralmente, o Looker sugere atribuir papéis a grupos em vez de atribuir papéis diretamente a usuários individuais.
Grupos
Lista os grupos em que o usuário é membro. Para adicionar o usuário a um novo grupo, selecione o grupo no menu suspenso ou remova o usuário clicando no X ao lado do nome do grupo na lista.
Os usuários também podem ser adicionados a grupos na página de administrador do Grupos.
Papéis
Lista os papéis atribuídos ao usuário. É possível adicionar um novo papel ao usuário. Para isso, selecione o papel no menu suspenso ou remova um papel do usuário clicando no X ao lado do nome do papel na lista.
As funções também podem ser adicionadas na página de administrador das Funções.
Atributos do usuário
Define e cancela a definição de valores dos atributos de usuário. Os valores atribuídos a um usuário individual sempre substituem os valores atribuídos como resultado da associação em um grupo. As configurações do sistema não são editáveis.
Como remover o acesso de usuários
Para remover o acesso de um usuário ao Looker, é possível desativar ou excluir 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 são descritas na tabela a seguir:
| Descrição | Desativada | Excluído |
|---|---|---|
| O usuário pode fazer login na instância do Looker | Não | Não |
| Pasta pessoal do usuário | Ainda existe | Excluído |
| Aparências e painéis na pasta pessoal do usuário | Ainda existe | Movido para a pasta Lixeira |
| Aparências e painéis que o usuário salvou em uma pasta compartilhada | Ainda existe na pasta compartilhada | Ainda existe na pasta compartilhada |
| 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 outro usuário | As programações continuam em execução | O conteúdo do usuário é excluído, e as programações com base nele 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 continuarão sendo exibidas e entregues normalmente (o usuário será tratado como um usuário externo) | As programações continuam sendo exibidas e entregues normalmente (o usuário será tratado como um usuário externo) |
| Programações com a opção Executar programação como destinatário ativada e listar o usuário como um destinatário | As programações continuarão sendo executadas, mas não serão entregues ao usuário desativado na próxima execução | As programações continuam em execução, mas não serão exibidas a todos os usuários com erro run_as_recipient was specified on ScheduledPlan but recipient is not a Looker user |
| Placas criadas pelo usuário | Ainda existe | Ainda existe |
| Alertas criados pelo usuário | Permanecem ativos, mas não são visíveis nem editáveis no painel em que o alerta é definido, a menos que seja atribuído por um administrador. Os administradores podem editar ou autoatribuir o alerta na página Alertas de administrador no painel Administrador. | Os alertas são excluídos imediatamente dos painéis e da página de administrador de gerenciamento de Alertas no painel Administrador. |
| Informações de uso históricas do usuário | Mantido | A maioria foi excluída |
Como desativar usuários
Para impedir o acesso do usuário ao Looker, é recomendado desativar a conta. Quando você desativa uma conta de usuário, o histórico de uso e o conteúdo pessoal são mantidos. Para mais detalhes 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ê tiver ativado o recurso Labs da página "Novos usuários", para desativar uma conta de usuário, selecione Desativar usuário no menu Opções de três pontos, à direita da linha do usuário:
Se você não tiver ativado o recurso Página de novos usuários Labs, para desativar uma conta de usuário, clique no botão Desativar à direita da linha do usuário. Uma caixa de diálogo solicitará a confirmação.
Excluir usuários
A exclusão de um usuário é irreversível. Considere as necessidades de conformidade e segurança da sua organização antes de fazer isso.
Em vez de excluir um usuário, considere desativar a conta de usuário. Isso impede que um usuário faça login, mas as informações, o conteúdo e o histórico permanecem intactos. Para mais detalhes 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ê tiver ativado o recurso Labs da página "Novos usuários", para excluir uma conta de usuário, selecione Excluir usuário no menu Opções de três pontos, à direita da linha do usuário:
Se você não ativou o recurso Nova página de usuários Labs, para excluir um usuário, execute as etapas abaixo:
Clique no botão Editar à direita da linha do usuário.
Na parte de baixo da página Editar usuário, clique em Excluir.
Na caixa de diálogo de confirmação, clique em OK para excluir o usuário.
Falsificação de identidade de usuários
O Sudo permite navegar no Looker como se você fosse um usuário diferente, com todos os privilégios e habilidades.
O Sudo também é uma forma útil de validar se você configurou as permissões e outros recursos de maneira adequada ou visualizar o desenvolvimento LookML de um usuário antes de confirmar e confirmar as mudanças.
As permissões see_users e sudo são necessárias para o sudo como outro usuário. Os administradores podem usar o sudo como qualquer outro usuário, inclusive outros administradores. Usuários que não são administradores só podem usar o sudo como outros usuários que não são administradores.
Se você tiver ativado o recurso Labs na página Novos usuários, selecione Sudo como este usuário no menu de três pontos Opções à direita da linha do usuário:
Se você não tiver ativado o recurso Labs da página "Novos usuários", clique no botão Sudo do usuário na página de administrador Usuários:
Uma barra na parte superior da tela avisa que você está no estado sudoed. Isso permite que você saia do estado sudoed. Qualquer mudança feita nesse estado afetará o usuário que você está emulando.
Se você estiver no modo de desenvolvimento, suas mudanças só ficarão visíveis para outros usuários quando você implantar as alterações na produção. Se você não tiver implantado as alterações para que outros usuários vejam, não vai ver as mudanças ao usar o sudo como outro usuário.
A ação de incorporar como um usuário do SSO incorporado e interagir diretamente com uma instância do Looker e não com um iframe incorporado pode causar resultados inesperados. Além das restrições das permissões regulares, os usuários incorporados ao SSO são restringidos pelo iframe incorporado. No entanto, essas restrições podem não estar presentes quando alguém faz o sudo como um usuário incorporado de SSO e interage fora de um iframe.
Nas conexões de banco de dados que usam OAuth, como o Snowflake e o Google BigQuery, um administrador que estiver definindo o sudo como outro usuário usará o token de acesso OAuth desse usuário quando executar consultas. Em conexões do Snowflake, se o token de acesso do usuário expirou, o administrador não pode criar um novo token em nome do usuário sudoed; o usuário deve fazer login no Snowflake e autorizar novamente o Looker.