Паролі — найслабша ланка більшості мобільних продуктів: користувачі їх забувають, повторно використовують і вводять на фішингових сторінках, а команда витрачає ресурси на відновлення доступу, SMS-коди і підтримку. Passkeys пропонують інший підхід: замість секрету, який знає людина, — пара криптографічних ключів, де приватний ключ ніколи не залишає менеджера паролів користувача, а вхід підтверджується Face ID, відбитком пальця чи PIN-кодом пристрою.

Технологія вже підтримується iOS, Android і всіма основними браузерами, а Apple і Google вбудували її в системні менеджери паролів. У статті — як passkeys влаштовані, що потрібно від бекенду і мобільного клієнта, як побудувати UX міграції з паролів і на яких деталях команди найчастіше спотикаються.

Як працюють passkeys

Passkey — це облікові дані FIDO2, побудовані на стандарті W3C WebAuthn і специфікаціях FIDO Alliance. Під час реєстрації пристрій генерує пару ключів для конкретного домену (relying party ID). Публічний ключ зберігається на вашому сервері, приватний — у менеджері облікових даних: iCloud Keychain, Google Password Manager або сторонньому, наприклад 1Password.

Під час входу сервер надсилає випадковий challenge, пристрій підписує його приватним ключем після біометричної перевірки, а сервер перевіряє підпис публічним ключем. Важливі наслідки:

  • Стійкість до фішингу. Ключ прив'язаний до домену: passkey для example.com неможливо використати на example-login.com.
  • Нічого красти на сервері. Витік бази публічних ключів не дає змоги увійти.
  • Синхронізація. Passkeys синхронізуються між пристроями однієї екосистеми, а на чужому пристрої можна увійти через QR-код і телефон поруч (cross-device, або hybrid-транспорт).

Паролі, SMS і passkeys: порівняння

КритерійПарольSMS / e-mail кодPasskey
Стійкість до фішингуНизькаНизька (код можна ввести на фальшивій сторінці)Висока, прив'язка до домену
Тертя для користувачаЗапам'ятати і ввестиДочекатися і скопіювати кодОдин біометричний жест
Вартість для бізнесуВідновлення доступу, підтримкаОплата кожного SMS, ризик SMS pumpingІнтеграція один раз
Наслідки витоку базиКритичні при слабкому хешуванні—Публічні ключі не дають доступу
Залежність від пристроюНемаєНомер телефону, SIMМенеджер облікових даних, синхронізація

NIST SP 800-63B допускає синхронізовані автентифікатори (syncable authenticators) і визнає криптографічну автентифікацію з прив'язкою до домену, як у WebAuthn, стійкою до фішингу, тоді як використання телефонної мережі для SMS-кодів позначає як обмежене (restricted). Для продуктів із чутливими даними це аргумент не лише UX, а й комплаєнсу.

Що потрібно на бекенді

Бекенд — це relying party server. Писати криптографію з нуля не потрібно: використовуйте перевірені бібліотеки (SimpleWebAuthn для Node.js, java-webauthn-server від Yubico, py_webauthn, webauthn-rs, бібліотеки для PHP і Go). Перелік є на passkeys.dev.

  1. Ендпоінти реєстрації: видати параметри створення (challenge, rp.id, user.id, excludeCredentials) і перевірити відповідь.
  2. Ендпоінти входу: видати challenge і перевірити підпис.
  3. Таблиця облікових даних: credential ID, публічний ключ, лічильник підписів, AAGUID (модель автентифікатора), дати створення та останнього використання. Один користувач може мати кілька passkeys.
  4. Challenge — криптографічно випадковий, одноразовий, з коротким часом життя (зазвичай кілька хвилин).
  5. user.id — випадкове значення без персональних даних; Google рекомендує, наприклад, 16 випадкових байтів, а не e-mail.
  6. Перевірка origin: для вебу — домен, для Android — android:apk-key-hash: з SHA-256 відбитком сертифіката підпису (документація Android). Не забудьте додати і debug, і release відбитки.

iOS: AuthenticationServices і Associated Domains

Passkeys доступні з iOS 16 через фреймворк AuthenticationServices (Apple: Supporting passkeys).

  • Додайте capability Associated Domains із записом webcredentials:example.com.
  • Розмістіть файл apple-app-site-association за адресою https://example.com/.well-known/apple-app-site-association з вашим App ID у розділі webcredentials (Supporting associated domains). Файл має віддаватися по HTTPS без редиректів.
  • Для реєстрації використовуйте ASAuthorizationPlatformPublicKeyCredentialProvider і запит на створення; для входу — запит на підтвердження з challenge від сервера.
  • Для автозаповнення в полі логіна (AutoFill-assisted request) позначте поле як username, і система запропонує passkey прямо в QuickType-панелі.
  • Починаючи з iOS 18 доступне автоматичне оновлення до passkey: після успішного входу паролем застосунок може запросити створення passkey в умовному режимі без додаткового діалогу.

