Analytics central.
Dados no seu deployment.

Prove a instalação local

Antes da federação, confirme os cinco sinais no deployment cliente.

• GET /rastro/health responde no HTTP Actions URL.
• O site existe e permite o hostname exato do produto.
• O tracker carrega de /rastro/tracker.js.
• Opcional: o módulo de Web Vitals carrega de /rastro/vitals.js (alpha.6+).
• Um evento real retorna HTTP 200 com contadores de ingestão.
• Uma query autenticada local lê um relatório desse site.
• Relatórios históricos provam que rotas, IDs pseudônimos, localização, campanhas, afiliados, conversões e properties não contêm dados inesperados ou secrets, têm retenção aceitável e podem ser lidos pelos membros previstos da organização.

Prepare o grant local e o módulo canônico

Preserve schema, providers e mounts existentes. O grant indexado por connectionId é a fonte autoritativa de um a dez sites. O arquivo público deve ser exatamente convex/rastroFederation.ts.

rastroFederationGrants: defineTable({
  connectionId: v.string(),
  organizationId: v.string(),
  siteIds: v.array(v.string()),
  revokedAt: v.optional(v.number()),
  createdAt: v.number(),
  updatedAt: v.number(),
}).index("by_connectionId", ["connectionId"])

O resolver consulta esse índice em toda query. Site IDs no JWT nunca substituem o grant local.

Registre as duas URLs e faça o pairing

Um administrador entra no dashboard, abre Conexões e cria uma conexão pendente. Issuer e audience viram envs runtime; connection ID e organization ID são inputs do grant local, não envs.

Compare o issuer exibido com https://site.api.amagerastro.com/federation e a audience com a functions URL normalizada. Em domínio customizado, se aparecer UNTRUSTED_DEPLOYMENT_HOST, peça ao operador Amage Rastro que liberou a organização para adicionar a origem HTTPS exata; envie somente a URL pública, nunca credenciais.

# Convex Cloud DEV
npx convex env set --deployment dev RASTRO_FEDERATION_ISSUER \
  'https://site.api.amagerastro.com/federation'
npx convex env set --deployment dev RASTRO_FEDERATION_AUDIENCE \
  'https://produto.convex.cloud'

# Synapse DEV
synapse convex --dev env set RASTRO_FEDERATION_ISSUER \
  'https://site.api.amagerastro.com/federation'
synapse convex --dev env set RASTRO_FEDERATION_AUDIENCE \
  'https://produto.synapse.example'

Deploy e autorize os sites exatos

Faça um push único no alvo DEV. Depois use os IDs emitidos pelo pairing para provisionar de um a dez sites que o owner local realmente possui.

# Convex Cloud DEV
npx convex dev --once
npx convex run --deployment dev rastroFederationAdmin:provisionConnection \
  '{"connectionId":"CONNECTION_ID","organizationId":"ORGANIZATION_ID","ownerId":"OPAQUE_HOST_OWNER_ID","siteIds":["SITE_ID"]}'

# Synapse DEV
synapse dev --once
synapse convex --dev run rastroFederationAdmin:provisionConnection \
  '{"connectionId":"CONNECTION_ID","organizationId":"ORGANIZATION_ID","ownerId":"OPAQUE_HOST_OWNER_ID","siteIds":["SITE_ID"]}'

Connection ID e organization ID são inputs do grant. Nunca os apresente como envs runtime e nunca enumere todos os sites do owner.

Verifique inclusive as negativas

1. ManifestProtocolo, funções, capacidades e limites iguais ao contrato público.
2. ScopeLista redigida contém somente os sites do grant.
3. Tempo realPageview real aparece na visão Ao vivo.
4. NegativasSem identidade e site fora do grant são recusados.
5. RevogaçãoGrant local revogado bloqueia token já emitido.

Produção só depois de ensaio em DEV e consentimento explícito para o alvo PROD.