Esta página foi traduzida pela API Cloud Translation.

Configurações de administrador: configurações gerais

Na página Configurações, na seção Geral do menu Administrador, você pode definir as configurações da instância para o Looker.

Forçar o uso do escopo somente leitura do BigQuery

A ativação dessa configuração faz o logout de usuários com credenciais OAuth que permitem o escopo de leitura e gravação em qualquer uma das conexões do BigQuery. Quando os usuários fizerem a autenticação novamente, o Looker vai criar credenciais OAuth somente leitura para eles. Consulte Como restringir o escopo do OAuth a somente leitura para conexões do Google BigQuery para mais informações.

Chave de licença

A chave de licença é exclusiva da instância do Looker que você está usando. Ele ativa ou desativa determinados recursos do Looker com base no seu contrato de licenciamento.

A chave de licença fica oculta por padrão. Selecione o ícone de olho para mostrar a chave de licença.

URL do host

O URL do host é a parte base do URL da sua instância do Looker. Ele é usado especificamente quando os links para sua instância são criados em e-mails programados e em todos os URLs absolutos gerados pelo Looker.

Verifique se a configuração URL do host usa http:// ou https:// de forma adequada, com base na configuração do servidor da sua instância.

A alteração do URL do host pode afetar a funcionalidade de alguns recursos do Looker. Consulte O que acontece se o URL mudar para minha instância do Looker? Página de práticas recomendadas para mais informações sobre como mudar os URLs das instâncias.

Contatos técnicos

Os endereços de e-mail adicionados a esta caixa vão receber notificações sobre atualizações de segurança, correções de bugs importantes e novas versões do Looker. O endereço de e-mail precisa pertencer a um usuário válido do Looker. Se você adicionar um e-mail que não pertence a um usuário válido do Looker, por exemplo, um endereço de e-mail para uma lista de distribuição, o endereço de e-mail vai aparecer no campo Contato técnico, mas o Looker não vai conseguir enviar notificações para esse endereço.

O suporte do Looker precisa da permissão de um contato técnico para fazer o seguinte:

Causar inatividade na instância, o que pode ser devido a uma atualização de versão não programada, mudanças de desempenho no servidor do Looker ou outros motivos
Mudar algo na sua licença do Looker, possivelmente para ativar novos recursos

fuso horário do aplicativo

Ao mostrar dados em uma Análise, um Look ou um painel, o Looker pode converter dados de tempo do fuso horário do banco de dados da conexão para o fuso horário adequado ao usuário.

Se a opção Fusos horários específicos do usuário estiver ativada, o administrador poderá definir o fuso horário padrão do usuário ou os usuários poderão definir o próprio fuso horário padrão. Se o administrador ou o usuário não tiver definido o fuso horário padrão do usuário, o Fuso horário do aplicativo será usado para esse usuário, e todos os dados baseados em tempo consultados por esse usuário serão convertidos para o Fuso horário do aplicativo.

A configuração Fuso horário do aplicativo também é usada como o fuso horário padrão para entregas de conteúdo. O fuso horário usado para as programações não afeta os dados de tempo retornados por uma consulta. Ele afeta apenas o horário em que uma entrega de dados é enviada.

Consulte a página de documentação Como usar as configurações de fuso horário para mais informações.

Sistema fechado

A configuração Sistema fechado é usada com grupos para impedir que os usuários de um grupo conheçam os usuários de outro. Isso é útil para instalações de vários locatários.

Os locais no Looker em que os usuários podem ver outros usuários incluem:

A página "Usuários" na seção Administrador do Looker
Pastas dos usuários na seção Pastas do menu principal do Looker, se tiverem acesso de leitura à pasta pessoal de outro usuário
O pop-up "Gerenciar acesso", que faz parte do gerenciamento de pastas

Quando a configuração Sistema fechado está ativada, os usuários que não são administradores que não têm a permissão see_users só podem ver outros usuários com quem compartilham um grupo. Eles também só vão poder acessar os grupos dos quais fazem parte.

Todos os administradores e usuários que receberam a permissão see_users podem conferir todos os usuários e grupos na instância.

Configuração de consentimento de login

Quando ativada, a configuração de consentimento de login faz com que uma tela de consentimento seja mostrada a todos os usuários que tentarem fazer login na instância do Looker. A tela de consentimento vai mostrar a mensagem inserida no campo Configuração da mensagem e exigir que os usuários cliquem no botão Concordo na tela de consentimento antes de fazer login na instância. Depois de ativar a Configuração do consentimento de login, o campo Configuração de mensagem fica visível.

Configuração da mensagem

