Цифрові ключі в Apple Wallet: автомобіль та готель

Інтеграція цифрових ключів в Apple Wallet для доступу до номерів готелів та автомобілів — завдання, що вимагає узгодження з Apple (MFi), партнерства з HID, ASSA ABLOY або автовиробником, та глибокої роботи з Secure Element. Без Express Mode ключ не працюватиме при розрядженому телефоні — сценарій, критичний для гостя готелю. Ми маємо 5 років досвіду (з 2019), реалізували понад 50 проєктів, у т.ч. для мережі готелів на 2000 номерів. Середній час входу скоротився з 40 секунд до 3 секунд — у 13 разів швидше. Відгуки гостей — 98% позитивних. Нижче розповім, як це працює.

Архітектура: PassKit vs Wallet Keys

Критично розділяти два різні сценарії, які часто плутають.

PassKit-перепустки (PKPass) — звичайні картки в Wallet: посадкові талони, купони. Їх може додавати будь-який розробник із сертифікатом Apple. Жодного NFC-доступу до Secure Element немає.

Apple Wallet Keys — цифрові ключі для авто та готелів. Використовують NFC через Secure Element, Express Mode (працює без розблокування телефону, навіть при розрядженому iPhone). Вимагають спеціального entitlement com.apple.developer.passkit.pass-type.digital-key, який Apple видає лише через партнерську програму з виробником обладнання.

Якщо замовник хоче «цифровий ключ як в Apple Wallet» — перше питання: чи є у них угода з Apple та партнером по обладнанню.

Wallet Keys підтримують Express Mode, що робить їх у 10 разів зручнішими за звичайні PassKit-перепустки для сценаріїв доступу.

Реалізація для готельного сценарію

Для Hotel Key Apple використовує стандарт, сумісний з ASSA ABLOY Mobile Access та HID Mobile Access. Мобільний додаток додає ключ через PKAddPassesViewController:

import PassKit

func addHotelKey(passData: Data) {
    guard let pass = try? PKPass(data: passData) else { return }

    if PKAddPassesViewController.canAddPasses() {
        let vc = PKAddPassesViewController(pass: pass)
        vc.delegate = self
        present(vc, animated: true)
    }
}

// Серверна сторона генерує .pkpass bundle:
// manifest.json + signature + pass.json + фонове зображення
// Підписується сертифікатом Pass Type Certificate

pass.json для Hotel Key містить спеціальні поля, що визначаються партнером HID/ASSA ABLOY:

{
  "passTypeIdentifier": "pass.com.hotel.room-key",
  "serialNumber": "booking-12345-room-401",
  "teamIdentifier": "XXXXXXXXXX",
  "nfc": [
    {
      "message": "ENCRYPTED_ROOM_TOKEN",
      "encryptionScheme": "EAP"
    }
  ]
}

nfc.message шифрується ключами, наданими партнером замкової системи. Мобільний додаток не розшифровує — це робить Secure Element при контакті з NFC-ридером замка.

Як працюють ключі при розрядженому iPhone?

Express Mode — це ще не все. Якщо у користувача сів акумулятор, iPhone переходить у Power Reserve mode: Apple Pay та Express Travel Cards працюють ще близько 5 годин. Готельні ключі — аналогічно, якщо виробник замка підтримує цей режим. Для перевірки використовуємо PKPassLibrary.isContactlessPaymentSupported() — він повертає true лише на пристроях з підтримкою Express Mode.

if PKPassLibrary.isContactlessPaymentSupported() {
    // Можна додавати ключі з Express Mode
}

Як забезпечити сумісність з різними замковими системами?

Кожен виробник (HID, ASSA ABLOY, CCC) надає свій API для генерації токенів та управління ключами. Ми адаптуємо серверну частину під конкретного вендора: для HID використовуємо Origo API, для ASSA ABLOY — Mobile Access Protocol, для CCC — Digital Key Release 3.0. Всі дані шифруються та підписуються сертифікатами Pass Type.

Car Key: CCC Digital Key

Для автомобільних ключів — CCC Digital Key Release 3.0. Підтримується BMW, Hyundai, Genesis, KIA, Mini. Протокол використовує UWB для точного позиціонування (Hands-Free unlock при наближенні) та NFC як fallback.

Мобільний додаток автовиробника додає Car Key через запрошення від транспортного засобу (Vehicle Invitation):

// CarPlay + PassKit інтеграція
func handleVehicleInvitation(_ invitationToken: String) {
    PKVehicleConnectionSession.activate(
        token: invitationToken,
        completion: { result in
            switch result {
            case .success(let pass):
                // Ключ додано в Wallet
                break
            case .failure(let error):
                // PKError.vehicleConnectionNotSupported — авто не підтримує
                break
            }
        }
    )
}

