Documentação Técnica

Referência de Arquitetura e Operação Hostzers

Guia técnico das superfícies B2B2C, isolamento PostgreSQL RLS, autenticação por escopo, domínios customizados e provisionamento automatizado.

Arquitetura das 5 Superfícies B2B2C

Separação estrita por domínio, middleware allowlist e escopo JWT/Cookie entre cada persona da plataforma.

Site Institucional (hostzers.com)

Apresentação comercial, planos públicos (/super-admin/plans/public), documentação, status e contato.

Portal B2B (app.hostzers.com)

Gestão da assinatura SaaS do lojista com a Hostzers (/portal/*), cotas, faturas B2B, equipe e cancelamento.

Painel do Lojista ({slug}.hostzers.com/admin ou domínio próprio/admin)

Operação B2C completa: catálogo, pedidos, clientes finais, servidores/IPAM, gateways próprios e identidade white-label.

Storefront & Área do Cliente ({dominio}/ e {dominio}/clientarea)

Experiência 100% white-label para consumidores finais, sem marca Hostzers e com identidade CUSTOMER isolada por tenant.

Console SuperAdmin (console.hostzers.com)

Plano de controle restrito ao escopo PLATFORM para gestão de planos SaaS, tenants, faturamento B2B e auditoria.

Isolamento PostgreSQL RLS & Segurança

Proteção física no banco de dados com role de aplicação sem NOBYPASSRLS e contexto transacional obrigatório.

runInTenantContext e Foreign Keys Compostas

Consultas no escopo TENANT ou CUSTOMER executam em transação com app.current_tenant_id validado por políticas RLS.

Cookies HttpOnly Host-Only & Proteção CSRF

Cookies hostzers_token, hostzers_refresh_token e hostzers_csrf são emitidos sem atributo Domain compartilhado, com SameSite=Lax, HttpOnly nos tokens e validação Origin/Referer + double-submit CSRF.

KeyRing AES-256-GCM

Credenciais de gateways B2C e nós de provisionamento são cifradas com chave versionada em repouso.

Domínio Customizado & White-Label

Verificação DNS via TXT e roteamento seguro no middleware Next.js sem necessidade de código customizado.

1. Registro TXT de propriedade

Configure o registro TXT _hostzers-verify.<seu-dominio> com o token gerado em /dashboard/settings.

2. Apontamento CNAME

Aponte seu domínio para o cname de borda configurado no ambiente da plataforma e execute a verificação ativa de DNS.

Provisionamento, IPAM & Outbox

Drivers nativos para Pterodactyl, Proxmox VE, WHM/cPanel, aaPanel e CyberPanel com proteção Anti-SSRF.

Transactional Outbox + BullMQ

Pagamentos confirmados gravam eventos na mesma transação ACID da fatura antes do despacho assíncrono aos nós.

IPAM & Anti-SSRF

Alocação automática de IPs por pool e bloqueio de endereços internos/metadata em URLs de nós configuradas por lojistas.

Precisa de suporte técnico para onboarding ou staging?

Envie sua dúvida pelo formulário de contato ou acesse diretamente seu Portal B2B.