アプリユーザー
Busabase で作ったアプリに、お客様がメールのコードでサインインし、自分の注文やレコードだけを見られるようにします。アカウントはシートを使わずに管理できます。
ショップで買い物をしたお客様は、来週もう一度自分の注文を確認したくなります。会員限定のページは、誰が読んでいるのかを知る必要があります。アプリユーザーを使うと、アプリの利用者が自分のアカウントを持てます。メールに届くコードでサインインし、自分の行だけを見られます。Busabase の画面は一切見えず、シートも使いません。
アプリユーザーは Busabase Cloud で、ウェブサイトとして公開したアプリに使えます。
アプリユーザー、メンバー、ゲストの違い
| 誰 | どんな人か | できること |
|---|---|---|
| メンバー | あなたのチーム | Busabase でスペースを開き、シートを使い、権限に応じてベース・ドキュメント・アプリを扱う |
| アプリユーザー | アプリが対象とする人(ショップの購入者など) | あなたのアプリにだけサインインする。シートなし、Busabase の画面なし、パスワードなし。アプリが見せる内容のうち、自分の行だけが見える |
| ゲスト | サインインせずにアプリを使う人 | 商品の閲覧やゲスト購入など、アプリが公開している機能 |
アプリユーザーはスペースごとに 1 つのプールにまとまります。同じメールアドレスで 2 つのアプリにサインインした人は、両方を使った 1 人のアプリユーザーです。アプリユーザーがメンバーになることはなく、アプリユーザーになってもワークスペースへのアクセス権は得られません。
アプリのサインインをオンにする
そのアプリの管理権限が必要です。Busabase Cloud では、スペースが Plus 以上のプラン(トライアルを含む)である必要があります。Free ではスイッチがロックされ、アップグレードボタンが表示されます。サインインをオンにしたまま Free に戻った場合、新しいコードは送信されず、サインイン済みの人はセッションの期限までそのままです。サインインをオフにすることはいつでもできます。
- アプリを開き、設定 → ユーザーのサインインに進みます。
- このアプリへのサインインを許可するをオンにします。
- メールに表示する名前を入力します。サインインメールの差出人名と件名に表示される名前です。空欄ならアプリ名が使われます。
- 保存をクリックします。
設定はこれだけです。アカウントは Busabase が保存するので、ユーザー用のテーブルは不要です。
どの行が誰のものか
どの行がどの購入者のものかは、設定ではなくアプリ自身が決めます。アプリは購入者の ID を、注文ベースの customer-account のようなアプリユーザー列(または普通のテキスト列)に保存します。サインインした購入者が注文すると、アプリのサーバーがその人のアプリユーザー ID をこの列に書き込みます。購入者が「注文履歴」を開くと、アプリは customer-account がサインイン中の購入者と一致する行を Busabase に求め、購入者の ID は Busabase が確認済みのサインインから埋めます。他人の ID を名乗ることはできません。
- 持ち主の列が空の行は誰のものでもありません。ゲスト購入の注文はこのままです。
- アプリユーザー列では各 ID が購入者のメールアドレスで表示され、無効にした購入者には印が付き、削除したアカウントは削除されたアプリユーザーと表示されます。メールアドレスをクリックすると、状態・最終サインイン・サインインしたアプリと、アプリユーザーを管理へのリンクが表示されます。行を編集するとき、スペースのオーナーと管理者はメールアドレスで購入者を選べます。ほかのメンバーは現在の値をそのままにするか、クリアできます。
- ID を入れたテキスト列がすでにある場合は、列の設定で種類をアプリユーザーに変えてください。値はすべてそのまま残ります。
- テンプレートを書き出すとき、アプリユーザー列の値は含まれません。ID はこのスペースの購入者のもので、ほかのスペースでは意味がないためです。列そのものは残ります。
サインインをオフにすると全員がサインアウトされます
このアプリへのサインインを許可するをオフにすると、そのアプリのセッションはすべて直ちに終了します。アプリが下記のとおり作られていれば(開発者向けを参照)、ゲスト向けの機能はそのまま使えます。
購入者に見えるもの
- アプリでメールアドレスを入力します。
- 6 桁のコードが届きます。作ったり忘れたりするパスワードはありません。
- コードを入力するとサインインでき、そのブラウザでは 30 日間サインインしたままになります。
コードの有効期限は 10 分で、5 回まで試せます。新しいコードを求めると、それより前のコードは使えなくなります。
メールにはあなたのアプリの名前(メールに表示する名前、なければアプリ名)が表示され、Busabase の名前は出ません。メールはアプリが指定した言語で届きます。対応しているのは英語、簡体字中国語、繁体字中国語、日本語、韓国語、ドイツ語、フランス語、スペイン語、ポルトガル語、ベトナム語で、それ以外は英語になります。
サインインの回数制限
アプリがスパム送信に悪用されないよう、Busabase はコードを送れる頻度を制限しています。制限に達すると、アプリには RATE_LIMITED が返り、理由(reason)と待つべき秒数(retryAfterSeconds)が付きます。次の順番でチェックされます。
reason | 制限 | 購入者への伝え方 |
|---|---|---|
cooldown | 同じメールアドレスへは 60 秒に 1 回 | 「コードを送信しました。N 秒後にもう一度リクエストできます。」 |
ip_hourly_limit | 同じネットワークから 1 時間に 5 回まで(アプリごと) | 「このネットワークからの試行が多すぎます。しばらくしてからお試しください。」 |
ip_daily_limit | 同じネットワークから 1 日 20 回まで(アプリごと) | 上と同じ |
email_daily_limit | 同じメールアドレスへは 1 日 10 回まで | 「このアドレスへのコード送信が今日は多すぎます。明日もう一度お試しください。」 |
space_daily_limit | スペースごとに 1 日 1000 回まで。まだアプリユーザーでないアドレスだけを数える | 「ただいまサインインが混み合っています。しばらくしてからお試しください。」 |
space_daily_limit のせいでリピーターがサインインできなくなることはありません。数えるのは新しいアドレスだけなので、誰かがでたらめなアドレスにコードを送り続けても、既存のお客様は普段どおりサインインできます。
ネットワーク単位の制限は、アプリがリクエストに購入者の IP アドレスを付けたときだけ適用されます。Busabase が保存するのはそのアドレスの鍵付きハッシュだけで、アドレスそのものは保存しません。
アプリユーザーを管理する
スペース設定 → アプリユーザーを開くと、アプリにサインインしたすべての人が表示されます。
- メールで検索とアプリで絞り込むで人を探せます。一覧には状態、最終サインイン、使ったアプリ、作成日が表示されます。古いアカウントを見るにはさらに読み込むをクリックします。
- 無効にすると、その人はサインインできなくなり、すべてのアプリから直ちにサインアウトされます。有効にすると、再びサインインできます。
- 削除すると、アカウント、コード、セッションが削除されます。注文などのレコードはそのまま残ります。後でもう一度サインインすると、新しいアカウントになります。
誰が何をできるか:
| 役割 | できること |
|---|---|
| スペースのオーナーまたは管理者 | すべてのアプリユーザーの閲覧、無効化、有効化、削除 |
| あるアプリの管理権限を持つメンバー | そのアプリの設定 → ユーザーのサインイン → アプリユーザーを管理から、そのアプリにサインインした人を閲覧(読み取り専用)。そのアプリのサインイン設定の変更 |
| その他のメンバー | アプリのサインイン設定の閲覧 |
無効化・有効化・削除と、アプリのサインイン設定の変更は、すべて Cloud の監査ログに記録され、操作したメンバーと API キーが残ります。
CLI やエージェントから
同じ管理操作は CLI でも行えます。
busabase-cli app-users list --email buyer@example.com # または --app-id <アプリ ID>
busabase-cli app-users disable --id <アプリユーザー ID>
busabase-cli app-users enable --id <アプリユーザー ID>
busabase-cli app-users delete --id <アプリユーザー ID>
busabase-cli app-users get-settings --app-id <アプリ ID>
busabase-cli app-users put-settings --app-id <アプリ ID> --enabled --app-name "Kelly's Shop"
busabase-cli app-users put-settings --app-id <アプリ ID> --no-enabled # ログインをオフにする(全員がログアウトされます)MCP では、エージェントは app_users_list、app_users_disable、app_users_enable、app_users_delete、app_users_get_settings、app_users_put_settings のツールを使えます。エージェントはサインインコードを送ったり、アプリユーザーとして操作したりはできません。それはアプリのサーバーだけが行う処理です。
プライバシー
- アプリユーザーを削除すると、アカウント、コード、セッションが削除されます。注文などの業務データの行は残ります。その行の持ち主の列には古い ID が残りますが、今後どのアカウントもその ID と一致することはありません。
- Busabase はサインインコード、セッショントークン、IP アドレスをハッシュとしてだけ保存します。
- 古いサインインコードは 48 時間後に自動で削除されます。
開発者向け
アプリユーザーに関する処理は、すべてアプリ自身のサーバー(ウェブサイトなら Worker)で、サイトがすでに持っている API キーを使って行います。ブラウザは /account/send-code のようなアプリ自身のルートとだけ通信し、API キーを目にすることはありません。
SDK によるサインインの流れ
import {
Busabase,
appUserSessionCookie,
clearAppUserSessionCookie,
getAppUserSessionToken,
} from "busabase-sdk";
const bb = new Busabase({
baseUrl: env.BUSABASE_BASE_URL,
apiKey: env.BUSABASE_API_KEY,
spaceId: env.BUSABASE_SPACE_ID,
});
const appId = "<アプリのノード ID>";
// 1. POST /account/send-code:ショップの言語で購入者にコードを送る。
await bb.appUsers.sendCode({
appId,
email,
locale: "ja",
ip: request.headers.get("CF-Connecting-IP") ?? undefined,
});
// 2. POST /account/verify:コードをセッションに交換し、HttpOnly Cookie に保存する。
const { sessionToken } = await bb.appUsers.verify({ appId, email, code });
return new Response(null, {
status: 303,
headers: { Location: "/account", "Set-Cookie": appUserSessionCookie(sessionToken) },
});
// 3. GET /account:サインイン中のユーザーと、その人自身の注文。
const token = getAppUserSessionToken(request);
const user = await bb.appUsers.getUser({ appId, sessionToken: token }); // 未サインインなら null
if (user) {
const { records, nextCursor } = await bb.appUsers.queryRecords({
appId,
sessionToken: token,
baseId: "orders",
ownerField: "customer-account", // 購入者のアプリユーザー ID を入れるアプリユーザー列(またはテキスト列)
limit: 20,
});
}
// 4. POST /account/sign-out
await bb.appUsers.signOut({ appId, sessionToken: token });
return new Response(null, {
status: 303,
headers: { Location: "/", "Set-Cookie": clearAppUserSessionCookie() },
});localeを渡すとメールがサイトの言語になり、ip(購入者のアドレス。CF-Connecting-IP、なければX-Forwarded-Forの最初の値)を渡すとネットワーク単位の制限があなたのアプリを守ります。- サインイン中の購入者が注文などの行を作るときは、サーバー側でセッションから得た
user.idを持ち主の列に書き込みます。ブラウザから送られた値は決して使わないでください。購入者の確認済みのuser.emailも同じように別のメール列に書き込みます。 queryRecordsにはownerField(アプリユーザー ID を入れるアプリユーザー列(またはテキスト列)のスラッグ)を渡します。どの列を使うかはサーバーが決め、値は Busabase が確認済みのセッションから埋めてownerField = サインイン中のユーザー IDを強制します。ほかのユーザーの行はそもそも返りません。
ユーザーの行を自分で絞り込まない
サイトのキーでベースを読み、コードで「この購入者の注文」を絞り込むことはしないでください。サイトのキーはすべての行を読めるため、バグひとつで別のお客様の注文が見えてしまいます。必ず bb.appUsers.queryRecords(POST /api/v1/app-users/records/query)に ownerField を渡し、Busabase にサインイン中のユーザー ID での絞り込みを任せてください。
処理すべきエラー
エラーには code があり、追加情報は data に入ります。
code | 発生するとき | 対応 |
|---|---|---|
APP_LOGIN_DISABLED | このアプリのサインインがオフ | アカウント関連の UI を隠す |
INVALID_EMAIL | メールアドレスの形式が正しくない | アドレスの確認を促す |
RATE_LIMITED | 制限に達した。data.reason、data.retryAfterSeconds | 上の表のメッセージを表示する |
INVALID_CODE | コードが違う。data.attemptsLeft | もう一度入力してもらう |
CODE_EXPIRED | コードの期限切れ、試行回数切れ、または未送信 | 新しいコードの送信を案内する |
APP_USER_DISABLED | アカウントが無効にされている | このアカウントではサインインできないと伝える |
APP_USER_SESSION_INVALID | セッションがない、期限切れ、取り消し済み、または別のアプリのもの | Cookie を消してサインインフォームを表示する(getUser は null を返す) |
INVALID_OWNER_FIELD | ownerField がそのベースのアプリユーザー列でもテキスト列でもない | アプリのコードで列のスラッグを直す |
ゲスト向けの流れを止めない
サインインは任意の機能で、なくてもアプリは動かなければなりません。bb.appUsers.getSettings({ appId }) で設定を一度読み、enabled: false が返るか、リクエストが 404 で失敗した場合(アプリユーザー機能のない古いサーバー)は、アカウントへのリンクをすべて隠し、ゲスト購入などの公開機能をそのまま使えるようにしてください。