Se a opção Configuração de consentimento de login estiver ativada, insira a mensagem que será mostrada a todos os usuários que tentarem fazer login na instância do Looker no campo Configuração da mensagem. Esse campo só fica visível depois que a configuração do consentimento de login é ativada.

Pastas pessoais particulares padrão

Quando a opção Pastas pessoais particulares padrão está ativada, a pasta pessoal de um usuário fica visível por padrão apenas para ele e para os administradores do Looker. Por padrão, os outros usuários não veem a pasta na Pessoas, e o conteúdo dela não fica visível nos painéis ou nas pesquisas de conteúdo.

Se você quiser conceder acesso a uma pasta pessoal, adicione o acesso a outros usuários ou grupos de usuários usando a opção Gerenciar acesso no menu de engrenagem da pasta pessoal.

Se você desativar a opção Pastas pessoais particulares padrão, a pasta pessoal de um usuário poderá ser acessada por qualquer usuário do Looker no grupo de usuários Todos os usuários.

Notificação de nova conta

A configuração Notificação de nova conta pode ser ativada ou desativada. Quando esse recurso está ativado, qualquer usuário administrador do Looker recebe um e-mail quando uma nova conta do Looker é criada. Os usuários de incorporação assinada são uma exceção. Não são gerados e-mails quando um usuário de incorporação assinada é criado. O e-mail vai conter o endereço de e-mail do novo usuário.

Guias no app

Os guias no app permitem que o Looker se comunique com os usuários no aplicativo por meio de tutoriais, banners, alertas e pesquisas. Essas comunicações são usadas para ajudar os usuários a aproveitar melhor a plataforma, alertá-los sobre novos recursos, receber feedback deles sobre a plataforma e convidar os usuários para treinamentos e eventos em que eles podem aprender a usar melhor o Looker.

Os administradores podem desativar os guias para a instância, o que desativa os guias para todos os usuários nessa instância. Não é possível desativar seletivamente os guias no app para determinados usuários. O Looker não mostra guias no app para usuários incorporados ou não administradores em instâncias de marca própria.

Os guias são criados e implantados pela equipe de experiência do cliente do Looker e mudam com o tempo. A Looker usa JavaScript de software de terceiros (Pendo) para exibir os guias. O Looker avalia os guias individuais e os adiciona à lista de permissões. Ao buscar um guia do Pendo, o Looker usa hashes de integridade SHA-256 para validar se o guia não foi alterado. Se houver mudanças no guia após a análise do Looker, ele vai impedir o uso do guia alterado. Se o navegador de um usuário não conseguir acessar o servidor do Pendo, o guia simplesmente não será exibido.

Banner de notificação de cookies

Quando ativada, essa configuração mostra um banner de notificação de cookies para todos os usuários na sua instância. Essa configuração fica desativada por padrão.

Recomendamos ativar essa configuração se você precisar obedecer aos regulamentos de proteção de dados da União Europeia.

Pesquisa selecionada

Quando a Pesquisa selecionada está ativada, os usuários podem pesquisar conteúdo em pastas compartilhadas, na pasta pessoal e em painéis. O conteúdo salvo nas pastas pessoais de outros usuários só será incluído nos resultados se também estiver fixado em um quadro. Os resultados da pesquisa vão excluir conteúdo que existe apenas nas pastas pessoais de outros usuários. Os usuários podem excluir conteúdo de pastas pessoais selecionando o botão ao lado do nome do recurso Pesquisa selecionada no modo de pesquisa.

Limitar a opção "Atualizar painel automaticamente"

Quando ativada, apenas os administradores do Looker podem ativar a opção Atualizar painel automaticamente em painéis definidos pelo usuário. Isso impede que usuários que não são administradores atualizem automaticamente os dados nos painéis e blocos. A atualização automática dos dados do painel pode sobrecarregar alguns sistemas de banco de dados.

Número do projeto do Google Cloud

O número do projeto do Google Cloud é necessário para ativar o suporte no app. Esse valor pode ser encontrado na página "Visão geral do Cloud" no console do Google Cloud.

Essa mudança pode levar até duas horas para entrar em vigor. Para implementar a mudança imediatamente, clique no botão Atualizar ao lado da configuração Chave de licença depois de inserir o número do projeto do Google Cloud.

Se você ainda não tem um projeto do Google Cloud para o Looker, siga nosso guia para criar um projeto do Google Cloud ou consulte nossa documentação mais detalhada sobre como criar e gerenciar projetos.

Usar o Gravatar

Quando ativada, essa configuração mostra a opção Foto do perfil no menu do usuário, permitindo que os usuários selecionem ou criem um avatar para a conta usando o app Gravatar.

