Як налаштувати корпоративні перепустки в 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 співробітників.
Гарантія: ми надаємо тривалу технічну підтримку після впровадження. За час практики ми не втратили жодного клієнта — всі проекти працюють стабільно.
