Интеграция Apple Wallet для пропусков и бейджей в мобильном приложении

Интеграция Apple Wallet для пропусков и бейджей в мобильном приложении

Пропуск сотрудника, который не обновляется при смене отдела — это головная боль службы безопасности и самого сотрудника. Мы снимаем эту проблему с помощью Apple Wallet: пропуск всегда актуален, отзывается мгновенно, а процесс выдачи полностью автоматизирован. За 5 лет работы мы реализовали такие решения для компаний с парком от 200 до 5000 сотрудников — гарантируем стабильную работу даже при высокой нагрузке.

Почему стоит интегрировать Apple Wallet для пропусков?

Apple Wallet превращает смартфон в универсальный идентификатор. Сотруднику не нужна пластиковая карта — достаточно iOS-устройства. Пропуск в Wallet работает офлайн, поддерживает push-обновления и может содержать фото, отдел, зоны доступа и даже роль на конференции. Для бизнеса это снижает затраты на выпуск и замену карт на 30-40%, а для сотрудников — упрощает повседневное использование.

Как устроен pass.json для корпоративного пропуска?

Пропуск сотрудника — это generic-тип .pkpass. Generic — самый гибкий тип: нет строгих ограничений на семантику полей, структура определяется задачей. Для корпоративных пропусков часто добавляют фото сотрудника через thumbnail.png (90×90 @1x, 180×180 @2x) — оно отображается в правом углу карточки.

{ "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": "31.12.2024" } ], "barcode": { "message": "BADGE-EMP-1042", "format": "PKBarcodeFormatQR", "messageEncoding": "iso-8859-1" } } } 

thumbnail.png добавляется просто как файл в архив — PassKit подхватывает его автоматически по имени.

NFC или QR: что выбрать для контроля доступа?

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-сканер. Работает надёжно, требует лишь камеру на входе.

Как управлять жизненным циклом пропуска?

Пропуск сотрудника имеет чёткий цикл: выдача → работа → отзыв (увольнение, смена должности). Отзыв реализуется двумя способами:

• Через expirationDate — пасс автоматически становится недействительным. Подходит для временных пропусков (конференция, подрядчик).
• Через voided: true с push-обновлением — для немедленного отзыва. Сервер получает событие (HR-система, увольнение) → отправляет APN push → устройство скачивает обновлённый пасс с voided: true → Wallet отображает пропуск как недействительный.

Сервер при скачивании обновлённого пасса должен вернуть HTTP 200 с новым .pkpass. Если вернуть HTTP 304 — устройство ничего не обновит.

Временные пропуска для мероприятий

Бейдж участника конференции — та же логика, но 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://api.yourcompany.com/badges/{token}.pkpass — iOS открывает через Safari и предлагает «Добавить в Wallet». MIME-тип ответа должен быть application/vnd.apple.pkpass.

При смене должности — не отзыв пасса, а его обновление: PATCH-запрос на web-сервис URL обновляет поля department и role. Wallet подтягивает изменения автоматически.

Что входит в работу по интеграции?

• Аудит текущей инфраструктуры и HR-системы
• Проектирование структуры pass.json под ваши поля
• Генерация сертификатов и provisioning profile в Apple Developer
• Настройка push-уведомлений (APNs) для обновления/отзыва
• Интеграция с HR-системой через webhook или REST API
• Тестирование на реальных устройствах (iOS 15+)
• Документация и обучение администраторов

Сроки и стоимость

Оценка проекта занимает от 2 часов до 1 дня в зависимости от сложности. Базовая интеграция (генерация пропусков + push-обновления) — от 5 до 10 рабочих дней. Для проектов с NFC и кастомной HR-интеграцией срок увеличивается до 20 дней. Стоимость рассчитывается индивидуально, но вы можете запросить предварительную оценку — свяжитесь с нами, мы подготовим коммерческое предложение.

Гарантия: мы даём 12 месяцев технической поддержки после внедрения. За 5+ лет мы не потеряли ни одного клиента — все проекты работают стабильно.