アプリのユーザー向けサインイン

アプリにはアカウントが付属する

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 が管理するキーにのみ対応しています。

プレビュー用アドレスでは、自分のキーによるサインインは動作しません。動作確認は公開済みのサイトで行ってください。

関連ドキュメント