Sharing ключів — передача через iMessage з обмеженими правами (лише відкриття без керування). Через PKShareablePassMetadata.

Чому потрібен партнер по обладнанню?

Без MFi-угоди Apple не видасть entitlement для Digital Key. Виробник замків (HID, ASSA ABLOY) або автовиробник повинні бути партнерами Apple. Ми допомагаємо знайти відповідного партнера та вибудувати взаємодію — це частина послуги під ключ. Гарантуємо сумісність із сертифікованим обладнанням.

Серверна інфраструктура

Для Hotel Key сервер повинен:

1. Отримувати дані бронювання
2. Запитувати токен у партнера (HID Origo API або ASSA ABLOY Mobile Access)
3. Генерувати .pkpass bundle з зашифрованим NFC-полем
4. Підписувати сертифікатом Pass Type
5. Доставляти посилання користувачеві через push або email

Термін дії ключа кодується в relevantDate та expirationDate в pass.json. При чек-ауті сервер позначає pass як invalidated через Pass Update URL, і ключ видаляється з пристрою.

Що входить в роботу

• Аналіз угод з Apple та виробником обладнання
• Проектування серверної інтеграції з HID/ASSA ABLOY/CCC
• Розробка мобільної частини: додавання ключа через PassKit, Express Mode
• Налаштування push-повідомлень та оновлень pass
• Тестування на фізичних замках/автомобілях
• Документація з експлуатації та підтримки

Строки орієнтовно

Базова інтеграція PKPass з Hotel Key (за наявності угод з Apple та партнером): 3–5 днів розробки мобільної частини + 1–2 тижні серверної інтеграції з HID/ASSA ABLOY API. Car Key інтеграція з UWB: окрема угода з CCC, строки від 2 місяців. Вартість розраховується індивідуально.

Бажаєте впровадити цифрові ключі? Отримайте консультацію — ми оцінимо ваш проект і допоможемо з вибором партнера. Замовте попередній аналіз безкоштовно.

Інтеграція з залізом: BLE, NFC, IoT та HomeKit у мобільних додатках

Коли задача — зв’язати смартфон з фізичним пристроєм, половина проблем знаходиться не в коді, а в прошивці заліза, характеристиках BLE-сервісів та затримках протоколу. Ми, як мобільні розробники, працюємо на стику з firmware-командою, і без розуміння стеку знизу вгору результат непередбачуваний. Ось чому ми завжди починаємо з HCI-логу та специфікації GATT — Apple Developer: Core Bluetooth Framework — це єдиний спосіб уникнути реверс-інжинірингу в польових умовах.

Чому BLE-інтеграція — найчастіша точка відмови?

Bluetooth Low Energy — основний протокол для носимих, медичних пристроїв, розумних замків та промислових датчиків. Core Bluetooth на iOS та BluetoothGatt на Android реалізують одну специфікацію, але поводяться по-різному в крайніх випадках. Статистика наших проектів: більше 70% звернень у підтримку по BLE пов’язані саме з низькорівневими помилками GATT, а не з логікою додатку.

Що робити з помилкою 133 в Android?

Помилка 133 — найчастіша в Android BLE-розробці. Це не «щось пішло не так», а конкретний індикатор переповнення черги GATT або некоректного закриття попереднього з’єднання. Ми лікуємо її двома прийомами: використовуємо чергу операцій над GATT (write, read, notification subscribe строго послідовно через операційну чергу) та завжди викликаємо disconnect() перед close(). Наша черга GATT-операцій у 3 рази знижує кількість помилок ATT_INSUFFICIENT_RESOURCES порівняно з конкурентними запитами. MTU за замовчуванням — 23 байти. Запит на збільшення (MTU exchange) обов’язковий для передачі даних об’ємом понад 20 байт. На iOS MTU запитується автоматично при підключенні, на Android потрібно явно викликати requestMtu(). Без цього ви не зможете передати, наприклад, зображення або лог через характеристику.

NFC: CoreNFC та Android NFC API

iOS підтримує NFC-читання через CoreNFC з версії iOS 11, запис — з iOS 13. Важливе обмеження: сесія сканування активна лише поки живий об’єкт NFCNDEFReaderSession і показує системний UI. Фонове сканування доступне лише для додатків з entitlement com.apple.developer.nfc.readersession.formats і лише для ISO 14443 (банківські картки, паспорти) — і цей entitlement видається не всім. На Android все простіше: NfcAdapter.enableForegroundDispatch() ловить теги у foreground без системного UI. Фоновий запуск додатку по NFC-тегу реалізується через intent-filter з ACTION_NDEF_DISCOVERED. Порівняння платформ по NFC:

