Вхід для користувачів вашого застосунку

У вашому застосунку є облікові записи

Застосунки, створені на Kliv, мають власних користувачів — клієнтів, учасників чи колег тих, хто користується вашим продуктом. Кожен застосунок з самого початку отримує повноцінну систему входу для цих користувачів. Вам не потрібно підключати постачальника автентифікації чи самостійно керувати зберіганням паролів: опишіть, хто має мати змогу входити, а решту Kliv візьме на себе.

Одне важливе розрізнення: ця сторінка стосується користувачів вашого застосунку. Вхід для вашої власної команди — людей, які створюють застосунок разом із вами на Kliv, зокрема корпоративний SSO, яким користується ваша організація, — це окрема тема, описана в розділі Керування користувачами.

Способи входу

Користувачі вашого застосунку можуть входити за допомогою:

  • Електронної пошти та пароля — звичайний обліковий запис із підтвердженою адресою електронної пошти
  • Входу через Google і входу через Facebook — вхід одним клацанням за допомогою облікового запису, який у них уже є
  • Ключів доступу (passkeys, WebAuthn) — вхід без пароля за допомогою біометрії пристрою чи ключа безпеки
  • Двофакторної автентифікації (TOTP) — одноразового коду із застосунку-автентифікатора як другого кроку

Скажіть Kliv у розмові, які способи має пропонувати ваш застосунок. Достатньо написати: «Дозволь користувачам реєструватися через електронну пошту або Google і підтримуй ключі доступу».

Організації та ролі

Користувачі не обов’язково є пласким списком. Користувачі вашого застосунку можуть належати до організацій, а всередині організації кожен користувач має роль. Це природна структура для командних продуктів і B2B-застосунків: компанія реєструється, запрошує своїх людей, і те, що може робити кожен, залежить від його ролі. Опишіть потрібні вам ролі, і Kliv їх налаштує.

Вхід і доступ до даних

Вхід — це не просто двері на вході: він визначає, до чого має доступ кожен користувач. Доступ до даних підпорядковується правилам безпеки на рівні рядків вашої бази даних, тож авторизований користувач читає й записує лише ті рядки, які дозволяють ці правила. Як працює безпека на рівні рядків, читайте в розділі База даних.

Те саме стосується агентів. Якщо у вашому застосунку є агент, стан входу користувача визначає, що агент може читати від його імені: агент, який відповідає на запитання одного користувача, не може використовувати рядки, яких цей користувач сам не бачить. Див. Агенти та ваші дані.

Власні облікові дані Google або Facebook

Вхід через Google і Facebook працює одразу з ключами, якими керує Kliv, і вам не потрібно нічого реєструвати в постачальника. Власні ключі необов’язкові: з ними на екрані згоди постачальника відображається назва вашого застосунку, а не Kliv.

Якщо ви використовуєте власні ключі, зареєструйте в постачальника URI переспрямування для кожної адреси, на якій входять відвідувачі:

https://<адреса вашого сайту>/api/v2/auth/oauth/<постачальник>/complete

Наприклад: https://example.com/api/v2/auth/oauth/google/complete. Потрібен один URI на кожну адресу: по одному для кожного власного домену, а також один для адреси <ключ-сайту>.kliv.site вашого сайту, якщо відвідувачі нею користуються. Адресі www, яка переспрямовує на основний домен, URI не потрібен.

Складати їх вручну не потрібно. У розділі Налаштування сайту → Соціальний вхід → Використовуйте власні облікові дані OAuth наведено точні URI для вашого сайту, кожен із кнопкою копіювання.

Куди їх додати:

  • Google: у Google Cloud Console відкрийте свій клієнт OAuth і додайте їх у Authorized redirect URIs. Authorized JavaScript origins можна залишити порожнім.
  • Facebook: у своєму застосунку розробника Meta відкрийте налаштування Facebook Login і додайте їх у Valid OAuth Redirect URIs.

Вхід через Apple підтримує лише ключі, якими керує Kliv.

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

Пов’язана документація