As extensões são aplicativos da Web criados com componentes do Looker com o framework de extensão do Looker. Essas extensões herdarão a estrutura de permissões da sua instância do Looker, processando permissões no nível do conjunto de modelos. Se um usuário não tiver permissões para acessar determinados modelos no aplicativo padrão do Looker, eles não poderão ser acessados nas extensões do Looker. Nesta página, explicamos como os administradores do Looker podem conceder aos usuários as permissões apropriadas para acessar as extensões do Looker.
O Looker Marketplace implanta uma extensão importando um novo projeto para o aplicativo Looker. Esse projeto contém tudo o que é necessário para executar a extensão e tem pelo menos um arquivo de model. Os administradores do Looker podem controlar como um usuário visualiza ou interage com o conteúdo com base nesse modelo atribuindo a ele um papel com permissões para acessar o modelo da extensão.
Por exemplo, se a instância do Looker tiver dados com base em modelos chamados finance
, marketing
e sales
, mas você quiser que apenas determinados usuários acessem os dados financeiros, conceda a eles acesso apenas ao modelo finance
. As permissões para extensões funcionam de forma semelhante.
Os administradores do Looker podem controlar as permissões para acessar o modelo de uma extensão (e, portanto, a própria extensão), bem como os modelos em que qualquer conteúdo dentro da extensão se baseia.
Os administradores do Looker podem configurar os conjuntos de modelos disponíveis para uma instância acessando a página Papéis no painel Administrador. Para acessar e usar a extensão, os usuários precisam receber um papel com permissões manage models
ou permissões explore
ou develop
para todos os modelos ou o conjunto de modelos que contenha o modelo da extensão.
Como conceder permissões a usuários para extensões
As extensões do Looker são desenvolvidas com o framework de extensão do Looker e estão disponíveis para instalação no Marketplace. As extensões exigem a ativação dos recursos Extension Framework e Marketplace.
Além desses recursos, há três tipos de permissões associados às extensões:
- Permissões para desenvolver extensões
- Permissões para instalar extensões do Marketplace do Looker
- Permissões para usar extensões
Permissões para desenvolver extensões
Para desenvolver uma extensão usando o framework de extensão do Looker, os usuários precisam ter permissões de desenvolvedor do LookML na instância, além das habilidades recomendadas na página de documentação Introdução ao framework de extensão do Looker.
Permissões para instalar extensões do Marketplace do Looker
Cada extensão terá um projeto com pelo menos um model LookML dedicado. Por exemplo, a extensão Dicionário de dados usa o modelo data-dictionary
.
Para instalar uma extensão do Marketplace do Looker, o usuário precisa ter as permissões develop
, manage_models
e deploy
no modelo da extensão.
Quando você instala uma extensão que exige uma chave de acesso do Marketplace do Looker, uma tela de configuração solicita ao usuário valores de chave de acesso, que serão armazenados como atributos do usuário para a instância do Looker.
Permissões para usar extensões
Se a extensão for instalada no Marketplace do Looker ou disponibilizada em uma instância do Looker, o administrador do Looker vai precisar configurar as permissões do usuário.
Na maioria dos casos de uso de extensão, ela sempre é executada com as permissões concedidas ao usuário quando ele faz login. Por padrão, depois que a extensão for instalada, qualquer usuário com um papel com permissões explore
ou develop
e acesso ao Conjunto de modelos definido como Todos poderá ver e usar automaticamente a extensão e o conteúdo dela, sem necessidade de configuração adicional. Os usuários precisam ter acesso a todos os modelos usados pela extensão para que funcione completamente.
O Looker mostra a extensão na seção Aplicativos do menu principal do Looker.
O Looker só mostra a extensão para usuários que têm acesso a pelo menos um dos modelos subjacentes dela.
Para extensões incorporadas, a extensão assume as permissões dadas ao ID do usuário incorporado criado, assim como um Look, dashboard ou Explore incorporado.
Para extensões em tela cheia que usam a opção /spartan
no URL da extensão, você pode adicionar usuários a um grupo de usuários Somente extensões. Os usuários neste grupo não podem acessar páginas do Looker fora da extensão. Os administradores do Looker podem personalizar o grupo Somente extensões como qualquer outro grupo e atribuir a ele uma função com determinadas permissões e acesso ao conjunto de modelos. Os usuários não são obrigados a pertencer ao grupo Somente extensões para ver uma extensão em tela cheia. Se um usuário não estiver nesse grupo de usuários, a extensão será executada com as permissões do usuário conectado.
Adicionar permissões do usuário
Um administrador do Looker precisa conceder aos usuários e incorporar um conjunto de permissões que inclua access_data
e permissões mais restritivas associadas a essa extensão. Essas permissões precisam ser aplicadas a um conjunto de modelos que inclua o modelo ou os modelos da extensão.
Para conceder aos usuários acesso à extensão, os administradores do Looker precisam fazer o seguinte:
- Crie um conjunto de modelos que inclua o modelo da extensão ou edite um conjunto de modelos existente para adicionar o modelo da extensão.
- Confirme se os usuários foram atribuídos a um papel com pelo menos a permissão
access_data
(e outras permissões mais restritivas associadas a essa extensão) para esse conjunto de modelos.
Exemplo: extensão do dicionário de dados
O projeto de extensão Dicionário de dados usa o modelo data-dictionary
.
Os usuários com papéis que não incluem permissões explore
ou develop
ou que têm acesso Conjunto de modelos não definido como Todos vão precisar de um administrador do Looker para conceder a eles as permissões explore
ou develop
em um conjunto de modelos que inclua o modelo data-dictionary
.
Por exemplo, digamos que você queira conceder à sua equipe financeira acesso à extensão do dicionário de dados. A equipe financeira recebe o conjunto de modelos Finance Team
, mas não concede acesso ao modelo data-dictionary
no momento:
Para adicionar o modelo data-dictionary
ao conjunto de modelos, selecione o botão Editar ao lado do conjunto de modelos Finance Team
e marque a caixa de seleção do modelo data-dictionary
.
Selecione Update Settings para salvar a seleção.
Depois de adicionar o modelo data-dictionary
ao conjunto de modelos Finance Team
, confirme se o papel da equipe de finanças usa um conjunto de permissões que contém as permissões explore
ou develop
. Neste exemplo, o papel da equipe de finanças (Departamento financeiro) contém o conjunto de permissões Developer
e o conjunto de modelos Finance Team
.
O conjunto de permissões Developer
contém as permissões explore
e develop
.
Agora, todos os usuários atribuídos ao papel Departamento financeiro terão acesso à extensão "Dicionário de dados" porque esse papel contém as permissões apropriadas e o acesso adequado ao modelo.