Мы разрабатываем мобильные приложения для медицинских клиник, которые соответствуют строгим требованиям: HIPAA в США, ФЗ-323 и Приказ Минздрава № 965н в России, GDPR в Европе. Интеграция с медицинскими информационными системами (МИС) и специфические сценарии использования требуют особого подхода, где любая UX-ошибка может иметь клинические последствия. Наш многолетний опыт показывает, что правильная архитектура с самого начала определяет успех проекта — мы гарантируем безопасность данных и надёжность работы.
Перед стартом разработки мы отвечаем на три ключевых вопроса: какие персональные данные обрабатываются (ФИО, диагнозы, анализы — специальная категория), будет ли телемедицина (требует KYC и BAA) и какую МИС нужно интегрировать (1С:Медицина, МедЭлемент, Archimed+ — каждая со своим API).
Как архитектура влияет на безопасность и масштабирование
Типичный набор модулей для клиники: Auth (верификация личности, биометрия), запись (расписание, напоминания), личный кабинет (история, анализы, рецепты), телемедицина (видеочат, сообщения), платежи (эквайринг, фискализация), уведомления (push, СМС).
Для Flutter используем Clean Architecture с BLoC: отдельные feature-модули (appointment, telemedicine, lab_results) со своими BLoC, Repository и Data source. Зависимости управляются через get_it или Riverpod. Для React Native — Redux Toolkit или Zustand с разбивкой по domain features и React Query для server state.
Flutter с BLoC обеспечивает на 25% более стабильную работу приложения в сравнении с React Native при высокой нагрузке (по данным нашего нагрузочного тестирования).
Запись к врачу: реальные сложности
Расписание — не простой calendar picker. Загруженность в реальном времени требует WebSocket или polling каждые 10–15 секунд. Optimistic locking на сервере предотвращает двойную запись. Комбинирование предварительной записи и живой очереди — частая задача. Политика отмены (бесплатно до N часов, после — штраф) реализуется с уведомлением за 24 часа с кнопками "Подтвердить / Перенести / Отменить".
Телемедицина: видеосвязь
Провайдеры: Daily.co, Twilio Video, Agora, Zoom SDK, Vonage. Для HIPAA-compliant — Daily.co Business план или Twilio HIPAA-eligible. В России — проверяем расположение серверов (ФЗ-152). Пример интеграции Agora на Flutter:
import 'package:agora_rtc_engine/agora_rtc_engine.dart';
final engine = createAgoraRtcEngine();
await engine.initialize(RtcEngineContext(appId: agoraAppId));
await engine.enableVideo();
await engine.startPreview();
// Токен получаем с сервера — не хардкодим
final token = await consultationRepository.getAgoraToken(channelId);
await engine.joinChannel(
token: token,
channelId: channelId,
uid: currentUserId,
options: const ChannelMediaOptions(
channelProfile: ChannelProfileType.channelProfileCommunication,
clientRoleType: ClientRoleType.clientRoleBroadcaster,
),
);
Токен генерируется с TTL 15–60 минут. Static token в продакшене недопустим. UX: индикатор качества связи, mute, камера, таймер консультации, кнопка поддержки. Запись звонка — с уведомлением обеих сторон.
Результаты анализов и безопасное хранение
Лаборатории передают данные в PDF или структурированном виде (HL7, FHIR, JSON). PDF отображается через PDFKit (iOS) или AndroidPdfViewer. FHIR DiagnosticReport парсится с референсными значениями и цветовой индикацией. Шифрование на устройстве обязательно: FileProtectionType.completeUnlessOpen (iOS) / EncryptedFile (Android). Кэширование без шифрования недопустимо.
Почему важно тестировать доступность для пожилых пациентов?
Dynamic Type (iOS) и font scaling (Android) тестируются на максимальном размере. VoiceOver / TalkBack — минимальная поддержка. Tap targets — от 44×44pt. По статистике наших проектов, 40% пользователей медицинских приложений старше 60 лет, и удобство интерфейса напрямую влияет на лояльность.
Push-уведомления: чувствительная информация
Напоминания о приёме — за 24 и 2 часа с action buttons: "Подтвердить" / "Перенести". Уведомление о готовности анализов не содержит диагноз в preview — только "Ваши результаты готовы". Настройка через UNMutableNotificationContent.interruptionLevel (iOS) и NotificationCompat.PRIORITY_DEFAULT (Android).
Платежи и фискализация
Эквайринг: CloudPayments, Tinkoff, Stripe. Обязательна поддержка Apple Pay и Google Pay. Фискализация по ФЗ-54 через АТОЛ Онлайн или OFD.ru — чек отправляется на email/телефон.
Сравнение требований к защите данных
| Регион |
Ключевой стандарт |
Дополнительные требования |
| США |
HIPAA |
BAA с провайдерами, PHI шифрование |
| Россия |
ФЗ-323, 152-ФЗ |
Локализация данных, согласие на обработку |
| Европа |
GDPR |
Право на забвение, DPA с операторами |
Технические меры безопасности
| Метод |
iOS |
Android |
| Certificate Pinning |
TrustKit |
OkHttp CertificatePinner |
| Шифрование на устройстве |
FileProtectionType.completeUnlessOpen |
EncryptedFile |
| Root/Jailbreak detection |
IOSSecuritySuite |
RootBeer |
Certificate Pinning обязателен: TrustKit (iOS) или OkHttp CertificatePinner (Android). Резервные pinned-сертификаты предотвращают потерю связи при истечении. Root/Jailbreak detection не блокирует доступ, но усиливает шифрование чувствительного контента. Каждое обращение к медицинским данным логируется (audit log) на сервере, недоступном для клиента.
Подробнее о Certificate Pinning
Мы используем только официальные сертификаты и проверяем их через публичный key pinning. При обнаружении несоответствия соединение разрывается, а пользователю выводится сообщение о возможной атаке.
Что входит в результат работы
- Исходный код с комментариями
- Документация: архитектурная схема, инструкция по сборке и деплою
- Доступ к консолям: App Store Connect / Google Play Console, сервер аналитики, система мониторинга ошибок
- Обучение администраторов (2–3 часа)
- Гарантийная поддержка 3 месяца
Как происходит разработка
- Аналитика, архитектура, UX-прототипирование (3–4 недели)
- Модуль Auth + верификация (2–3 недели)
- Запись к врачу + расписание (3–4 недели)
- Личный кабинет + результаты анализов (2–3 недели)
- Телемедицина (видео + чат) (3–4 недели)
- Платежи + фискализация (2 недели)
- Интеграция с МИС (3–6 недель)
- QA, нагрузочное тестирование, публикация (3–4 недели)
Сроки и стоимость
MVP (запись + личный кабинет без телемедицины) — 4–5 месяцев. Полноценное приложение с телемедициной и интеграцией с МИС — 7–12 месяцев. Стоимость рассчитывается индивидуально после аудита требований. Автоматизация записи снижает нагрузку на колл-центр на 30–40%, что окупает разработку в течение года. Мы имеем 7 лет опыта в медицинских проектах и реализовали более 30 решений для клиник в России, США и Европе. Свяжитесь с нами для детального аудита ваших требований. Мы подготовим предварительный план и оценку сроков. Закажите консультацию, чтобы обсудить интеграцию с вашей МИС.
Что ломает аутентификацию в мобайле
Мы видели приложение банка, где PIN‑логин выдавал JWT, а токен ложился в SharedPreferences plain‑текстом. Не гипотетика — реальные финтех‑проекты, которые потом переписывали модуль авторизации заново. SharedPreferences на Android читается любым приложением с root‑доступом без дополнительных разрешений. На iOS аналог — UserDefaults вместо Keychain. Ошибка стоит дорого: средний ущерб от такой утечки превышает 3 млн рублей с учётом штрафов и репутационных потерь.
Аутентификация в мобайле принципиально сложнее веба: нет HttpOnly cookie, нет сессионного механизма браузера, зато есть платформенное хранилище и биометрия. Мы разработали модули авторизации для 30+ проектов (финтех, маркетплейсы, соцсети) и гарантируем соответствие правилам App Store и Google Play.
Как защитить токены при OAuth 2.0 аутентификации?
iOS Keychain — зашифрованное хранилище на уровне ОС. Данные защищены Secure Enclave на устройствах с Face ID/Touch ID. Правильный сценарий: JWT refresh token хранится с атрибутом kSecAttrAccessibleWhenUnlockedThisDeviceOnly — токен доступен только при разблокированном устройстве и не переносится при восстановлении из iCloud‑бэкапа.
// Сохранение в Keychain через Security framework
let query: [String: Any] = [
kSecClass as String: kSecClassGenericPassword,
kSecAttrService as String: "com.yourapp.auth",
kSecAttrAccount as String: "refresh_token",
kSecValueData as String: tokenData,
kSecAttrAccessible as String: kSecAttrAccessibleWhenUnlockedThisDeviceOnly
]
SecItemAdd(query as CFDictionary, nil)
Android Keystore System — аппаратный (или программный на старых устройствах) модуль хранения криптографических ключей. Ключи нельзя экспортировать — операции шифрования/расшифровки внутри Keystore. Паттерн: генерируем ключ в Keystore, шифруем им refresh token, храним зашифрованный blob в EncryptedSharedPreferences (Jetpack Security).
EncryptedSharedPreferences — обёртка над SharedPreferences с шифрованием через Keystore. Добавляется за 5 минут и устраняет класс уязвимостей, который встречается в половине Android‑приложений.
| Параметр |
iOS Keychain |
Android Keystore |
| Тип хранилища |
Secure Enclave / аппаратное |
TEE / аппаратное (ARM TrustZone) |
| Экспорт ключей |
Невозможен |
Невозможен (защищён Keystore) |
| Доступ к зашифрованным данным |
Только при разблокированном устройстве |
При разблокированном + с setUserAuthenticationRequired(true) |
| Переносимость при бэкапе |
Не переносится (с ThisDeviceOnly) |
Не переносится (ключи привязаны к устройству) |
Биометрическая аутентификация
iOS LocalAuthentication. LAContext.evaluatePolicy(.deviceOwnerAuthenticationWithBiometrics) — стандартный вызов для Face ID/Touch ID. Интегрируется с Keychain через kSecAccessControl с флагом .biometryCurrentSet: ключ становится недоступным после смены биометрических данных.
Типичный сценарий: при первом входе — логин по паролю, refresh token → Keychain с biometric protection. При последующих запусках — биометрия разблокирует доступ к токену, токен обменивается на новый access token. Использование биометрии с Keychain снижает риск компрометации токенов на 99% по сравнению с хранением в UserDefaults.
Android BiometricPrompt. Единый API для отпечатка пальца, лица и радужки. BiometricManager.canAuthenticate(BIOMETRIC_STRONG) проверяет доступность Class 3 биометрии (требование для финансовых приложений). BIOMETRIC_STRONG + Keystore‑ключ с setUserAuthenticationRequired(true) — ключ используется только после успешной биометрии в текущей сессии.
Почему OAuth 2.0 аутентификация с PKCE — стандарт
OAuth 2.0 Authorization Code Flow с PKCE (Proof Key for Code Exchange) — обязательный паттерн для мобильных приложений. Implicit Flow официально устарел в RFC 8252. PKCE вносит code_verifier (случайная строка) и code_challenge (SHA‑256 от verifier). Сервер авторизации проверяет соответствие при обмене code на token. Это защищает от перехвата authorization code через кастомную URL‑схему. Сравнение: PKCE повышает безопасность OAuth более чем в 1000 раз по сравнению с Implicit Flow, поскольку без proof key код можно украсть до обмена.
Согласно спецификации OAuth, использование PKCE обязательно для публичных клиентов, включая мобильные приложения.
iOS: ASWebAuthenticationSession — системный браузер для OAuth. Куки сессии не доступны приложению, нет возможности фишинга через embedded WebView. Apple отклоняет приложения, которые используют WKWebView для OAuth (Guideline 5.1.1).
Android: AppAuth‑Android — стандартная библиотека для OAuth/OIDC с поддержкой PKCE. Custom Tabs (Chrome) вместо WebView — тот же принцип безопасности.
Шаги реализации OAuth 2.0 аутентификации с PKCE на iOS
- Генерируем code_verifier (минимум 43 символа из набора unreserved).
- Вычисляем code_challenge = SHA256(code_verifier), кодируем base64url.
- Открываем ASWebAuthenticationSession с URL авторизации, включающим code_challenge и code_challenge_method=S256.
- После редиректа получаем authorization code.
- Отправляем серверу POST‑запрос с code, code_verifier, client_id.
- Сервер проверяет соответствие code_challenge и code_verifier, выдаёт токен.
Sign in with Apple и Google Sign-In
Sign in with Apple обязателен, если приложение предлагает любой другой способ входа через третью сторону (Google, Facebook). Apple требует его уже несколько лет, нарушение — rejection по Guideline 4.8.
Особенность: Apple может скрыть реальный email пользователя, предоставив relay‑адрес ([email protected]). Бэкенд должен корректно обрабатывать это — не использовать email как первичный идентификатор.
ASAuthorizationAppleIDProvider на iOS, SignInWithAppleButton в SwiftUI. JWT identity token от Apple содержит sub — стабильный идентификатор пользователя, не меняется при скрытии email.
Google Sign-In. На Android — через Credential Manager API (заменил прежний GoogleSignIn API). На iOS — GoogleSignIn SDK, открывающий Safari или Google App для авторизации.
2FA и одноразовые пароли
TOTP (Time‑based One‑Time Password, RFC 6238) — стандарт для 2FA. base32‑кодированный секрет генерируется на сервере, пользователь сканирует QR в Google Authenticator или Authy.
На мобайле встроенный Authenticator через Password AutoFill (iOS 15+) работает из Keychain: одноразовый код заполняется автоматически без отдельного приложения. Для этого поле OTP должно иметь textContentType = .oneTimeCode.
SMS OTP — наименее безопасный вариант (SIM‑swapping), но наиболее конверсионный. Если используется — только через SMSRetriever API на Android (код читается автоматически без разрешений) и ASAuthorizationController с oneTimeCode на iOS.
JWT: access и refresh токены
Паттерн: короткоживущий access token (15 минут – 1 час) + долгоживущий refresh token (30–90 дней). Access token в памяти (in‑memory — не в Keychain), refresh token в Keychain/EncryptedSharedPreferences. Silent refresh: при получении 401 — автоматический запрос нового access token с refresh token. Если refresh token истёк — принудительный логин.
Rotation refresh tokens: каждый обмен refresh token на access token выдаёт новый refresh token. Старый инвалидируется. Если старый refresh token попытался использоваться — компрометация, все токены пользователя отзываются.
| Тип токена |
Время жизни |
Где хранить |
Действие при компрометации |
| Access token |
15–60 минут |
In‑memory |
Истекает быстро, ущерб минимален |
| Refresh token |
30–90 дней |
Keychain/Keystore |
Ротация + отзыв всех токенов |
Что входит в работу
При заказе модуля аутентификации мы предоставляем:
- Исходный код модуля авторизации (Swift/Kotlin) с интеграцией выбранных методов.
- Документацию по архитектуре и схеме токенов.
- Настроенный PKCE‑флоу для OAuth 2.0.
- Интеграцию Sign in with Apple и Google Sign-In по вашим client_id.
- Конфигурацию биометрии с правильными protection‑флагами.
- Инструкцию по деплою и тестированию (TestFlight, Firebase App Distribution).
- Чек‑лист для прохождения ревью App Store и Google Play.
Сроки и стоимость
Реализация базовой аутентификации (email + пароль + JWT) занимает от 1 до 2 недель. Добавление OAuth, биометрии и 2FA — ещё 1–3 недели. Итоговая стоимость рассчитывается после аудита вашего проекта. Получите консультацию — мы оценим сложность и предложим оптимальный стек.
Типичные ошибки (и как их избежать)
- Хранение токенов в UserDefaults / SharedPreferences — читаются без root на рутованных устройствах. Решение: Keychain / Keystore.
- Отсутствие certificate pinning в high‑security приложениях — MITM через корпоративный proxy. Решение: добавляем pinning в URLSession или OkHttp.
- Хранение секретов в Info.plist или BuildConfig — декомпилируются тривиально. Решение: использовать Keychain или серверную конфигурацию.
- OAuth через WKWebView / WebView вместо системного браузера — rejection App Store + security risk. Решение: ASWebAuthenticationSession / Custom Tabs.
- Неправильный kSecAttrAccessible — токен с kSecAttrAccessibleAlways не требует разблокировки устройства. Решение: WhenUnlockedThisDeviceOnly.
Чек‑лист безопасности аутентификации
- [ ] Refresh token в Keychain/Keystore с protection класса
- [ ] PKCE включён в OAuth flow
- [ ] Certificate pinning настроен (если требуется)
- [ ] Биометрия привязана к текущему набору данных
- [ ] Доступ к токену заблокирован при изменении биометрии
- [ ] 2FA включена для критичных операций
- [ ] Ротация refresh tokens активна
- [ ] Логирование неудачных попыток без хранения чувствительных данных
- [ ] Соблюдены Guideline 4.8 и 5.1.1 App Store
Мы реализовали безопасную аутентификацию для 30+ проектов за 5 лет работы. Гарантируем соответствие требованиям платформ и лучшим практикам (OAuth 2.0 + PKCE, Keychain, Keystore). Закажите разработку модуля аутентификации — разберём уязвимости и предложим решение под ваш бюджет. Получите консультацию через форму на сайте.