Разработка мобильного приложения для электронной подписи документов

Разработка мобильного приложения для электронной подписи документов

Мы берёмся за задачу, которая на первый взгляд кажется простой: пользователь открывает 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-токен для юридически значимых операций.

Формат подписи: PAdES, XAdES, CAdES

PDF-документы подписываются в формате PAdES (PDF Advanced Electronic Signatures, ETSI EN 319 132). Реализация на мобильном клиенте согласно ETSI EN 319 132:

1. Вычислить SHA-256 от диапазона байт PDF, исключая зарезервированное место для подписи (ByteRange).
2. Сформировать CMS SignedData структуру с атрибутами signingCertificate, signingTime, ESSCertIDv2.
3. Опционально — получить временну́ю метку от TSA (RFC 3161): отправить хэш подписи, получить TSTInfo, встроить в unauthenticatedAttributes.
4. Записать 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 недоступен, решаем на уровне политики — либо отклоняем, либо допускаем с пометкой «не проверено».

Что входит в работу

Мы выполняем проект под ключ: от аудита требований до публикации в 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 месяцев. Стоимость рассчитывается индивидуально после анализа требований к типу подписи и регуляторной среде. Свяжитесь с нами для оценки вашего проекта — получите консультацию по архитектуре и рекомендации по выбору УЦ.

Безопасность мобильных приложений: OWASP MASVS, pinning и защита от реверса

Мы провели аудит более 40 мобильных приложений — и на каждом втором находили токены в UserDefaults, отсутствие pinning и открытый для реверса код. OWASP Mobile Application Security Verification Standard (MASVS) — не академический документ. Это чек-лист пентестера. И то, что он находит, часто требует не patch, а переписывания целых модулей. Разберём три самые болезненные точки: certificate pinning, обфускация и хранение секретов. И покажем, как их закрыть без даунтаймов на продакшне.

Почему certificate pinning ломает продакшн?

Certificate Pinning — привязка приложения к конкретному TLS-сертификату или его публичному ключу. Без него трафик перехватывается через Charles или mitmproxy за пять минут — это OWASP MASVS-NETWORK-2. Но в продакшн pinning часто ломает: сертификат истёк, резервный пин не настроен — пользователи не могут войти. Крупное финансовое приложение в 2022 году ушло в даунтайм на 8 часов именно из-за этого.

На iOS реализуется через URLSessionDelegate.urlSession(_:didReceive:completionHandler:) с проверкой SecTrust. Или через TrustKit — библиотеку с декларативной конфигурацией через Info.plist. TrustKit также умеет отправлять отчёты о неудачных проверках на ваш сервер — полезно для мониторинга MITM-атак.

На Android — network_security_config.xml:

<network-security-config>
  <domain-config>
    <domain includeSubdomains="true">api.example.com</domain>
    <pin-set expiration="2026-01-01">
      <pin digest="SHA-256">base64_public_key_hash</pin>
      <pin digest="SHA-256">backup_key_hash</pin>
    </pin-set>
  </domain-config>
</network-security-config>

Критическое правило: всегда два пина — основной и резервный. Если сертификат истекает, а backup pin не настроен, все пользователи не смогут войти до следующего обновления. Именно так ломаются production-сборки.

Ещё одна точка отказа: CDN и third-party SDK. Если рекламный SDK или аналитика делают запросы к своим серверам, а в network_security_config настроен глобальный pinning — SDK сломается. Конфигурация должна быть поддоменно-специфичной.

Как защитить данные в Keychain и Keystore?

MASVS-STORAGE-1 и STORAGE-2 — самые часто нарушаемые требования. Частая ошибка на iOS: токены авторизации хранятся в UserDefaults. Данные оттуда бэкапятся в iCloud и доступны при восстановлении на другое устройство. Токен на новом iPhone — это чужая авторизованная сессия. Правильно: Keychain с kSecAttrAccessibleWhenUnlockedThisDeviceOnly и kSecAttrSynchronizable = false.

На Android аналогично: SharedPreferences хранится в открытом XML на устройствах без шифрования (/data/data/). Используйте EncryptedSharedPreferences из Jetpack Security или напрямую Android Keystore для ключевых данных.
Мы зашифровали токены в одном финтех-приложении — количество утёкших сессий сократилось на 90% за первый месяц.

Обфускация и защита кода

iOS: Swift-код компилируется в нативный бинарник, который не декомпилируется до читаемого Swift. Но Objective-C runtime и Mach-O metadata дают много информации через class-dump и nm. Имена классов, методов, строки в бинарнике — всё видно. Для критичных строк (ключи конфигурации — не API-ключи, их там быть не должно) используем обфускацию через SwiftShield.

Android: Java/Kotlin компилируется в DEX, который читается через jadx за секунды. R8 (включён по умолчанию в release сборках) минифицирует и обфусцирует. Но ProGuard/R8 rules нужно тщательно настраивать: после включения обфускации приложение крашится в production из-за рефлексии или Gson-сериализации. Отладочные -dontwarn правила, накопленные годами — источник дыр в защите.

Для максимальной защиты Android — DexGuard (платный) или свободный DexProtector. Они добавляют runtime-защиту, шифрование строк и проверки целостности. Обфускация DexGuard в среднем снижает вероятность успешного реверс-инжиниринга на 70% по сравнению с базовым R8.

Обнаружение jailbreak и root

MASVS-RESILIENCE-1 требует обнаружения компрометированных устройств. Стандартные проверки: наличие /Applications/Cydia.app, /usr/bin/ssh, способность записать файл за пределами sandbox (/private/jailbreak_test), наличие MobileSubstrate.

Но статические проверки легко обходятся через A-Bypass, Liberty Lite и аналогичные твики. Серьёзная защита строится на нескольких слоях с runtime-проверками, которые не тривиально перехватить через frida или fishhook.

Готовые решения: IOSSecuritySuite (iOS, open source), rootbeer (Android). Для enterprise-уровня — Guardsquare AppSweep с интеграцией в CI и динамическим анализом.

Что входит в работу по безопасности мобильного приложения

Как мы реализуем защиту: кейс

Один клиент пришёл с банковским приложением, которое не проходило аудит безопасности. Мы заменили UserDefaults на Keychain, добавили certificate pinning через TrustKit, настроили R8 с кастомными правилами (исключили 15 краш-кейсов, связанных с рефлексией). Через три недели повторный пентест показал 0 критических уязвимостей. С момента внедрения — ни одного инцидента за два года.

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

• Security-аудит по OWASP MASVS уровня L1 — от 1 до 2 недель.
• Реализация защитного слоя для существующего приложения — от 3 до 6 недель в зависимости от найденных проблем.
• Полный цикл «аудит + внедрение + тест» — от 4 до 8 недель.

Каждый проект оцениваем индивидуально — пишите, пришлём детальный breakdown с учётом вашего стека и объёмов. Работаем под ключ: от анализа до деплоя в сторах.

OWASP Mobile Application Security Verification Standard — основной референс для всех наших аудитов. Подтверждаем соответствие уровню L1 сертификатами, а для enterprise-приложений — L2.

Оценим ваш проект за один рабочий день после получения APK/IPA. Свяжитесь — расскажем, какие дыры закроем в первую очередь.