На Android рекомендований інструмент — Jetpack Credential Manager, який об'єднує passkeys, паролі та вхід через Google в одному системному bottom sheet. Passkeys підтримуються на пристроях з Android 9 (API 28) і новіших.

  • Додайте залежності androidx.credentials і credentials-play-services-auth.
  • Налаштуйте Digital Asset Links: файл assetlinks.json на https://example.com/.well-known/ з пакетом застосунку, SHA-256 відбитком і дозволом на спільне використання облікових даних.
  • Реєстрація — CreatePublicKeyCredentialRequest з JSON від сервера, вхід — GetPublicKeyCredentialOption у getCredential().
  • Опрацьовуйте всі винятки: скасування користувачем, відсутність облікових даних, переривання (можна повторити), відсутня конфігурація провайдера.
  • Параметр isConditional дозволяє автоматично створити passkey після входу паролем — аналог автоматичного оновлення на iOS.

Якщо ви використовуєте Google Play App Signing, у assetlinks.json має бути відбиток ключа, яким Google підписує застосунок, а не лише вашого upload key. Це найчастіша причина, чому passkeys працюють у debug і не працюють у production-збірці.

UX: як мігрувати користувачів з паролів

Повна відмова від паролів в один день нереалістична. Робочий план — поступове впровадження:

ЕтапЩо робимоМетрика
1. Пропозиція після входуПісля успішного входу паролем пропонуємо створити passkey або створюємо автоматичноЧастка користувачів із passkey
2. Passkey у налаштуванняхРозділ «Безпека»: список passkeys, додати, видалити, дата останнього використанняАктивні passkeys на користувача
3. Passkey-first вхідЕкран входу пропонує passkey першим, пароль — як запасний варіантЧастка входів через passkey, успішність входу
4. Реєстрація з passkeyНовий акаунт створюється одразу з passkey без пароляКонверсія реєстрації
5. Опціональна відмова від пароляКористувач із 2+ passkeys може видалити парольЗвернення в підтримку щодо доступу

Формулювання важливі. «Passkey» поки що знайомий не всім, тому пояснюйте вигоду: «Входьте за допомогою Face ID — без пароля». Google наводить рекомендовані тексти й іконки в UX-гайдах для passkeys. Не показуйте пропозицію при кожному вході: якщо користувач відмовився, повторіть через кілька тижнів.

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

  • Втрата пристрою. Синхронізовані passkeys відновлюються разом з акаунтом Apple чи Google. Але потрібен запасний шлях: e-mail з посиланням, другий passkey, коди відновлення. Його безпека визначає безпеку всієї системи.
  • Різні екосистеми. Користувач з iPhone і Android-планшетом: другий пристрій може увійти через QR-код або створити власний passkey. Підтримуйте кілька passkeys на акаунт.
  • Сторонні менеджери паролів. 1Password, Bitwarden та інші теж зберігають passkeys; не обмежуйте автентифікатори без потреби.
  • Видалений на сервері passkey. Він залишається в менеджері користувача і пропонуватиметься при вході. Використовуйте Signal API (там, де він доступний) або чітке повідомлення про помилку з пропозицією іншого способу входу.
  • Корпоративні пристрої. Політики MDM можуть вимикати синхронізацію Keychain; тестуйте такі сценарії, якщо продукт B2B.

Типові помилки

  • Невідповідність rp.id і домену в apple-app-site-association / assetlinks.json або редирект на цих файлах.
  • Відсутній release-відбиток (або відбиток Play App Signing) у assetlinks.json.
  • E-mail або телефон як user.id.
  • Повторне використання challenge або відсутність його перевірки на сервері.
  • Одна-єдина можливість входу через passkey без запасного шляху.
  • Скасування діалогу користувачем трактується як помилка і показує тривожне повідомлення.
  • Відсутність аналітики: без метрик неможливо зрозуміти, чи passkeys реально знижують тертя.

Чекліст впровадження

  1. Бекенд на перевіреній WebAuthn-бібліотеці; кілька passkeys на користувача; одноразові challenge.
  2. apple-app-site-association і assetlinks.json на домені rp.id, по HTTPS, без редиректів.
  3. Відбитки debug, release і Play App Signing на сервері та в assetlinks.json.
  4. iOS: Associated Domains (webcredentials), AutoFill-assisted вхід, автоматичне оновлення на iOS 18+.
  5. Android: Credential Manager, обробка всіх винятків, isConditional для автоматичного створення.
  6. UX: пропозиція після входу, розділ «Безпека», passkey-first екран входу, зрозумілі тексти.
  7. Запасні способи входу й відновлення з не меншим рівнем безпеки.
  8. Метрики: частка входів через passkey, успішність входу, звернення щодо доступу.

Джерела: FIDO Alliance: Passkeys; W3C Web Authentication Level 3; Apple: Supporting passkeys; Apple: Supporting associated domains; Android: Credential Manager; Android: Create passkeys; Android: Credential Manager prerequisites; Android: Passkeys UX guidelines; Google Identity: Passkeys; passkeys.dev; NIST SP 800-63B.