Che cos'è il formato di file PKPASS?
I file con estensione .pkpass contengono diversi tipi di dati confezionati con compressione ZIP, inclusi biglietti quotidiani, carte d'imbarco, coupon, tessere associative, ID studenteschi, carte fedeltà e carte di credito o debito che funzionano con Apple Pay.
Su un dispositivo mobile, i pass vengono visualizzati come codici a barre in formati quali Aztec, PDF417, QR o Code 128 (1D).
Informazioni aggiuntive
Questo formato è stato introdotto nel 2012 da Apple per l'app Passbook, rinominata Apple Wallet in iOS 9 (2015). Può essere aperto anche da altri programmi su diverse piattaforme.
Internamente, un pacchetto .pkpass è un archivio ZIP contenente diversi file richiesti:
pass.json: i dati principali del pass: tipo, campi di visualizzazione, colori e URLmanifest.json: dizionario JSON dei checksum SHA-1 per ogni file inclusosignature: una firma PKCS#7 distaccata generata con un certificato Pass Type ID rilasciato da Apple- risorse immagine come
icon.png,logo.pngestrip.png
I file .pkpass possono essere distribuiti in diversi modi: all'interno di app, siti web, piattaforme social, tramite SMS, MMS, e-mail e codici QR o codici a barre.
Sicurezza e incolumità
RISCHIO: LOWI file PKPASS sono firmati crittograficamente con un certificato rilasciato da Apple e contengono solo dati e immagini (nessun codice eseguibile), quindi non possono infettare un dispositivo. Wallet rifiuta i pass la cui firma non è valida. Il vero rischio riguarda la privacy: il codice a barre di un pass codifica i dati della prenotazione o del biglietto, quindi non condividere pubblicamente file di pass o screenshot e presta attenzione quando carichi carte d'imbarco su siti di conversione online.
Dettagli del formato
in sintesiNOME COMPLETOApple Wallet Pass (formerly Passbook)
SVILUPPATOREApple Inc.dal 2012 (iOS 6, as Passbook; app renamed Wallet in iOS 9, 2015)
CATEGORIAFile di dati
TIPO MIMEapplication/vnd.apple.pkpass
TIPOPacchetto pass firmato digitalmente basato su ZIP (JSON + immagini + firma PKCS#7)
STANDARDAperto · royalty-free
MAGIC BYTES · FIRMA DEL FILE
OFFSET
00010203
HEX
504B0304
ASCII
PK··
Identico a qualsiasi ZIP; si distingue per i file interni pass.json + manifest.json + signature
Programmi che aprono file PKPASS
Windows1 app
7-Zip
Open-source Tasto destro → Apri archivio (è uno ZIP): visualizza pass.json per i dettagli e apri le immagini del codice a barre, sufficienti per mostrare un biglietto in caso di emergenza. 
macOS1 app
Pass Viewer (built-in)
Integrato Fai doppio clic sul .pkpass: il Visualizzatore Pass di macOS ne mostra l'anteprima e offre «Aggiungi a Wallet» tramite il tuo iPhone/iCloud. 
Android3 apps
PassWallet
Freemium Installa, quindi apri l'allegato .pkpass e scegli PassWallet; memorizza e visualizza il codice a barre per la scansione.
WalletPasses
Gratuito Installa, apri il file .pkpass con WalletPasses; importa automaticamente i pass trovati sul dispositivo.
Pass2U Wallet
Freemium Apri il .pkpass con Pass2U; può anche ricostruire pass da codici a barre/PDF e sincronizzarli sul cloud.
iOS1 app
Apple Wallet
Integrato Tocca l'allegato .pkpass (Mail, Safari, Messaggi) → si apre l'anteprima → tocca Aggiungi. Integrato in iOS da iOS 6. Dettagli tecnici
specifiche approfondite| Formato contenitore | Archivio ZIP; magic bytes 50 4B 03 04 («PK» local file header) |
| File interni richiesti | pass.json, manifest.json, signature e almeno un'immagine icona |
| Descrittore del pass | pass.json - definisce il tipo di pass, i campi di visualizzazione, i colori, il tipo di codice a barre e gli URL dei servizi web |
| Manifest di integrità dei file | manifest.json - dizionario JSON dei checksum SHA-1 per ogni file nel pacchetto |
| Firma digitale | Firma PKCS#7 distaccata (file denominato signature), firmata con un certificato Pass Type ID rilasciato da Apple |
| Autorità di certificazione | Apple Developer Program; è richiesto un certificato Pass Type ID per generare firme valide |
| Tipo MIME | application/vnd.apple.pkpass |
| Formati di codici a barre supportati | Aztec, PDF417, QR Code, Code 128 (1D) |
| Tipi di pass | boardingPass, coupon, eventTicket, generic, storeCard (definiti in pass.json) |
| Risorse immagine | File PNG: icon.png, logo.png, strip.png, thumbnail.png, background.png; varianti Retina a @2x e @3x |
| Supporto NFC | Payload NFC opzionale per il tocco contactless; richiede un'autorizzazione Apple concessa all'emittente |
| Canali di distribuzione | Allegato e-mail, download da sito web, consegna in-app, AirDrop, SMS/MMS, scansione codice QR |
| Pacchetto multi-pass | Più pass possono essere confezionati insieme come file .pkpasses (anch'esso basato su ZIP) |
| Supporto piattaforma | Nativo su iOS e macOS (Apple Wallet); supporto Android tramite app di terze parti come PassWallet e Pass2U Wallet |
| Rilasciato | 2012 (iOS 6, as Passbook; app renamed Wallet in iOS 9, 2015) |
| Standard aperto | Sì · royalty-free |
| Specifica | developer.apple.com |
Conversioni PKPASS
Possibile
.PKPASS .ZIPGUIDA
Sì - un file .pkpass è internamente un archivio ZIP; copia il file, rinomina l'estensione in .zip e qualsiasi…
Come convertire
.PKPASS .PDFGUIDA
Sì - un file .pkpass può essere convertito in PDF aprendolo in un visualizzatore di pass e stampando su un…
Come convertire
.PKPASS .JPGGUIDA
Sì - le immagini all'interno di un file .pkpass possono essere estratte e salvate come JPG, oppure puoi…
Come convertire
.PKPASS .PNGGUIDA
Sì - le immagini PNG sono già raggruppate all'interno di ogni file .pkpass; rinomina una copia in .zip,…
Come convertire
Domande e risposte della community
chiesto dagli utentiAncora nessuna domanda - sii il primo a chiedere informazioni sui file PKPASS.
Domande frequenti
Come apro un file PKPASS su Android?
Android non ha un supporto integrato. Installa PassWallet, WalletPasses o Pass2U Wallet dal Google Play Store, quindi apri l'allegato .pkpass con quell'app: memorizzerà il biglietto e visualizzerà il codice a barre scansionabile.
Posso aggiungere un PKPASS a Google Wallet?
Non direttamente: Google Wallet utilizza il proprio formato di pass e non importa i file .pkpass. Usa un'app per pass di terze parti o controlla se l'emittente offre invece un pulsante «Aggiungi a Google Wallet».
Come converto un PKPASS in PDF per stampare il mio biglietto?
Apri il pass in Wallet o in un'app per pass e stampa/salva come PDF, oppure rinomina il file in .zip e stampa il codice a barre estratto con i dettagli da pass.json. Verifica che la sede o la compagnia aerea accettino codici a barre stampati.
Perché il mio PKPASS non si apre su iPhone?
Di solito il pass è scaduto, malformato o la sua firma non è valida; Wallet rifiuta silenziosamente tali pass. Scaricalo nuovamente dal link o dall'e-mail dell'emittente; assicurati inoltre di toccarlo in Mail o Safari, non in un visualizzatore di terze parti.
Cosa c'è dentro un file PKPASS?
È uno ZIP contenente pass.json (dati del biglietto e payload del codice a barre), immagini icon/logo, manifest.json con gli hash dei file e una firma digitale dell'emittente del pass.
Posso modificare un file PKPASS?
Puoi modificare pass.json dopo averlo decompresso, ma il pass non si installerà più in Wallet poiché la firma non corrisponderà. Solo l'emittente (con il proprio certificato Apple pass) può produrre pass validi.
Riferimenti
1Apple Developer - Wallet Passes documentationdeveloper.apple.com
2Apple Developer - Building a Pass (bundle layout, manifest, signature)developer.apple.com
