Skip to content
Guida del Centro assistenza · Sicurezza e conformità
3 min di letturaVerificato 2026-11-16

Politiche di sicurezza e conformità

Esamina l'architettura AWS UE a Francoforte (eu-central-1), cifratura TLS, certificati e sub-responsabili.

In questa guida

Residenza dei dati nell'UE e infrastruttura cloud (eu-central-1)

Passinstance è progettato con un'architettura di sicurezza e residenza dei dati incentrata sull'Unione Europea, ospitata all'interno di Amazon Web Services Europe (Francoforte, eu-central-1), con controlli legali, sulla privacy e sulla sicurezza del workspace accessibili in /settings/workspace/security, /settings/workspace/privacy e /settings/workspace/legal. Tutti i cluster di calcolo principali, i database transazionali, i livelli di cache e lo storage di oggetti crittografato operano all'interno di sottoreti VPC private a Francoforte.

FLUSSO ARCHITETTURALE
ARCHITETTURA INTERATTIVA
PERIMETRO DI SICUREZZA DI FRANCOFORTE (eu-central-1)
FASE 01 LIVELLO EDGE E INGRESSO (TLS 1.3 / HSTS / WAF)
Verifica CSRF, Rate Limiter Burst da 1 secondo e convalida rigorosa dei DTO
FASE 02 VPC PRIVATA AWS FRANCOFORTE (eu-central-1)
Calcolo: API NestJS e Worker background job queue (Sottoreti container isolate)
Persistenza: encrypted database (Crittografato a riposo con AES-256) e in-memory cache
Key encrypted storage: Crittografia envelope KMS per .p12 Apple e credenziali Google
Media Store: S3 (passinstance-uploads-euc1) con criteri OAC privati
FASE 03 Guardia in uscita (Webhook URL Validator / Blocco SSRF)
SUB-RESPONSABILI CLOUD DEI WALLET
Apple APNs (api.push.apple.com)
API REST Google Wallet
ENDPOINT WEBHOOK DEL TENANT
Solo destinazioni HTTPS pubbliche
Blocca RFC 1918 / Loopback / Metadata

Controlli crittografici e protezione dei certificati

Passinstance applica rigorosi standard crittografici per i dati in transito, i dati a riposo e il materiale di firma dei wallet:

Livello di sicurezzaStandard di controlloDettagli di implementazione
Crittografia in transitoTLS 1.3 / TLS 1.2+Applicata su tutti gli endpoint API HTTPS (/api/v1/), gli smart link di download (/d/:slug) e le connessioni HTTP/2 APNs.
Database e archiviazione a riposoAES-256-GCMI volumi encrypted database, i backup automatizzati del database, la persistenza in-memory cache e i bucket S3 sono crittografati a riposo tramite AWS KMS.
Chiavi di firma .p12 di AppleCrittografia EnvelopeI certificati .p12 Apple Pass Type ID caricati e le relative chiavi private (CertificatePkey) vengono crittografati prima del salvataggio e decrittografati esclusivamente in memoria durante la firma PKCS#7 del file .pkpass.
Credenziali Google WalletArchiviazione crittografata in encrypted storageLe chiavi private dei Service Account Google Cloud utilizzate per firmare i JWT "Aggiungi al Wallet" e le richieste REST PATCH sono crittografate a riposo e non vengono mai esposte nelle risposte API o nei log.
Integrità dei webhookHMAC-SHA256I payload dei webhook in uscita sono firmati utilizzando segreti specifici per tenant (X-Webhook-Signature: sha256=<hex_digest>).

Sicurezza applicativa e protezioni del perimetro di rete

1. Protezione SSRF (OutboundUrlUtil e Webhook URL Validator)

Ogni volta che Passinstance avvia richieste HTTP in uscita — ad esempio per recapitare webhook push o recuperare asset remoti dei pass — Webhook URL Validator e OutboundUrlUtil risolvono i record DNS di destinazione e bloccano le connessioni verso intervalli IPv4/IPv6 privati (10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16), indirizzi di loopback (127.0.0.1, ::1), sottoreti link-local (endpoint di metadati cloud 169.254.169.254) e schemi non HTTPS in produzione.

2. Protezioni CSRF e convalida degli input

Tutte le richieste della Dashboard che modificano lo stato applicano la convalida del token Cross-Site Request Forgery (CSRF) e la verifica rigorosa dell'Origin. Ogni DTO dell'API viene convalidato al perimetro del controller tramite class-validator con whitelist: true e forbidNonWhitelisted: true per rifiutare qualsiasi proprietà non prevista nel payload.

3. Rigoroso isolamento multi-tenant

Ogni query al database, job in background background job queue, chiave di cache e percorso di asset S3 è rigorosamente circoscritto da customerId (o organizationId). I tentativi di accesso cross-tenant vengono bloccati in modalità fail-closed con 403 Forbidden o 404 Not Found prima dell'esecuzione di qualsiasi logica di dominio.

Sub-responsabili del trattamento e dipendenze dell'ecosistema

Sebbene Passinstance archivi tutti i dati principali dei tenant in AWS Francoforte (eu-central-1), l'erogazione di pass nativi per portafogli mobili interagisce intrinsecamente con i fornitori dei sistemi operativi dei dispositivi:

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: Le chiavi di firma private (certificati .p12 e chiavi JSON dei Service Account Google) sono segreti di sola scrittura. Né il personale di supporto di Passinstance né gli amministratori del workspace possono scaricare una chiave privata in chiaro dopo che è stata caricata; le chiavi compromesse devono essere revocate nell'Apple Developer Portal o nella Google Cloud Console e sostituite tramite /api/v1/certificates.

Consulti la nostra postura di conformità aggiornata e i contratti legali nelle pagine /security, /privacy e /terms.

Documentazione prodotto e API correlata

Pronto a lanciare il tuo primo programma di carte Wallet?

Crea il tuo workspace, configura il modello e testa una carta reale in Apple Wallet e Google Wallet prima di scalare.