Vous avez téléchargé un fichier qui se termine par .pkpass et vous ne savez pas quoi en faire. Il vient peut-être d'une compagnie aérienne, d'un vendeur de billets ou d'un programme de fidélité. Votre iPhone l'a peut-être ouvert automatiquement, ou il reste peut-être dans votre dossier Téléchargements sans rien faire.
Un fichier .pkpass est le format natif des passes Apple Wallet. Comprendre ce qu'il contient et comment il fonctionne vous aide à résoudre les problèmes, à savoir quelles données il contient et même à créer vos propres passes à partir de billets et de cartes existants.
Le format de fichier .pkpass
Un fichier .pkpass est une archive ZIP dont l'extension a été modifiée. Si vous remplacez l'extension .pkpass par .zip sur un ordinateur, vous pouvez l'extraire et voir les fichiers qu'elle contient. Apple a conçu ce format spécialement pour les passes Wallet. Il contient tout ce dont Wallet a besoin pour afficher un pass : mise en page, champs de texte, couleurs, données du code-barres, images et signature cryptographique prouvant son authenticité.
Lorsque vous touchez un fichier .pkpass sur votre iPhone, Wallet lit l'archive, vérifie la signature et affiche un aperçu. Si tout est correct, vous pouvez l'ajouter à Wallet en un geste. Pour en savoir plus sur ce processus, consultez comment ajouter des passes à Wallet.
Que contient un fichier .pkpass ?
Tous les fichiers .pkpass contiennent les mêmes composants essentiels. Voici ce que vous trouverez si vous renommez un fichier en .zip et l'extrayez :
pass.json
Le fichier principal. Il contient au format JSON la mise en page du pass, les champs de texte, les couleurs, les données du code-barres, les dates et le nom de l'organisation.
manifest.json
La liste des fichiers du paquet, à l'exception de manifest.json et de signature, avec leurs hachages SHA-1. Wallet l'utilise pour vérifier qu'aucune modification n'a été effectuée après la signature.
signature
Une signature cryptographique PKCS#7 créée avec le certificat de l'émetteur délivré par Apple. Elle prouve que le pass provient d'une source de confiance.
Ressources d'image
Des images de logo, d'icône, de bandeau et de vignette en plusieurs résolutions. Elles donnent au pass son apparence visuelle dans Wallet.
Certains passes incluent aussi des dossiers de localisation (comme en.lproj) avec des chaînes traduites dans différentes langues. Un fichier .pkpass est un paquet ZIP dont la taille varie selon les images et les métadonnées qu'il contient.
Types de passes dans les fichiers .pkpass
Le fichier pass.json présent dans le paquet indique le type de pass. Apple Wallet en prend en charge plusieurs, chacun avec une mise en page différente :
Billets d'événement
Billets de concert, de match ou de conférence. Ils contiennent la date, le lieu, les informations de place et un code-barres scannable.
Cartes d'embarquement
Passes de compagnies aériennes et de transport avec les informations de départ et d'arrivée, le numéro de porte et les détails du vol.
Cartes de magasin
Cartes de fidélité, cartes de membre et programmes de récompenses. Elles peuvent inclure un code-barres et le solde de points.
Coupons
Codes de réduction, offres promotionnelles et cartes cadeaux avec une date d'expiration et un code-barres à utiliser.
Il existe aussi un type de pass générique pour ce qui ne correspond pas aux catégories ci-dessus. Pour en savoir plus sur les possibilités de Wallet, consultez les fonctions d'Apple Wallet expliquées.
Comment fonctionne la sécurité des .pkpass
Chaque fichier .pkpass est signé cryptographiquement. L'émetteur crée le pass, le signe avec un certificat délivré par Apple et intègre la signature au fichier. Lorsque vous ouvrez le fichier, Wallet vérifie que la signature correspond au contenu et que le certificat est toujours valide. Si un contrôle échoue, Wallet refuse d'ajouter le pass.
Vous ne pouvez donc pas modifier un fichier .pkpass en espérant qu'il continue à fonctionner. La modification d'un seul octet invalide la signature. Pour en savoir plus sur la protection des données du pass, consultez la FAQ sur la confidentialité de NeatPass.
Pourquoi la signature est importante
Comment ouvrir des fichiers .pkpass
Ouvrir un fichier .pkpass sur iPhone est simple. Voici ce qui se passe selon la façon dont vous l'avez reçu :
Depuis un e-mail ou un message
Depuis un lien de téléchargement
Depuis l'app Fichiers
Si le fichier ne s'ouvre pas, la signature est peut-être invalide ou le certificat a peut-être expiré. Consultez la procédure pour réparer les fichiers .pkpass qui ne s'ouvrent pas pour un dépannage détaillé.
Transformez n'importe quelle carte en pass Wallet
NeatPass facilite la conversion de n'importe quel billet, pass ou carte de fidélité en pass Apple Wallet.
Créer des fichiers .pkpass sans coder
Traditionnellement, créer des fichiers .pkpass nécessitait un compte Apple Developer, une infrastructure serveur et des connaissances du framework PassKit. C'est adapté aux compagnies aériennes et aux grandes entreprises, mais peu pratique si vous voulez simplement ajouter votre carte de salle de sport à Wallet.
NeatPass gère l'importation et la préparation du pass sur votre iPhone. Il utilise une IA exécutée sur l'appareil et basée sur le framework MLX d'Apple pour extraire les codes-barres et le texte des PDF, photos et captures d'écran, puis assemble un fichier .pkpass valide. Une brève demande de signature n'envoie qu'un hachage cryptographique au serveur de signature. Vous disposez de six méthodes d'importation différentes.
Partagez ou importez votre source
L'IA extrait les données
Personnalisez et ajoutez à Wallet
Le modèle d'IA s'exécute entièrement sur votre appareil à l'aide du GPU. Découvrez le fonctionnement du modèle d'IA.
NeatPass prend en charge les principaux formats de codes-barres, notamment QR, Aztec, PDF417, Code 128 et bien d'autres. Consultez la liste complète des formats de codes-barres pris en charge.
Questions fréquentes
Créez vos propres passes Wallet
TéléchargerLe format de votre pass décodé
Un fichier .pkpass est moins mystérieux qu'il n'en a l'air. Il s'agit d'une archive ZIP contenant des données structurées, des images et une signature numérique qu'Apple Wallet sait lire. La plupart des utilisateurs les reçoivent en pièce jointe ou via un lien de téléchargement fourni par un vendeur de billets, une compagnie aérienne ou un programme de fidélité.
Si vos cartes ou billets ne sont pas arrivés sous forme de fichiers .pkpass, NeatPass peut les créer pour vous. Les passes obtenus sont de vrais fichiers .pkpass, signés cryptographiquement et pleinement fonctionnels dans Wallet, même complètement hors ligne.