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

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

Финтех, юридические сервисы и HR-платформы требуют юридически значимой подписи документов. Мы внедряем НЭП и КЭП под ключ: от генерации ключей в Secure Enclave до серверной верификации и timestamp. Наш опыт — 5+ лет и 10+ проектов для iOS и Android.

Электронная подпись — криптографическая операция. Документ подписывается приватным ключом пользователя. Верификатор проверяет подпись публичным ключом. Различают 3 вида: КЭП (с сертификатом от аккредитованного УЦ), НЭП (своя PKI) и ПЭП. Для большинства коммерческих кейсов достаточно НЭП — стоимость реализации от 25 000 ₽. КЭП нужна для госуслуг. Интеграция с КЭП-провайдером обходится от 80 000 ₽.

Как мы генерируем ключи на мобильном устройстве

Приватный ключ генерируется на устройстве. Он хранится в Keychain (iOS) или Android Keystore. Публичный ключ регистрируется на сервере. Приватный ключ никогда не покидает Secure Enclave или TEE. Это полностью исключает перехват ключа через сеть или файловую систему.

Генерация ключевой пары на Android:

val keyPairGenerator = KeyPairGenerator.getInstance(
    KeyProperties.KEY_ALGORITHM_EC, "AndroidKeyStore"
)
keyPairGenerator.initialize(
    KeyPairGeneratorSpec.Builder(context)
        .setAlias("user_signing_key")
        .setKeyType("EC")
        .setKeySize(256)
        .setSubject(X500Principal("CN=User"))
        .setSerialNumber(BigInteger.ONE)
        .setStartDate(startDate)
        .setEndDate(endDate)
        .build()
)
val keyPair = keyPairGenerator.generateKeyPair()
val publicKeyBase64 = Base64.encode(keyPair.public.encoded)

iOS, Swift:

let attributes: [String: Any] = [
    kSecAttrKeyType as String: kSecAttrKeyTypeECSECPrimeRandom,
    kSecAttrKeySizeInBits as String: 256,
    kSecAttrTokenID as String: kSecAttrTokenIDSecureEnclave,
    kSecPrivateKeyAttrs as String: [
        kSecAttrIsPermanent as String: true,
        kSecAttrApplicationTag as String: "com.example.signing".data(using: .utf8)!
    ]
]
var error: Unmanaged<CFError>?
guard let privateKey = SecKeyCreateRandomKey(attributes as CFDictionary, &error) else {
    // обработать ошибку
}
let publicKey = SecKeyCopyPublicKey(privateKey)!

Почему биометрическая аутентификация обязательна?

Для юридически значимых операций ключ должен быть защищён подтверждением личности. Ключ доступен только после успешной биометрической аутентификации. Face ID обрабатывает запрос за 0,5 секунды. На Android биометрия Class 3 в 1000 раз надёжнее PIN-кода по стандарту FIDO Alliance. Наши проекты проходят аудит OWASP MASVS с результатом 95%+.

keyGenParameterSpec = KeyGenParameterSpec.Builder(...)
    .setUserAuthenticationRequired(true)
    .setUserAuthenticationParameters(0, KeyProperties.AUTH_BIOMETRIC_STRONG)
    .build()

При каждом подписании создаётся CryptoObject с объектом Signature. В callback onAuthenticationSucceeded получаем разблокированную подпись.

Форматы подписи и верификация на сервере

Для стандартизации используем CMS (RFC 5652) или JWS (RFC 7515). JWS удобнее для REST API. На сервере верификация через PyJWT, jose или nimbus-jose-jwt.

RFC 5652 — Cryptographic Message Syntax (CMS)

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

Этапы нашей работы по внедрению ЭП:

1. Проектирование схемы ключей и выбор формата подписи (CMS или JWS) — 1 день.
2. Генерация ключевой пары, настройка Secure Enclave или Android Keystore — 1 день.
3. Интеграция биометрической аутентификации и реализация UI подписания — 1 день.
4. Серверная верификация подписей с поддержкой timestamp RFC 3161 — 1 день.
5. Тестирование безопасности, документация и обучение команды — 1 день.

Итого — 3–5 рабочих дней. Стоимость базовой НЭП от 25 000 ₽.

Долгосрочная валидность и timestamp

Если документ должен оставаться валидным после истечения сертификата, применяем RFC 3161 Trusted Timestamping. TSA подписывает хэш документа и фиксирует время. Даже при компрометации ключа timestamp доказывает момент создания подписи. Публичные TSA: Freetsa.org, DigiCert. Интеграция через bouncycastle на Android и Security.framework на iOS. Рекомендуем формат CAdES-LT — он включает встроенный сертификат TSA и упрощает верификацию через 10–20 лет. Срок хранения юридически значимых документов с корректным timestamp — от 5 до 25 лет.

Варианты интеграции с внешними КЭП-провайдерами

Для квалифицированной подписи в России: КриптоПро, Рутокен, ViPNet. У каждого есть мобильные SDK. Интеграция через CryptoPro CSP SDK — подписание на стороне токена. Для международных кейсов применяем DocuSign SDK, Adobe Sign API, HelloSign. Для проектов в Беларуси подходят AvSoft и Авест. Наша команда знает особенности каждого провайдера — это экономит 2–3 недели на изучение документации.

НЭП: 3–5 дней, от 25 000 ₽. КЭП с внешним провайдером — индивидуальная оценка после анализа требований и API. Оценим ваш проект бесплатно — свяжитесь с нами и получите предварительный план за 1 день.

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