PKPASS (passe Apple Wallet) : fichier .pkpass

Un fichier .pkpass contient un passe pour l’app Cartes d’Apple (Wallet) : carte d’embarquement, billet de train ou de concert, carte de fidélité, coupon. C’est une archive ZIP signée par l’émetteur avec un certificat délivré par Apple.

Structure

Apple décrit la fabrication d’un passe ainsi : on prépare un dossier, on le compresse en ZIP, puis on remplace l’extension .zip par .pkpass. Le fichier commence donc par la signature ZIP (50 4B 03 04). Ce qui le distingue d’un ZIP quelconque, ce sont trois fichiers à la racine :

• pass.json : la description du passe (type, numéro de série, identifiants de l’émetteur, champs affichés, code-barres) ;
• manifest.json : l’empreinte SHA-1 de chacun des fichiers du passe ;
• signature : la signature PKCS #7 détachée du manifeste, faite avec la clé du certificat « Pass Type ID » de l’émetteur.

S’y ajoutent les images (icône, logo) et des dossiers de traduction (fr.lproj/). Contrairement à un EPUB ou un document OpenDocument, il n’y a pas de fichier mimetype en tête d’archive.

La signature garantit l’origine et l’intégrité : modifier un seul fichier, même une image, invalide le manifeste et Wallet refuse le passe. Apple exige que les serveurs envoient les passes avec le type MIME application/vnd.apple.pkpass, qui n’est pas enregistré à l’IANA. Un lot de plusieurs passes porte l’extension .pkpasses.

Et sur Android ?

Google publie un outil libre, pass-converter, qui convertit un passe Apple en passe Google Wallet et inversement ; il s’adresse surtout aux émetteurs. Pour l’utilisateur, Google Wallet propose aussi d’ajouter un passe à partir d’une photo ou d’une capture d’écran contenant son code-barres.

Un passe vivant

Un passe peut déclarer un service web de mise à jour : l’émetteur pousse alors les changements (porte d’embarquement, horaire, solde de points) directement sur le passe installé. C’est utile, mais cela signifie aussi qu’un passe partagé reste lié au compte et aux mises à jour de son émetteur.