アプリのユーザー向けサインイン
アプリにはアカウントが付属する
Kliv で構築されたアプリには、そのアプリ自身のユーザーがいます。あなたの製品を使う人の顧客、メンバー、チームメイトです。すべてのアプリには、それらのユーザー向けの完全なサインインシステムが最初から組み込まれています。認証プロバイダーを統合したり、パスワード保存を自分で管理したりする必要はありません。誰がサインインできるべきかを説明すると、Kliv が残りを処理します。
区別しておくべき点が 1 つあります。このページは、あなたのアプリのユーザーについてです。Kliv 上で一緒にアプリを構築するあなた自身のチーム、組織が使う enterprise SSO を含む人たちのサインインは別で、ユーザー管理で扱います。
サインイン方法
アプリのユーザーは次の方法でサインインできます。
- メールアドレスとパスワード — 確認済みメールアドレスを使う従来のアカウント
- Sign in with Google と Sign in with Facebook — すでに持っているアカウントを使う 1 クリックのソーシャルサインイン
- Passkeys (WebAuthn) — デバイスの生体認証またはセキュリティキーを使うパスワードレスサインイン
- Two-factor authentication (TOTP) — 認証アプリからの時間ベースコードを第 2 ステップとして使う方法
アプリが提供すべき方法を Kliv に会話で伝えてください。「ユーザーがメールまたは Google でサインアップでき、パスキーもサポートして」のように言えば十分です。
組織とロール
ユーザーはフラットな一覧である必要はありません。アプリのユーザーは組織に所属でき、組織内で各ユーザーはロールを持てます。これはチーム製品や B2B アプリに自然な形です。会社がサインアップし、メンバーを招待し、各人ができることはロールに従います。必要なロールを説明すると、Kliv が設定します。
サインインとデータアクセス
サインインは単なる入口のゲートではありません。各ユーザーが何に到達できるかを決めます。データアクセスはデータベースの row-level security ルールに従うため、サインイン済みユーザーはそのルールが許可する行だけを読み書きします。row-level security の仕組みはデータベースを参照してください。
同じことはエージェントにも当てはまります。アプリにエージェントが含まれる場合、ユーザーのサインイン状態は、そのユーザーに代わってエージェントが何を読めるかを範囲づけます。あるユーザーの質問に答えるエージェントが、そのユーザー自身が見られない行を利用することはできません。エージェントとデータを参照してください。
自分の Google / Facebook 認証情報を使う
Google と Facebook でのサインインは、Kliv が管理するキーでそのまま使えます。プロバイダー側で何かを登録する必要はありません。自分のキーを使うかどうかは任意です。自分のキーを使うと、プロバイダーの同意画面に Kliv ではなくアプリの名前が表示されます。
自分のキーを使う場合は、訪問者がサインインするアドレスごとに、リダイレクト URI をプロバイダーに登録してください。
https://<サイトのアドレス>/api/v2/auth/oauth/<プロバイダー>/complete
例:https://example.com/api/v2/auth/oauth/google/complete。アドレスごとに 1 つずつ必要です。カスタムドメインごとに 1 つ、さらに訪問者がサイトの <サイトキー>.kliv.site アドレスを使う場合はそのぶんも 1 つ登録します。メインドメインへリダイレクトする www アドレスには不要です。
URI を自分で組み立てる必要はありません。サイト設定 → ソーシャルログイン → 自分の OAuth 認証情報を使用 に、サイトで使う正確な URI がコピーボタン付きで一覧表示されます。
登録先:
- Google: Google Cloud Console で OAuth クライアントを開き、承認済みのリダイレクト URI(Authorized redirect URIs)に追加します。承認済みの JavaScript 生成元 は空のままでかまいません。
- Facebook: Meta の開発者アプリで Facebook ログインの設定を開き、有効な OAuth リダイレクト URI(Valid OAuth Redirect URIs)に追加します。
Apple でサインインは、Kliv が管理するキーにのみ対応しています。
プレビュー用アドレスでは、自分のキーによるサインインは動作しません。動作確認は公開済みのサイトで行ってください。
関連ドキュメント
- データベース → — row-level security ルール
- エージェントとデータ → — エージェントがユーザーアクセスをどう尊重するか
- ユーザー管理 → — あなた自身のチーム向けのサインインとロール