Вхід для користувачів вашого застосунку
У вашому застосунку є облікові записи
Застосунки, створені на 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.
Вхід на адресах попереднього перегляду з власними ключами не працює, тож перевіряйте його на опублікованому сайті.
Пов’язана документація
- База даних → — правила безпеки на рівні рядків
- Агенти та ваші дані → — як агенти дотримуються доступу користувачів
- Керування користувачами → — вхід і ролі для вашої власної команди