fusos horários específicos dos usuários

Ao adicionar uma conexão, você especifica o fuso horário em que o banco de dados armazena informações de tempo como Fuso horário do banco de dados.

Quando a opção Fusos horários específicos do usuário está ativada, cada usuário recebe um fuso horário e o Looker converte os dados baseados em tempo do Fuso horário do banco de dados para o fuso horário do usuário quando ele consulta os resultados da consulta ou interpreta os filtros.

Quando a opção Fusos horários específicos do usuário está desativada, o Looker converte os dados baseados em tempo de todos os usuários para o valor do Fuso horário da consulta.

Consulte a página de documentação Como usar as configurações de fuso horário para mais informações.

Cores de visualização padrão

Com a configuração Cores de visualização padrão, você pode definir uma coleção de cores padrão para as visualizações e criar novas coleções para usar nas suas instâncias.

Como definir uma coleção de cores padrão

Cada instância do Looker precisa ter uma coleção de cores padrão.

Para definir uma coleção de cores preexistente como padrão, escolha a coleção de cores no menu suspenso e clique em Atualizar. Observação: definir uma nova coleção de cores padrão atualiza todas as visualizações nos painéis e visualizações que usam a coleção padrão. As visualizações salvas com uma coleção de cores diferente ou uma paleta personalizada não serão afetadas.

Você pode conferir as primeiras paletas categóricas, sequenciais e divergentes de cada coleção diretamente no menu suspenso. Essas são as paletas que serão usadas como padrão na visualização. Para conferir todas as paletas na coleção de cores, acesse a página de documentação Coleções de cores.

Como criar uma coleção de cores personalizada

Para criar uma coleção de cores personalizada, siga estas etapas:

Selecione a última opção Nova coleção de cores no menu suspenso Cores de visualização padrão.
Dê um nome exclusivo à nova coleção na caixa de texto Nome.
Clique em cada paleta para abrir o menu Cores na paleta.
Selecione cores individuais no menu Cores na paleta para editar uma de cada vez ou selecione Editar tudo para editar todas as cores de uma só vez.
Repita as etapas 3 e 4 para cada paleta de cores.
Quando terminar de editar a nova coleção de cores, clique em Criar.

Os valores de cor podem ser formatados como strings hexadecimais, como #2ca6cd, ou como nomes de cores CSS, como mediumblue. Ou você pode clicar na roda de cores para abrir e selecionar uma tonalidade no seletor de cores. Se você quiser editar todas as cores, use uma vírgula entre cada nome de cor para separá-las. Para adicionar ou remover uma cor, clique nos sinais + ou -.

A nova coleção vai se tornar automaticamente o padrão da instância, mas você pode escolher um padrão diferente, se quiser.

Os IDs de coleção e de paleta para qualquer nova coleção de cores personalizada são baseados no nome de cada coleção. Isso permite que os dashboards do LookML que usam essas coleções sejam renderizados de forma consistente nas instâncias se ambas tiverem as mesmas coleções personalizadas com nomes idênticos.

Como excluir uma coleção de cores personalizada

Para excluir uma coleção de cores personalizada, selecione a coleção no menu suspenso e clique no botão Excluir. Não é possível excluir as coleções de cores nativas do Looker.

Carregar recursos da CDN

Essa opção está disponível apenas para instâncias hospedadas pelo cliente. Como as instâncias hospedadas pelo Looker sempre carregam recursos da CDN, não é possível desativar essa configuração para elas.

CDN significa rede de fornecimento de conteúdo. Uma CDN é uma rede de servidores que armazena conteúdo em vários locais geográficos para reduzir o tempo de carregamento da página para os usuários. Seus dados nunca são armazenados nesses servidores. Somente itens específicos do Looker (como imagens) são armazenados no CDN.

A configuração Carregar recursos da CDN pode ser ativada ou desativada. Quando ele é ativado, as páginas do Looker são carregadas mais rapidamente.

Manter recursos no cache do navegador

Quando essa configuração está ativada, os recursos estáticos, como arquivos JavaScript e fontes, são armazenados em cache no armazenamento do navegador de cada usuário. Isso acelera as navegações subsequentes, porque o navegador não precisa continuar recarregando esses recursos do servidor do Looker.

Acesso no aplicativo para dispositivos móveis

Quando essa configuração está ativada, os usuários podem fazer login na conta do Looker na instância usando o app para dispositivos móveis. Quando ela está desativada, todas as sessões móveis são encerradas.

Forçar autenticação por dispositivo móvel

