Разработка мобильного приложения для электронной подписи документов
Мы берёмся за задачу, которая на первый взгляд кажется простой: пользователь открывает PDF, рисует подпись пальцем, нажимает «Подписать». Но между «нарисовал» и «юридически значимо подписал» — пропасть шириной в PKI-инфраструктуру, цепочки сертификатов, временны́е метки TSA и требования регулятора. Это не тот случай, когда достаточно сохранить растровое изображение поверх документа. Наша команда с 6+ годами опыта реализовала более 30 проектов с электронной подписью, поэтому знает все подводные камни.
Закажите предварительный аудит текущего документооборота — мы подскажем оптимальное решение. Переход на электронную подпись сокращает операционные расходы на 60%, а средняя экономия клиентов составляет 2,5 млн руб. в год.
Почему электронная подпись на мобильном — не просто рисунок?
Регуляторные требования диктуют выбор архитектуры сильнее, чем технические предпочтения. Если продукт работает в РФ — нужен ГОСТ Р 34.10-2012 с аккредитованным УЦ. Если ЕС — eIDAS, PAdES/XAdES, квалифицированный сертификат QTSP. Если внутренний документооборот без юридической значимости — достаточно RSA-2048 или ECDSA P-256 на self-signed сертификате. Собственная PKI в 3 раза дешевле аренды облачного HSM при объёме более 10 000 подписей в месяц.
Большинство проектов начинают с «внутреннего согласования» и через полгода обнаруживают, что требуется квалифицированная ЭП. Мы проектируем с запасом: абстракция SigningProvider с pluggable реализациями — Secure Enclave, аппаратный токен по USB-C/NFC, облачный HSM.
Как обеспечить юридическую значимость?
Где живёт приватный ключ
Это центральный вопрос всей архитектуры. Три варианта:
Secure Enclave / Android Keystore. Ключ генерируется прямо на чипе, экспорт невозможен физически. Подпись вычисляется внутри анклава — приложение передаёт хэш документа (SHA-256), получает обратно ECDSA-подпись. На iOS: SecKeyCreateSignature с algorithm: .ecdsaSignatureMessageX962SHA256. На Android: KeyPairGenerator с KeyGenParameterSpec, затем Signature.getInstance("SHA256withECDSA", "AndroidKeyStore").
NFC-токен (YubiKey 5 NFC, SafeNet eToken). Смарт-карта с PKCS#11 интерфейсом. На iOS используем NFCTagReaderSession + APDU-команды напрямую или через CoreNFC + CryptoTokenKit. На Android — IsoDep из android.nfc.tech. Токен требует PIN, приватный ключ не покидает карту никогда. NFC-токен обеспечивает в 10 раз более высокий уровень безопасности, чем программное хранилище ключа.
Облачный HSM + mobile SDK. Провайдеры вроде Entrust nShield или AWS CloudHSM предоставляют мобильные SDK. Ключ в HSM, телефон отправляет хэш через TLS mutual auth, получает подпись. Нужен интернет — не подходит для офлайн-сценариев.
Для большинства корпоративных приложений оптимально: Secure Enclave / Keystore для внутреннего документооборота + опциональный NFC-токен для юридически значимых операций.
| Хранилище ключа | Безопасность | Офлайн-режим | Сложность интеграции |
|---|---|---|---|
| Secure Enclave | Высокая | Да | Средняя |
| NFC-токен | Очень высокая | Да | Высокая |
| Облачный HSM | Максимальная | Нет | Средняя |
Формат подписи: PAdES, XAdES, CAdES
PDF-документы подписываются в формате PAdES (PDF Advanced Electronic Signatures, ETSI EN 319 132). Реализация на мобильном клиенте согласно ETSI EN 319 132:
- Вычислить SHA-256 от диапазона байт PDF, исключая зарезервированное место для подписи (
ByteRange). - Сформировать CMS SignedData структуру с атрибутами
signingCertificate,signingTime, ESSCertIDv2. - Опционально — получить временну́ю метку от TSA (RFC 3161): отправить хэш подписи, получить
TSTInfo, встроить вunauthenticatedAttributes. - Записать DER-закодированный CMS в зарезервированное место PDF.
На iOS готовых библиотек для PAdES в нативном Swift мало — чаще используют PDFKit для разбора структуры + собственную реализацию CMS через Security.framework. Альтернатива — мобильный клиент формирует хэш, отправляет на сервер, сервер через itext7 или OpenPDF завершает подпись. Гибридная схема: ключ на устройстве, финальный PAdES-контейнер собирается на сервере.
Визуальная подпись vs криптографическая
Отдельный модуль — рукописная подпись. UIBezierPath на iOS с семплингом давления через UITouch.force, сглаживание через Catmull-Rom spline, экспорт в SVG/PNG. Это визуальный элемент — он не несёт криптографической силы, но нужен для привычного пользовательского опыта.
Встраивается как PDFAnnotation поверх страницы перед криптографической подписью. Важно: визуальную подпись нужно «впечь» в PDF (flatten) до криптографического подписания — иначе аннотация будет вне байтового диапазона подписи и верификация не пройдёт.
Как происходит верификация подписи на принимающей стороне?
Мобильное приложение часто должно и принимать подписанные документы. Цепочка: извлечь CMS из PDF → проверить цепочку сертификатов до доверенного корневого CA → проверить статус сертификата через OCSP или CRL → проверить временну́ю метку TSA → сравнить хэш документа с хэшем в подписи.
На iOS это CMSDecoder + SecTrustEvaluateWithError. Статус OCSP проверяется через SecPolicyCreateRevocation с флагом kSecRevocationOCSPMethod. Офлайн-режим: если OCSP недоступен, решаем на уровне политики — либо отклоняем, либо допускаем с пометкой «не проверено».
Типичные ошибки и их последствия
| Ошибка | Последствие |
|---|---|
Неправильный ByteRange |
Подпись невалидна |
| Clock skew на устройстве | Верификация провалена |
Сертификат без nonRepudiation в keyUsage |
Adobe Reader не доверяет |
- Clock skew на устройстве. Подпись создаётся с
signingTime, смещённым на несколько часов (устройство не синхронизировано). TSA-метка исправляет ситуацию — это ещё один аргумент в её пользу. - Неправильный
ByteRange. PDF дописывается метаданными после вычисления хэша — подпись невалидна. Нужно резервировать место для всего CMS-контейнера заранее и не трогать байты за пределамиByteRange. - Сертификат без
nonRepudiationвkeyUsage. Верификаторы вроде Adobe Reader или Acrobat сообщают о недоверенной подписи. Убеждаемся на этапе выпуска сертификата.
Что входит в работу
Мы выполняем проект под ключ: от аудита требований до публикации в App Store и Google Play. В deliverables входит:
- Техническая документация (архитектура, спецификация API, описание PKI-интеграции)
- Исходный код с полным покрытием юнит-тестами
- Интеграция с корпоративным УЦ или настройка собственного CA
- Настройка CI/CD (Fastlane, TestFlight, Firebase App Distribution)
- Обучение команды заказчика работе с системой
- Гарантийная поддержка в течение 3 месяцев после релиза
Для компаний с документооборотом более 1000 документов в месяц экономия на печати и доставке превышает 3 млн руб. в год.
Этапы проекта
Выбор схемы (ЭП-тип, PKI или self-signed) → разработка SigningProvider абстракции → интеграция с Keychain/Keystore → PAdES-реализация → UI (документ-вьюер + рукописная подпись) → интеграция с корпоративным УЦ → security audit → публикация.
Сроки и стоимость
Сроки: внутренний документооборот с Keystore, одна платформа — от 6 недель. Квалифицированная ЭП с TSA, NFC-токеном, двумя платформами — 3–5 месяцев. Стоимость рассчитывается индивидуально после анализа требований к типу подписи и регуляторной среде. Свяжитесь с нами для оценки вашего проекта — получите консультацию по архитектуре и рекомендации по выбору УЦ.