Glossário.

A

AAL2

Authenticator Assurance Level 2: o nível do NIST 800-63 para autenticação com segundo fator. O token do SuperDB ainda não carrega o nível de MFA (não há claim aal), então uma policy de RLS não consegue exigir o segundo fator. → Cookbook: MFA TOTP

AGPL-3.0

Licença open source do SuperDB. Diferente da MIT/Apache: quem usa o código em SaaS público deve disponibilizar o source do app inteiro. É a "viralidade" que protege o moat. Self-host privado pra uso interno é OK sem publicar.

Anon key

Chave pública da API. Identifica o projeto, mas não um usuário específico. Pode ir no env público (NEXT_PUBLIC_*). Respeita RLS. → Conceito: service vs anon

Argon2id

Algoritmo de hash de senha moderno (RFC 9106), vencedor do Password Hashing Competition. Padrão do SuperDB Auth. Mais lento e resistente a GPU que bcrypt — exatamente o que se quer pra senha.

B

Bucket

Container de arquivos no Storage. Pode ser público (URLs diretas) ou privado (signed URLs com expiração). Cada bucket tem suas próprias policies de acesso (similar a RLS, mas pra arquivo).

C

Callback URL

Endereço para onde o login social volta. São dois: o do provedor, que você cola no console do Google, GitHub ou Apple (https://auth.superdb.com.br/auth/v1/callback/<provider>), e o do seu app, que recebe o ?code= e precisa estar em Autenticação → URLs de redirecionamento. → Cookbook: Signup com Google

CDN

Content Delivery Network: cópias em cache espalhadas pelo mundo, para o arquivo sair de perto de quem pede. O SuperDB não tem CDN: o Storage responde direto do servidor em São Paulo. Se o seu público está longe do Brasil, dá para pôr uma CDN sua na frente das URLs públicas.

CORS

Cross-Origin Resource Sharing: o mecanismo do navegador que bloqueia chamadas para outra origem sem permissão do servidor. As APIs de auth e de dados do SuperDB respondem Access-Control-Allow-Origin: *, então qualquer origem pode chamar. Quem protege os dados é o token e o RLS, não a origem.

CPF/CNPJ

Identificadores fiscais brasileiros. O SuperDB não tem campo de documento no cadastro: valide os dígitos verificadores no app e no banco (com CHECK) e guarde numa tabela sua, com RLS. Desde julho de 2026, o CNPJ também pode ter letras. → Cookbook: CPF/CNPJ

J

JWT

JSON Web Token: um crachá assinado que identifica quem faz a requisição, em 3 partes (header, payload e assinatura) separadas por ponto. No SuperDB, a API de dados usa JWT ES256 (o data_plane_token do usuário e as chaves anon e service_role); a sessão do auth é um token PASETO. → Conceito: JWT

L

LGPD

Lei Geral de Proteção de Dados (Lei 13.709/2018). O SuperDB oferece ferramentas para atender os pedidos dos titulares: exportação dos dados do usuário (Art. 18, portabilidade) e exclusão (Art. 16). Quem decide a base legal e responde ao titular é você, o controlador; o que o SuperDB faz como operador está no DPA em LGPD e proteção de dados.

M

MAU

Monthly Active User. Usuário que fez ≥ 1 auth request (login, signup, refresh, sessão validada) no mês. É a métrica de cobrança do plano Pro do SuperDB.

MCP

Model Context Protocol. Padrão aberto criado pela Anthropic pra IAs falarem com ferramentas externas. O SuperDB tem um servidor MCP: rodar SQL, ler tabelas, policies e buckets do seu projeto. → Docs: MCP

MFA

Multi-Factor Authentication: um segundo fator além da senha. No SuperDB, autenticador TOTP e códigos de reserva. O login ainda não exige o segundo fator sozinho. → Cookbook: MFA TOTP

Multi-tenant

Isolamento de dados por projeto/cliente. No SuperDB, cada projeto tem um banco Postgres próprio, com o schema proj_<slug> dentro dele. → Conceito: multi-tenant

O

OAuth

Protocolo de autorização delegada (OAuth 2.0 + OIDC), a base do login social. No SuperDB, self-serve: Google, GitHub e Apple, com o app do SuperDB (modo gerenciado) ou com as credenciais do seu produto.

OTP

One-Time Password. Código de uso único enviado por email, SMS ou WhatsApp. Geralmente 6 dígitos. TTL curto (5-10 min). Não reutilizável.

P

PII

Personally Identifiable Information: dados que identificam uma pessoa, como CPF, e-mail e telefone. O que vai nas tabelas do seu projeto fica como você gravar: proteja com RLS e colete só o necessário.

PostgREST

Servidor open-source que vira Postgres em API REST automaticamente. Cada tabela = endpoint. → Conceito: PostgREST

Project (projeto)

Unidade lógica no SuperDB. Cada projeto = 1 schema Postgres = 1 app = 1 par de keys (anon + service). Você cria pelo painel, pela API ou pelo MCP.

PIX

Pagamento instantâneo do Banco Central. No SuperDB, é uma das três formas de pagar o plano anual, junto com boleto e cartão. O mensal é só no cartão, porque PIX não tem débito automático.

R

Realtime

Subscriptions a mudanças no banco (Postgres CDC via WAL), presence (quem está online), broadcast (mensagens efêmeras). Cliente recebe eventos via WebSocket.

Refresh token

Token de longa duração (30 dias) que troca por uma sessão nova quando o access token (1 hora) vence. Cada troca devolve um refresh novo, e reusar um antigo derruba a família inteira de sessões, de propósito. O SDK guarda a sessão no storage (localStorage no navegador) e não renova sozinho.

RLS

Row Level Security. Feature do Postgres que aplica filtros automáticos por usuário no banco — você não precisa lembrar de filtrar em cada query. → Conceito: RLS

RPC

Remote Procedure Call. No PostgREST, chamar uma SQL function via API: POST /rpc/<function>. Usado pra agregações, transações multi-tabela e lógica complexa que não cabe em REST.

S

SAML 2.0

Security Assertion Markup Language. Protocolo de Single Sign-On enterprise (Okta, Azure AD, Google Workspace). No SuperDB é um add-on opcional, sob consulta, fora dos planos.

SCIM 2.0

System for Cross-domain Identity Management. Padrão pra provisionamento automático de usuários a partir de um IdP (ex: usuário criado no Okta = usuário criado no SuperDB). No SuperDB é um add-on opcional, sob consulta, fora dos planos.

Service-role

Chave privada de administração. Bypassa RLS. NUNCA expor no client. → Conceito: service vs anon

Signed URL

URL temporária pra acessar arquivo privado no Storage. Tem assinatura HMAC e expira em N segundos. Ideal pra download protegido sem expor o bucket.

SMTP

Servidor de envio de e-mail. O SuperDB envia os e-mails de auth (código de login, convite, redefinição de senha) sem SMTP para configurar. Em Emails → Remetente dos emails, você verifica o seu domínio para enviar como a sua marca.

T

TOTP

Time-based One-Time Password (RFC 6238). Algoritmo que gera código de 6 dígitos que muda a cada 30s baseado em chave compartilhada + horário. Google Authenticator, Authy, 1Password usam isto.

Trusted device

Dispositivo confiável, que dispensaria o segundo fator por alguns dias. Não se aplica a projetos hoje: o login ainda não pede o segundo fator, então não há o que dispensar.

Turnstile

Anti-bot da Cloudflare. Alternativa moderna ao reCAPTCHA — sem puzzles, transparente, gratuito. O SuperDB ainda não o confere no cadastro nem na redefinição de senha.

U

UUID

Universally Unique Identifier (RFC 4122): 128 bits, praticamente impossível de colidir. Use uuid primary key default gen_random_uuid() como id: um id sequencial entrega quantas linhas a tabela tem e deixa adivinhar o id dos outros.

W

WhatsApp Business API

Canal oficial da Meta para mensagens transacionais via WhatsApp (OTP, notificações). O SuperDB não usa a WABA: o envio sai de um número pareado como aparelho conectado, e cada projeto pode parear o seu.