Quando essa configuração está ativada, os usuários precisam fazer login no app Looker para dispositivos móveis sempre que abrirem o app no dispositivo móvel. Os usuários também podem ativar o login biométrico quando a opção Forçar autenticação para dispositivos móveis está ativada.

Aplicação da Política de Segurança de Conteúdo

Quando essa configuração está ativada, os cabeçalhos da Política de Segurança de Conteúdo (CSP) que estão em conformidade com as recomendações rígidas da CSP do Google são enviados e aplicados. Os cabeçalhos CSP bloqueiam a execução de scripts de terceiros no Looker e podem interromper algumas extensões do navegador. Para permitir que scripts de terceiros sejam executados no Looker, desative essa configuração.

Essa opção foi adicionada para dar tempo aos desenvolvedores de ajustar os scripts de acordo com as recomendações rígidas do CSP. Ela será removida em uma versão futura do Looker.

URLs públicos

A configuração URL público pode ser ativada ou desativada. Quando essa configuração está ativada, os usuários do Looker com as permissões adequadas podem gerar URLs públicos para acessar os dados do Looker.

Lista de permissões de domínios de e-mail para conteúdo programado

Essa configuração permite que os administradores do Looker definam os domínios de e-mail em que os usuários podem enviar conteúdo do Looker (visualizações, painéis, consultas com visualizações) ou notificações de alerta por e-mail.

Para limitar envios de conteúdo e notificações de alerta para endereços de e-mail com um domínio específico, insira o domínio no formato domain.suffix. Por exemplo, para limitar as entregas de e-mail apenas a e-mails com domínios gmail.com e friendly_domain.org, especifique esses domínios no campo Lista de permissões de domínio de e-mail para conteúdo programado e conceda aos usuários a permissão schedule_look_emails.

Saiba mais sobre como essa configuração e as permissões de um usuário afetam a capacidade de enviar conteúdo do Looker e notificações de alerta na seção Visão geral das permissões desta página.

Atributo do usuário `looker_internal_email_domain_allowlist`

Além dos domínios de e-mail incluídos no campo global Lista de permissões de domínios de e-mail para conteúdo programado, você também pode especificar domínios de e-mail por grupo usando o atributo de usuário looker_internal_email_domain_allowlist. O atributo do usuário aceita o mesmo formato de string da configuração de administrador Lista de permissões de domínio de e-mail para conteúdo programado.

Se um grupo receber vários conjuntos de domínios de e-mail, por exemplo, por meio de associação a vários grupos, os membros desse grupo poderão enviar e-mails para todos os domínios atribuídos a cada um dos valores do atributo do usuário, bem como para os domínios listados na configuração de administrador Lista de permissões de domínios de e-mail para conteúdo programado. Em outras palavras, o conjunto de domínios de e-mail para os quais um grupo pode enviar e-mails é a união do conjunto de domínios de e-mail listados no campo Lista de permissões de domínios de e-mail para conteúdo programado e cada conjunto de domínios de e-mail atribuído ao grupo pelo atributo de usuário looker_internal_email_domain_allowlist.

Visão geral das permissões

Os usuários que incorporam e que não incorporam precisam ter pelo menos a permissão schedule_look_emails para enviar e-mails com qualquer conteúdo do Looker. Para enviar notificações de alerta, o usuário também precisa ter permissões create_alerts.

Os usuários incorporados e não incorporados que têm a permissão schedule_look_emails também podem receber a permissão schedule_external_look_emails. Saiba mais sobre permissões e dependências na página de documentação Papéis.

Para saber como as permissões do usuário afetam os domínios para os quais os usuários podem enviar notificações de alerta ou envios de conteúdo do Looker, consulte a tabela a seguir:

Tipo de usuário	Permissões	A lista de permissões de domínios de e-mail para conteúdo programado contém o domínio `friendly_domain.org`	A lista de permissões de domínios de e-mail para conteúdo programado não contém domínios
Não incorporada	Somente `schedule_look_emails`	Pode enviar e-mails para o próprio endereço de e-mail, para o endereço de e-mail de outro usuário do Looker na mesma instância ou para um endereço de e-mail com o domínio `friendly_domain.org`	Pode enviar conteúdo por e-mail para qualquer endereço
	`schedule_look_emails` e `create_alerts`	Pode enviar conteúdo por e-mail e notificações de alerta para o próprio endereço de e-mail, para o endereço de e-mail de outro usuário do Looker na mesma instância ou para um endereço de e-mail com o domínio `friendly_domain.org`	Pode enviar e-mails de envio de conteúdo e notificações de alerta para qualquer endereço de e-mail
	Somente `schedule_external_look_emails`	Pode enviar conteúdo por e-mail para qualquer endereço de e-mail	Pode enviar conteúdo por e-mail para qualquer endereço
	`schedule_external_look_emails` e `create_alerts`	Pode enviar e-mails de envio de conteúdo e notificações de alerta para qualquer endereço de e-mail	Pode enviar e-mails de envio de conteúdo e notificações de alerta para qualquer endereço de e-mail
