Skip to content
Guia da Central de Ajuda · Segurança e conformidade
3 min de leituraVerificado 2026-11-16

Políticas de segurança e conformidade

Consulte alojamento AWS na UE em Frankfurt (eu-central-1), encriptação TLS, proteção de certificados e subcontratantes.

Neste guia

Residência de Dados na UE e Infraestrutura Cloud (eu-central-1)

O Passinstance foi concebido com uma arquitetura de segurança e residência de dados centrada na UE dentro da Amazon Web Services Europa (Frankfurt, eu-central-1), estando os controlos jurídicos, de privacidade e de segurança do espaço disponíveis em /settings/workspace/security, /settings/workspace/privacy e /settings/workspace/legal. Todos os clusters principais de computação, bases de dados transacionais, camadas de cache e armazenamento de objetos encriptado funcionam em sub-redes VPC privadas em Frankfurt.

FLUXO DE ARQUITETURA
ARQUITETURA INTERATIVA
FRONTEIRA DE SEGURANÇA EM FRANKFURT (eu-central-1)
ETAPA 01 CAMADA DE FRONTEIRA E INGRESSO (TLS 1.3 / HSTS / WAF)
Verificação CSRF, limitador de picos 1s e validação estrita de DTOs
ETAPA 02 VPC PRIVADA AWS FRANKFURT (eu-central-1)
Computação: API NestJS e workers background job queue (Sub-redes de contentores isoladas)
Persistência: encrypted database (Encriptação AES-256 em repouso) e in-memory cache
Cofre Chaves: Encriptação envelope KMS para .p12 Apple e credenciais Google
Media Store: S3 (passinstance-uploads-euc1) com políticas privadas OAC
ETAPA 03 Guarda de saída (Webhook URL Validator / Bloq. SSRF)
SUBCONTRATANTES CLOUD DAS WALLETS
Apple APNs (api.push.apple.com)
Google Wallet REST API
ENDPOINTS WEBHOOK DOS INQUILINOS
Apenas destinos HTTPS públicos
Bloqueia RFC 1918 / Loopback / Meta

Controlos Criptográficos e Proteção de Certificados

O Passinstance impõe normas criptográficas rigorosas para dados em trânsito, em repouso e material de assinatura Wallet:

Camada de SegurançaNorma de ControloDetalhes de Implementação
Encriptação em TrânsitoTLS 1.3 / TLS 1.2+Imposto em todos os endpoints API HTTPS (/api/v1/), ligações inteligentes de transferência (/d/:slug) e ligações APNs HTTP/2.
Base de Dados e Armazenamento em RepousoAES-256-GCMVolumes encrypted database, cópias de segurança automáticas, persistência in-memory cache e buckets S3 são encriptados em repouso via AWS KMS.
Chaves de Assinatura Apple .p12Encriptação EnvelopeCertificados .p12 Apple Pass Type ID e chaves privadas carregadas (CertificatePkey) são encriptados antes da gravação e desencriptados apenas em memória durante a assinatura PKCS#7 do .pkpass.
Credenciais Google WalletCofre EncriptadoChaves privadas de contas de serviço Google Cloud usadas para assinar JWTs Save-to-Wallet e pedidos REST PATCH permanecem encriptadas em repouso e nunca são expostas na API nem em registos.
Integridade de WebhooksHMAC-SHA256Os payloads de webhook enviados são assinados com segredos próprios de cada inquilino (X-Webhook-Signature: sha256=<hex_digest>).

Segurança Aplicacional e Defesas de Fronteira de Rede

1. Proteção SSRF (OutboundUrlUtil e Webhook URL Validator)

Sempre que o Passinstance inicia pedidos HTTP de saída — como entrega de webhooks push ou obtenção de recursos remotos de cartões — Webhook URL Validator e OutboundUrlUtil resolvem registos DNS de destino e bloqueiam ligações para gamas privadas IPv4/IPv6 (10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16), endereços loopback (127.0.0.1, ::1), sub-redes link-local (169.254.169.254 de metadados cloud) e esquemas sem HTTPS em produção.

2. Guardas CSRF e Validação de Entrada

Todos os pedidos do painel que modificam estado exigem validação de token Cross-Site Request Forgery (CSRF) e verificação estrita de Origin. Todos os DTOs da API são validados na fronteira do controlador com class-validator, whitelist: true e forbidNonWhitelisted: true para rejeitar propriedades inesperadas.

3. Isolamento Multi-Inquilino Estrito

Cada consulta à base de dados, tarefa em fila background job queue, chave de cache e caminho no S3 é estritamente delimitada por customerId (ou organizationId). Tentativas de acesso entre inquilinos falham de forma segura com 403 Forbidden ou 404 Not Found antes da execução de qualquer lógica de domínio.

Subcontratantes e Dependências do Ecossistema

Embora o Passinstance armazene todos os dados principais dos clientes na AWS Frankfurt (eu-central-1), a entrega de cartões nativos móveis interage por natureza com os fornecedores dos sistemas operativos dos dispositivos:

JSON
{
  "primaryHostingRegion": "eu-central-1 (AWS Europe Frankfurt)",
  "coreSubprocessors": [
    {
      "provider": "Amazon Web Services EMEA SARL",
      "purpose": "Compute, database, in-memory cache, KMS, S3, SES",
      "location": "Frankfurt, Germany (eu-central-1)"
    },
    {
      "provider": "Apple Inc.",
      "purpose": "Apple Push Notification service (APNs) for iOS/watchOS pass refreshes",
      "location": "Global APNs Edge Network"
    },
    {
      "provider": "Google LLC",
      "purpose": "Google Wallet REST API (`walletobjects`) for Android pass persistence",
      "location": "Global Google Cloud Infrastructure"
    },
    {
      "provider": "Stripe Payments Europe, Ltd.",
      "purpose": "PCI-DSS Level 1 payment processing and subscription invoicing",
      "location": "EU / Global"
    }
  ]
}

Importante: As chaves privadas de assinatura (certificados .p12 e chaves JSON de Contas de Serviço Google) são segredos apenas de escrita (write-only). Nem o suporte do Passinstance nem os administradores do espaço podem transferir uma chave privada após o carregamento; chaves comprometidas devem ser revogadas no Apple Developer Portal ou Google Cloud Console e substituídas em /api/v1/certificates.

Consulte a nossa postura de conformidade e acordos legais em /security, /privacy e /terms.

Documentação de produto e API relacionada

Pronto para lançar o seu primeiro programa de cartões Wallet?

Crie o seu espaço de trabalho, configure o seu modelo e teste um cartão real na Apple Wallet e Google Wallet antes de escalar.