Ir para o conteúdo
Promovaweb

Permissões e embed no Metabase

As permissões do Metabase definem o acesso de cada grupo aos bancos e aos conteúdos salvos. No guest embed, o servidor do seu app assina um token para autorizar o gráfico, sem criar uma sessão individual do Metabase para cada visitante.

Ficha e sumário da página

Referência técnica
Metabase v0.65.4
Revisão
13 de novembro de 2026
Conteúdo
Documentação oficial consultada
  1. O acesso vem dos grupos
  2. Esconder uma coluna não restringe sua leitura
  3. O gráfico pode aparecer dentro do seu app
  4. Guest embed usa um token assinado
  5. Autenticação individual e edição

O acesso vem dos grupos

O Metabase atribui permissões a grupos. Você pode participar de vários grupos e recebe o acesso mais permissivo disponível entre eles. Restringir um grupo não reduz o acesso concedido por outro. Essa composição explica por que uma pergunta continua visível mesmo depois de você alterar a permissão do grupo usado pela área de atendimento.

O grupo All users inclui os cadastros da instalação por padrão. Se esse grupo mantém acesso amplo, uma configuração mais restrita em outro grupo não produz o resultado esperado. Você precisa considerar todos os grupos aos quais o cadastro pertence. Para conferir o acesso de um atendente, por exemplo, você usa uma sessão com os mesmos grupos desse atendente. A sessão administrativa tem acesso diferente.

Existem permissões para as origens consultadas e permissões para as coleções. As primeiras controlam o acesso aos bancos e a criação de consultas, conforme os recursos da edição. As coleções organizam perguntas e dashboards salvos. Dar acesso a uma coleção não deve ser confundido com liberar a construção de qualquer consulta sobre todas as tabelas do banco.

Esconder uma coluna não restringe sua leitura

A configuração visual de uma tabela pode ocultar uma coluna na apresentação. Isso não retira necessariamente o campo do resultado nem substitui uma permissão de acesso. A documentação do query builder alerta que a coluna escondida na visualização pode voltar a ser mostrada. Se o painel de atendimento não deve revelar uma coluna privada, você restringe o acesso ao campo na consulta ou nas permissões aplicáveis.

O banco também participa dessa configuração. A credencial usada pelo Metabase determina quais tabelas e comandos a conexão alcança. Dentro desse alcance, o Metabase distribui acesso entre seus grupos. Recursos de restrição por linha e coluna dependem da edição e da forma de autenticação utilizada. Um filtro que você consegue alterar livremente não serve para separar registros privados de clientes.

O gráfico pode aparecer dentro do seu app

O embed incorpora uma pergunta ou um dashboard numa página externa. Na documentação da v0.65.4, o Metabase apresenta embedding modular para componentes individuais e embedding da aplicação completa. A autenticação é uma escolha associada ao conteúdo incorporado. Você precisa definir se o público apenas vê um resultado autorizado ou se também pode construir e explorar consultas.

  1. Seu app

    Confere a sessão e o acesso ao relatório solicitado.

  2. Servidor

    Assina um token com recurso, filtros fixados e validade.

  3. Metabase

    Valida a assinatura para apresentar o recurso autorizado.

  4. Página

    Exibe o gráfico incorporado no seu app.

No guest embed, o servidor do seu app autoriza o recurso e assina o token. O navegador recebe esse token, mas não recebe a chave usada para assiná-lo.

Um link público segue outra modalidade. Ele permite acessar o conteúdo sem autenticação, inclusive fora do seu app. Isso atende gráficos destinados à divulgação aberta, mas não representa isolamento entre clientes. Você deve considerar o resultado inteiro como público, porque possuir o endereço já permite consultá-lo. Colocar esse link numa página com login não transforma o destino em conteúdo autenticado.

Guest embed usa um token assinado

O guest embed recebe um token JWT assinado com uma chave compartilhada entre o servidor do seu app e o Metabase. O token identifica o recurso autorizado e pode fixar valores de filtros, além de definir uma expiração. A chave permanece no servidor. Com essa chave no código entregue ao navegador, terceiros conseguem produzir assinaturas para recursos que não deveriam acessar.

A documentação informa que a autenticação guest funciona também na edição aberta. Ela não cria uma sessão individual do Metabase para cada visitante e oferece visualização, sem o mesmo conjunto de exploração ad hoc disponível com autenticação individual. A separação dos registros depende dos filtros fixados pelo servidor e da autorização que o seu app aplica ao emitir o token.

Na v0.65.4, o embed estático por iframe com token está depreciado em favor do guest embed com componente web. A documentação preserva o funcionamento dos embeds existentes e descreve a continuidade do formato do token. Essa distinção evita apresentar o iframe estático como a única opção de incorporação assinada disponível numa instalação atual.

Autenticação individual e edição

O embedding com login único (SSO) permite ao Metabase reconhecer o cliente autenticado no seu app e aplicar as permissões correspondentes. Essa modalidade exige Pro ou Enterprise na documentação consultada. Ela atende casos de exploração interativa e acesso a componentes que precisam dessa identidade, como o query builder incorporado. A disponibilidade precisa ser conferida junto ao plano e aos componentes escolhidos.

Você pode usar componentes web ou o SDK React conforme a integração pretendida. A escolha da biblioteca não substitui a escolha da autenticação: são aspectos diferentes do embed. Os recursos abertos e os comerciais estão separados em edições. Para qualquer modalidade, a pergunta que alimenta o gráfico continua sendo executada contra uma origem autorizada, com os mesmos cuidados de significado e carga do banco.

StayCloud

Uma VPS para desenvolver com agentes

Servidor da StayCloud em São Paulo, com acesso root e disco NVMe, para deixar seus agentes de IA rodando o dia todo.

Montar minha VPS

Link de parceiro da Promovaweb.