Incorporação assinada	Somente `schedule_look_emails`	Pode enviar conteúdo por e-mail para um endereço com o domínio `friendly_domain.org`	Não é possível enviar conteúdo do Looker por e-mail
	`schedule_look_emails` e `create_alerts`	Pode enviar e-mails de envio de conteúdo e notificações de alerta para um endereço de e-mail com o domínio `friendly_domain.org`	Não é possível enviar por e-mail nenhum conteúdo do Looker ou notificações de alerta
	`schedule_external_look_emails`	Pode enviar conteúdo por e-mail para qualquer endereço de e-mail	Pode enviar conteúdo por e-mail para qualquer endereço
	`schedule_external_look_emails` e `create_alerts`	Pode enviar e-mails de envio de conteúdo e notificações de alerta para qualquer endereço de e-mail	Pode enviar e-mails de envio de conteúdo e notificações de alerta para qualquer endereço de e-mail

O conteúdo incorporado do Looker é acessado por uma conta de usuário dedicada, não por contas de usuário individuais. Quando uma pessoa acessa o conteúdo do Looker por meio de uma incorporação, não é esperado que o Looker saiba o endereço de e-mail do usuário.

Uma exceção às regras estipuladas na tabela é a seguinte: é possível fornecer ao Looker o endereço de e-mail de um usuário de incorporação definindo-o no atributo de usuário email no URL de incorporação assinado. Exemplo:

...&user_attributes={"email":"joe@domain.com"}

Se você definir o atributo de usuário email no URL de incorporação, o Looker vai permitir que um usuário de incorporação que tenha apenas a permissão schedule_look_emails envie o conteúdo do Looker para o próprio endereço de e-mail, mesmo que o domínio de e-mail não esteja no campo Lista de permissões de domínio de e-mail para conteúdo programado ou se o campo Lista de permissões de domínio de e-mail para conteúdo programado estiver em branco.

Lista de permissões de URL para ações de dados

Essa configuração permite definir URLs (como https://looker.com) em que os usuários podem processar ações de dados.

Por exemplo, se você adicionar o URL https://looker.com à lista de permissões de URL para ações de dados, elas só poderão ser processadas em https://looker.com. As tentativas de processar ações de dados em outros URLs não serão permitidas.

Se esse campo for deixado em branco, não haverá restrições de URL para ações de dados. No entanto, se você incluiu um atributo do usuário em uma ação de dados, esse campo é obrigatório. Nesse caso, você precisa fornecer URLs válidos para processar ações de dados.

Bloquear imagens incorporadas inline nos resultados da consulta

Por padrão, o Looker não exibe imagens codificadas em Base64 nos resultados da consulta. Desative essa configuração para mostrar imagens codificadas em Base64 nos resultados da consulta.

Bloquear fórmulas e macros em arquivos CSV e Excel

Quando essa configuração está ativada, o Looker adiciona um caractere ' a todos os valores que podem ser interpretados como fórmulas ou macros em consultas que são baixadas nos formatos de planilha CSV ou Excel.

Token de webhook de saída

Se um usuário usar um webhook para enviar conteúdo, como um painel ou um Look, a solicitação vai incluir um token especial do Looker que pode ser definido aqui. Os servidores que recebem webhooks podem verificar se as solicitações contêm esse valor para verificar a legitimidade das solicitações de webhook.

Formato de exportação padrão

A configuração Formato de exportação padrão permite escolher o formato de arquivo padrão usado quando os usuários optam por fazer o download de dados. Os usuários ainda podem escolher um formato de arquivo diferente, se quiserem.

Integração

Quando ativado, os administradores e desenvolvedores do Looker que fizerem login em uma nova instância do Looker vão acessar o tutorial de integração do Looker, que orienta os usuários nas quatro principais etapas para usar uma instância do Looker:

Como adicionar uma conexão
Como criar um projeto
Como editar arquivos do projeto, se quiser
Como analisar dados

Quando qualquer combinação de administradores ou desenvolvedores concluir o guia completo, ele vai deixar de ser exibido.

A configuração Guias no app precisa estar ativada para que a opção Integração esteja disponível.