Что такое формат файла PKPASS?
Файлы с расширением .pkpass содержат различные типы данных, упакованные с помощью сжатия ZIP, включая повседневные билеты, посадочные талоны, купоны, членские карты, студенческие билеты, карты лояльности, а также кредитные или дебетовые карты, работающие с Apple Pay.
На мобильном устройстве пропуска отображаются в виде штрих-кодов в таких форматах, как Aztec, PDF417, QR или Code 128 (1D).
Дополнительная информация
Этот формат был представлен в 2012 году компанией Apple для приложения Passbook, переименованного в Apple Wallet в iOS 9 (2015). Его также можно открыть с помощью других программ на различных платформах.
Внутри пакет .pkpass представляет собой ZIP-архив, содержащий несколько обязательных файлов:
pass.json- основные данные пропуска: тип, поля отображения, цвета и URL-адресаmanifest.json- JSON словарь контрольных сумм SHA-1 для каждого включенного файлаsignature- отсоединенная подпись PKCS#7, созданная с помощью сертификата Pass Type ID, выданного Apple- графические ресурсы, такие как
icon.png,logo.pngиstrip.png
Файлы .pkpass могут распространяться различными способами - внутри приложений, веб-сайтов, социальных платформ, через SMS, MMS, электронную почту, а также с помощью QR-кодов или штрих-кодов.
Безопасность и защита
РИСК: LOWФайлы PKPASS криптографически подписаны сертификатом, выданным Apple, и содержат только данные и изображения - без исполняемого кода - поэтому они не могут заразить устройство. Wallet отклоняет пропуска, подпись которых не проходит проверку. Реальный риск связан с конфиденциальностью: штрих-код пропуска кодирует данные вашего бронирования/билета, поэтому не делитесь файлами пропусков или скриншотами публично и будьте осторожны при загрузке посадочных талонов на сайты онлайн-конвертации.
Детали формата
в двух словахПОЛНОЕ НАЗВАНИЕApple Wallet Pass (formerly Passbook)
РАЗРАБОТЧИКApple Inc.с 2012 (iOS 6, as Passbook; app renamed Wallet in iOS 9, 2015)
КАТЕГОРИЯФайлы данных
MIME-ТИПapplication/vnd.apple.pkpass
ТИПЦифровой подписанный пакет пропуска на базе ZIP (JSON + изображения + подпись PKCS#7)
СТАНДАРТОткрытый · без роялти
MAGIC BYTES · СИГНАТУРА ФАЙЛА
СМЕЩЕНИЕ
00010203
HEX
504B0304
ASCII
PK··
Идентичен любому ZIP; отличается наличием внутренних файлов pass.json + manifest.json + signature
Программы, открывающие файлы PKPASS
Windows1 app
7-Zip
Открытый код Правой кнопкой мыши → Открыть архив (это ZIP): просмотрите pass.json для получения подробностей и откройте изображения штрих-кодов - этого достаточно, чтобы показать билет в экстренной ситуации. 
macOS1 app
Pass Viewer (built-in)
Встроенная Дважды щелкните по .pkpass - Просмотр пропусков в macOS покажет превью и предложит «Добавить в Wallet» через ваш iPhone/iCloud. 
Android3 apps
PassWallet
Freemium Установите, затем откройте вложение .pkpass и выберите PassWallet; оно сохраняет и отображает штрих-код для сканирования.
WalletPasses
Бесплатно Установите, откройте файл .pkpass с помощью WalletPasses; оно автоматически импортирует пропуска, найденные на устройстве.
Pass2U Wallet
Freemium Откройте .pkpass с помощью Pass2U; также может восстанавливать пропуска из штрих-кодов/PDF и синхронизировать их с облаком.
iOS1 app
Apple Wallet
Встроенная Нажмите на вложение .pkpass (Mail, Safari, Сообщения) → откроется предпросмотр → нажмите «Добавить». Встроено в iOS начиная с iOS 6. Технические подробности
глубокая спецификация| Формат контейнера | ZIP-архив; магические байты 50 4B 03 04 («PK» - заголовок локального файла) |
| Обязательные внутренние файлы | pass.json, manifest.json, signature и как минимум одно изображение иконки |
| Дескриптор пропуска | pass.json - определяет тип пропуска, поля отображения, цвета, тип штрих-кода и URL-адреса веб-сервисов |
| Манифест целостности файлов | manifest.json - JSON-словарь контрольных сумм SHA-1 для каждого файла в пакете |
| Цифровая подпись | Отсоединенная подпись PKCS#7 (файл с именем signature), подписанная сертификатом Pass Type ID, выданным Apple |
| Центр сертификации | Apple Developer Program; для создания действительных подписей требуется сертификат Pass Type ID |
| MIME-тип | application/vnd.apple.pkpass |
| Поддерживаемые форматы штрих-кодов | Aztec, PDF417, QR Code, Code 128 (1D) |
| Типы пропусков | boardingPass, coupon, eventTicket, generic, storeCard (определяются в pass.json) |
| Графические ресурсы | Файлы PNG: icon.png, logo.png, strip.png, thumbnail.png, background.png; варианты для Retina с суффиксами @2x и @3x |
| Поддержка NFC | Дополнительная полезная нагрузка NFC для бесконтактного считывания; требуется разрешение Apple, предоставленное эмитенту |
| Каналы распространения | Вложение в электронную почту, загрузка с веб-сайта, доставка внутри приложения, AirDrop, SMS/MMS, сканирование QR-кода |
| Пакет из нескольких пропусков | Несколько пропусков могут быть упакованы вместе в файл .pkpasses (также на базе ZIP) |
| Поддержка платформ | Нативная в iOS и macOS (Apple Wallet); поддержка Android через сторонние приложения, такие как PassWallet и Pass2U Wallet |
| Выпущен | 2012 (iOS 6, as Passbook; app renamed Wallet in iOS 9, 2015) |
| Открыть стандартное | Да · без роялти |
| Спецификация | developer.apple.com |
Конвертации PKPASS
Возможно
.PKPASS .ZIPРУКОВОДСТВО
Да - файл .pkpass внутри является ZIP-архивом; скопируйте файл, измените расширение на .zip, и любой…
Как конвертировать
.PKPASS .PDFРУКОВОДСТВО
Да - .pkpass можно конвертировать в PDF, открыв его в средстве просмотра пропусков и отправив на печать через…
Как конвертировать
.PKPASS .JPGРУКОВОДСТВО
Да - изображения внутри файла .pkpass можно извлечь и сохранить как JPG, либо вы можете сделать скриншот…
Как конвертировать
.PKPASS .PNGРУКОВОДСТВО
Да - изображения PNG уже упакованы внутри каждого файла .pkpass; переименуйте копию в .zip, откройте её любым…
Как конвертировать
Вопросы и ответы сообщества
спрошено пользователямиВопросов пока нет - станьте первым, кто спросит о файлах PKPASS.
Часто задаваемые вопросы
Как открыть файл PKPASS на Android?
В Android нет встроенной поддержки. Установите PassWallet, WalletPasses или Pass2U Wallet из Google Play, затем откройте вложение .pkpass с помощью этого приложения - оно сохранит билет и отобразит сканируемый штрих-код.
Могу ли я добавить PKPASS в Google Wallet?
Напрямую нет - Google Wallet использует собственный формат пропусков и не импортирует файлы .pkpass. Используйте стороннее приложение для пропусков или проверьте, предлагает ли эмитент кнопку «Добавить в Google Wallet».
Как конвертировать PKPASS в PDF, чтобы распечатать билет?
Откройте пропуск в Wallet или приложении для пропусков и распечатайте/сохраните как PDF, либо переименуйте файл в .zip и распечатайте извлеченный штрих-код вместе с данными из pass.json. Убедитесь, что место проведения или авиакомпания принимают распечатанные штрих-коды.
Почему мой PKPASS не открывается на iPhone?
Обычно срок действия пропуска истек, он поврежден или его подпись недействительна - Wallet молча отклоняет такие пропуска. Скачайте заново по ссылке эмитента или из письма; также убедитесь, что вы нажимаете на него в Mail/Safari, а не в стороннем средстве просмотра.
Что находится внутри файла PKPASS?
Это ZIP-архив, содержащий pass.json (данные билета и содержимое штрих-кода), изображения icon/logo, manifest.json с хешами файлов и цифровую подпись эмитента пропуска.
Можно ли редактировать файл PKPASS?
Вы можете редактировать pass.json после распаковки, но пропуск больше не установится в Wallet - подпись не совпадет. Только эмитент (со своим сертификатом Apple pass) может создавать валидные пропуска.
Ссылки
1Apple Developer - Wallet Passes documentationdeveloper.apple.com
2Apple Developer - Building a Pass (bundle layout, manifest, signature)developer.apple.com
