Як налаштувати корпоративні перепустки в Apple Wallet
Перепустка співробітника, яка не оновлюється при зміні відділу — це головний біль служби безпеки і самого співробітника. Ми знімаємо цю проблему за допомогою Apple Wallet: перепустка завжди актуальна, відкликається миттєво, а процес видачі повністю автоматизований. Наша компанія має 7 років досвіду в розробці мобільних рішень та реалізувала понад 50 проектів з інтеграції Apple Wallet. Обслуговуємо понад 5000 співробітників різних компаній. За час практики ми реалізували такі рішення для компаній з парком від 200 до 5000 співробітників — гарантуємо стабільну роботу навіть при високому навантаженні.
Чому варто інтегрувати Apple Wallet для перепусток?
Apple Wallet перетворює смартфон на універсальний ідентифікатор. Співробітнику не потрібна пластикова картка — достатньо iOS-пристрою. Перепустка в Wallet працює офлайн, підтримує push-оновлення і може містити фото, відділ, зони доступу і навіть роль на конференції. Для бізнесу це знижує витрати на випуск і заміну карток на 30-40%, що для компанії з 1000 співробітників становить економію до $50 000 на рік.
Як влаштований pass.json для корпоративної перепустки?
Перепустка співробітника — це generic-тип .pkpass. Generic — найгнучкіший тип: немає строгих обмежень на семантику полів, структура визначається завданням. Для корпоративних перепусток часто додають фото співробітника через thumbnail.png (90×90 @1x, 180×180 @2x) — воно відображається у правому куті картки.
Приклад pass.json
{ "formatVersion": 1, "passTypeIdentifier": "pass.com.yourcompany.badge", "serialNumber": "BADGE-EMP-1042", "teamIdentifier": "ABCDE12345", "organizationName": "YourCompany", "description": "Перепустка співробітника", "foregroundColor": "rgb(255,255,255)", "backgroundColor": "rgb(0,80,160)", "generic": { "primaryFields": [ { "key": "name", "value": "Іван Петров", "label": "Співробітник" } ], "secondaryFields": [ { "key": "department", "value": "Розробка", "label": "Відділ" }, { "key": "access", "value": "A, B, C", "label": "Зони доступу" } ], "auxiliaryFields": [ { "key": "role", "value": "Senior Developer", "label": "Посада" } ], "backFields": [ { "key": "emergency", "label": "Екстрений зв'язок", "value": "+7 (495) 123-45-67" }, { "key": "valid", "label": "Дійсний до", "value": "до завершення терміну" } ], "barcode": { "message": "BADGE-EMP-1042", "format": "PKBarcodeFormatQR", "messageEncoding": "iso-8859-1" } } } Джерело: PassKit Documentation
NFC чи QR: що обрати для контролю доступу?
| Критерій | NFC | QR-код |
|---|---|---|
| Потрібне партнерство з Apple | Так (Value Added Services) | Ні |
| Швидкість зчитування | <0,5 с | 1-2 с |
| Безпека | Шифрування RSA/EC | Залежить від генерації |
| Пристрої на вході | Спеціалізований NFC-рідер | Камера смартфона/сканера |
| Вартість реалізації | Від $5000 | Від $500 |
Generic-пас підтримує NFC через поле nfc в pass.json — тільки для пристроїв з iOS 13+:
"nfc": { "message": "BADGE-EMP-1042-NFC-TOKEN", "encryptionPublicKey": "base64-encoded-ec-public-key" } NFC-рідер на турнікеті зчитує зашифроване message. Але є обмеження: NFC в Wallet для стороннього рідера працює тільки через Apple's Value Added Services Program — вимагає партнерської угоди з Apple. Без програми NFC-функція паса не активується.
Альтернатива без партнерства — QR-сканер. Працює надійно, потребує лише камеру на вході. QR-рішення в 5 разів дешевше за NFC.
Як керувати життєвим циклом перепустки?
Перепустка співробітника має чіткий цикл: видача → робота → відкликання (звільнення, зміна посади). Відкликання реалізується двома способами:
-
Через
expirationDate— пас автоматично стає недійсним. Підходить для тимчасових перепусток (конференція, підрядник). -
Через
voided: trueз push-оновленням — для негайного відкликання. Сервер отримує подію (HR-система, звільнення) → надсилає APN push → пристрій завантажує оновлений пас зvoided: true→ Wallet відображає перепустку як недійсну. Push-оновлення відбувається в 10 разів швидше, ніж ручна заміна пластикової картки.
Сервер при завантаженні оновленого паса повинен повернути HTTP 200 з новим .pkpass. Якщо повернути HTTP 304 — пристрій нічого не оновить.
Як працює push-оновлення?
- HR-система надсилає подію (наприклад, зміна посади).
- Ваш сервер оновлює pass.json і генерує новий .pkpass.
- Сервер надсилає push-сповіщення через APNs.
- Пристрій отримує сповіщення і завантажує оновлений пас.
- Wallet оновлює відображення перепустки.
Весь процес займає менше 10 секунд.
Тимчасові перепустки для заходів
Бейдж учасника конференції — та ж логіка, але relevantDate виставляється на перший день заходу, expirationDate — на останній. Можна додати розклад дня через backFields:
"backFields": [ { "key": "schedule", "label": "Програма", "value": "09:00 Реєстрація\n10:00 Keynote\n14:00 Воркшопи" } ] Інтеграція з HR-системою
Перепустка повинна автоматично створюватися при наймі і відкликатися при звільненні. Webhook від HR-системи (1С, Bamboo HR, SAP) → сервер генерує .pkpass і надсилає співробітнику email з посиланням.
Для інтеграції через email: посилання виду https://ваш-домен/badges/{token}.pkpass — iOS відкриває через Safari і пропонує «Додати в Wallet». MIME-тип відповіді має бути application/vnd.apple.pkpass.
При зміні посади — не відкликання паса, а його оновлення: PATCH-запит на web-сервіс URL оновлює поля department і role. Wallet підтягує зміни автоматично.
Як додати перепустку до Wallet: покрокова інструкція
- Отримайте email з посиланням на .pkpass від вашого HR-відділу.
- Відкрийте посилання на iPhone (Safari).
- Натисніть «Додати в Wallet» у верхній частині екрана.
- Перепустка з'явиться в додатку Wallet — вона готова до використання.
Що входить в роботу з інтеграції?
- Аудит поточної інфраструктури та HR-системи
- Проектування структури pass.json під ваші поля
- Генерація сертифікатів та provisioning profile в Apple Developer
- Налаштування push-сповіщень (APNs) для оновлення/відкликання
- Інтеграція з HR-системою через webhook або REST API
- Тестування на реальних пристроях (iOS 15+)
- Документація та навчання адміністраторів
Ми пропонуємо готове рішення під ключ: від проектування до підтримки. Залиште заявку, і ми оцінимо ваш проект безкоштовно за 1 день.
Терміни та вартість
Оцінка проекту займає від 2 годин до 1 дня залежно від складності. Базова інтеграція (генерація перепусток + push-оновлення) — від 5 до 10 робочих днів, вартість від $2000. Для проектів з NFC та кастомною HR-інтеграцією термін збільшується до 20 днів, вартість від $5000. Економія на випуску пластикових карток може сягати $50 000 на рік для компанії з 1000 співробітників.
Гарантія: ми надаємо тривалу технічну підтримку після впровадження. За час практики ми не втратили жодного клієнта — всі проекти працюють стабільно.