Supabase
Overview
A Supabase não tem API de fatura. Este conector monta o custo do mês corrente de forma híbrida:
- Add-ons (compute, PITR, IPv4, domínio…): preço real, lido da API da Supabase (
GET /v1/projects/{ref}/billing/addons) - Base do plano: tabela de preços pública (Free US$ 0, Pro US$ 25, Team US$ 599), casada com o plano que a API informa para cada organização
- Créditos de compute: nos planos Pro e Team, até US$ 10/mês são descontados do custo de compute (cobre uma instância Micro)
- Para baixo: excedentes de uso (storage, egress, usuários ativos, invocações) não têm endpoint na API da Supabase e não entram na conta. Se você passa das cotas do plano, a fatura real fica acima do que mostramos.
- Para cima: add-ons cobrados por hora são projetados para o mês inteiro — no começo do mês o valor fica acima do que você já consumiu.
O conector ainda não foi calibrado contra uma fatura real. Confira o número contra a sua fatura da Supabase.
Requisitos
- Uma ou mais organizações Supabase
- Um Personal Access Token (PAT), gerado em
supabase.com/dashboard/account/tokens - Papel de administrador no CloudBroker
A Supabase não oferece token com escopo — um PAT tem o mesmo poder da conta que o gerou. O endpoint de preço de add-ons também não aceita OAuth, então o PAT é o único caminho. Por isso, não use o seu token pessoal:
- Crie uma conta Supabase separada (ex.:
finops@suaempresa.com) - Convide-a na sua organização com o papel Read-Only (planos Team/Enterprise) ou Developer (plano Pro)
- Logado nessa conta, gere o token em Account → Access Tokens
No plano Pro, o papel Developer ainda permite escrever no banco — é o mais restrito que a Supabase oferece nesse plano.
Guia de setup
A conexão tem duas etapas:
- Em
app.cloudbroker.app.br→ Marketplace de Conectores → Supabase, cole o Personal Access Token e clique em Ver organizações deste token. O token é validado e o CloudBroker lista as organizações que ele enxerga — nada é gravado nesta etapa. - Deixe marcadas só as suas organizações. Se a conta foi convidada para a organização de um parceiro ou cliente, o custo dele entraria no seu total. Opcionalmente, escolha um app para atribuir o custo e clique em Conectar.
O CloudBroker recusa qualquer organização que o token não enxergue.
Campos
| Campo | Obrigatório | Descrição |
|---|---|---|
accessToken | Sim | Personal Access Token da conta dedicada |
orgSlugs | Não | Organizações escolhidas na etapa 1 — só elas entram no custo |
appId | Não | Atribui o custo a um app do CloudBroker |
Dado coletado
Custo estimado do mês corrente, por organização: base do plano + add-ons − créditos de compute. Na tela Custos SaaS, o valor aparece com um *: é uma foto da configuração atual, não uma medição do período.
A Supabase não expõe histórico de faturamento. O conector publica só o mês corrente — meses passados não são preenchidos com a configuração de hoje.
Se alguma leitura falhar (lista de projetos, detalhe de uma organização, add-ons de um projeto, organização escolhida que sumiu do token) ou se uma organização estiver num plano sem preço público (Enterprise ou plano não reconhecido), o custo não é publicado e o conector fica em estado de atenção com o motivo. Um total sabidamente parcial não aparece como custo.
Sincronização
Resultado completo fica em cache por 24h. Leitura incompleta fica em cache por 15 minutos, e então é tentada de novo.
Segurança
O Personal Access Token é cifrado com AES-256-GCM antes de persistir. Se um administrador for removido do time ou rebaixado, a credencial do Supabase gravada no registro dele é apagada.
Desconectar remove o token do CloudBroker, mas ele continua válido na Supabase. Revogue também em supabase.com/dashboard/account/tokens.
Erros comuns
- Token inválido ou revogado: gere um Personal Access Token novo.
- Sem permissão para ler o faturamento: confirme que a conta dedicada é membro da organização (Read-Only ou Developer).
- Token válido, mas nenhuma organização visível: a conta foi convidada mas ainda não aceitou o convite.