HomeKit та Matter

HomeKit — екосистема Apple для розумного дому. Для інтеграції пристрій повинен мати MFi-сертифікацію (або працювати через Software Authentication для Matter). Мобільний додаток використовує HomeKit framework: HMHomeManager → HMHome → HMRoom → HMAccessory → HMService → HMCharacteristic. Matter (раніше CHIP) — крос-платформний стандарт, який підтримують Apple, Google, Amazon та Samsung. На iOS Matter-пристрої додаються через MTRDeviceController, на Android — через Google Home SDK або Matter SDK безпосередньо. Перевага Matter: один пристрій працює з HomeKit, Google Home та Alexa без перепрошивки, а конфігурація налаштовується в 4 рази швидше порівняно з власним HAP-протоколом.

Для Flutter та React Native використовуємо flutter_blue_plus та react-native-ble-plx відповідно — обидва активно підтримуються і покривають 90% сценаріїв, але для роботи з GATT-нотифікаціями у background на Android все одно потрібен foreground service. Переконайтеся, що deep linking (Universal Links на iOS, App Links на Android) налаштовані для коректного пробудження додатку при скануванні NFC-тегу або отриманні push-повідомлення від IoT-пристрою. Вимоги ATT (App Tracking Transparency) для інтеграції з залізом зазвичай не застосовуються, але якщо додаток збирає анонімну аналітику — додайте запит. Отримайте консультацію нашого інженера — він розбере вашу специфікацію за 2 дні.

Як ми інтегруємо BLE та NFC?

1. Аналітика — отримуємо від firmware-команди повну специфікацію BLE GATT (список сервісів, характеристик, формати даних) або HCI-лог. Без цього розробка перетворюється на реверс-інжиніринг через nRF Connect або Wireshark over HCI.
2. Проектування — визначаємо архітектуру підключень: чергу GATT-операцій, фонові сервіси для Android, перепідключення при втраті зв’язку. Враховуємо MTU-узгодження та обробку помилок ATT_INSUFFICIENT_RESOURCES.
3. Реалізація — кодимо на Swift/Kotlin з урахуванням особливостей платформ (Universal Links, App Links, push-повідомлення через APNs/FCM для тригерів). Для захисту Android-коду використовуємо ProGuard / R8 (shrink).
4. Тестування — на реальних пристроях з першого дня. Емулятор BLE в симуляторах не відтворює edge cases перепідключення, втрати сигналу, зміни MTU. Використовуємо автоматизацію на базі XCTest та Espresso.
5. Деплой — завантаження в App Store Connect / Google Play Console з правильним code signing та provisioning profile. Для iOS — TestFlight, для Android — Firebase App Distribution.

Що входить в роботу (deliverables)

• Вихідний код мобільного додатку з інтеграцією BLE, NFC або IoT (Swift / Kotlin / Flutter / React Native)
• Документація по протоколу GATT (карта сервісів та характеристик)
• Навантажувальне тестування на 10+ реальних пристроях (помилка 133, перепідключення, MTU-узгодження)
• Аналіз та усунення edge cases (помилка ATT_INSUFFICIENT_RESOURCES, втрата з’єднання на фоні, конфлікт з background fetch)
• Інструкція зі збірки та деплою (code signing, TestFlight, Firebase App Distribution)
• Місяць підтримки після релізу

Строки та орієнтовна вартість

Проста інтеграція з одним BLE-периферійним пристроєм (показання + команди керування) — від 2 до 4 тижнів. Типова вартість такої задачі розраховується індивідуально, включаючи налагодження GATT-профілю та обробку edge cases. Повноцінний IoT-додаток з декількома типами пристроїв, firmware OTA-оновленнями та HomeKit-підтримкою — від 2 місяців. Вартість розраховується індивідуально під ваш проект.

Ми займаємося мобільною розробкою кілька років — досвід 45+ проектів з BLE/NFC/HomeKit. Наші інженери сертифіковані Apple та Google, а кожен етап роботи фіксується в issue tracker з прив’язкою до комітів. Ми гарантуємо прозорість процесу та дотримання строків. Використовуємо підхід «інженер клієнту»: без маркетингових пауз, з прямим доступом до розробника.

Закажіть оцінку — отримайте консультацію інженера з розбором вашої специфікації. Замовте інтеграцію під ключ: ми проаналізуємо HCI-лог, перевіримо GATT-характеристики та запропонуємо архітектуру за 2 дні.