Selo de estado:
Preview— catálogo de diagnóstico para acesso/permissão (RBAC, RLS, PII) e exportação. Atualizado em 2026-09-08.
Três camadas independentes decidem o acesso: papel (RBAC) — o que você pode fazer; RLS — quais linhas você vê; verificação de conta em dia — se a conta está em dia. Ver Papéis, RLS e Suspensão.
Permissão / RBAC / RLS#
| Sintoma | Causa provável | Diagnóstico | Solução | Prevenção |
|---|---|---|---|---|
"Ação não permitida para o papel" (403) | papel abaixo do exigido | confira o papel na matriz RBAC | owner eleva o papel | atribua o papel mínimo por função |
| Membro não roda query/refresh/IA | ação cara exige admin+ | veja a matriz de papéis | eleve para admin ou use conta adequada | reserve ações caras a admins |
| Pessoa vê zero linhas | RLS fail-closed (atributo ausente) | confira o atributo do membro | defina o atributo (ex.: filial) no perfil | padronize atributos ao cadastrar |
| Pessoa vê linhas demais | grant de RLS não configurado | confira o grant do dashboard | crie o grant {column, memberAttribute} | revise RLS na publicação |
| Atributo de RLS "não pega" | diferença de caixa/typo | a chave é normalizada | confira o nome do atributo | use nomes de atributo consistentes |
| Membro vê PII indevidamente | viewPII ligado | confira a permissão fina | desligue viewPII no perfil | menor privilégio por padrão |
| Coluna PII sumiu no dashboard | máscara por viewPII | esperado para quem não tem viewPII | conceda viewPII se apropriado | classifique PII no catálogo |
Tudo dá 402 | assinatura em atraso/suspensa | ver Suspensão | owner regulariza em Planos | acompanhe faturamento |
org_admin não vê dados | comportamento esperado (org é estrutural) | confirme membership no workspace | vire membro do workspace-alvo | separe administração de acesso a dados |
Exportação (xlsx / pdf / pptx)#
| Sintoma | Causa provável | Diagnóstico | Solução | Prevenção |
|---|---|---|---|---|
| Exportar bloqueado | papel sem exportação de dados ou 402 | confira papel/faturamento | eleve papel / regularize pagamento | reserve export a member+ |
| Export tem mais linhas que a tela | virtualização (tela ≠ export) | compare tela vs. arquivo | o export traz o total (esperado) | comunique a diferença aos usuários |
| PDF do relatório não gera | dependência de PDF não configurada | ver Exportação e distribuição | confirme provisionamento | teste o envio antes de agendar |
| Export com RLS não recorta | RLS por destinatário não configurada | confira a assinatura do relatório | configure o filtro por destinatário | valide RLS no envio de relatórios |
| PII apareceu num export | quem exportou tem viewPII | confira a permissão do autor | remova viewPII de quem não deve | governe PII por papel/permissão |
Diagnóstico rápido#
403→ problema de papel/escopo (RBAC). Ajuste o papel.- Zero linhas → problema de RLS (atributo ausente = denyAll). Defina o atributo.
402→ problema de faturamento (não de permissão). Regularize.
Relacionados#
Última revisão: 2026-09-08. Estado: RBAC/RLS fail-closed (GA-candidato
na lógica); limite atual do produto = Preview. Fonte: matriz de estados do produto.