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
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.
Seu app
Confere a sessão e o acesso ao relatório solicitado.
Servidor
Assina um token com recurso, filtros fixados e validade.
Metabase
Valida a assinatura para apresentar o recurso autorizado.
Página
Exibe o gráfico incorporado no seu app.
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.