Busabase

アプリユーザー

Busabase で作ったアプリに、お客様がメールのコードでサインインし、自分の注文やレコードだけを見られるようにします。アカウントはシートを使わずに管理できます。

ショップで買い物をしたお客様は、来週もう一度自分の注文を確認したくなります。会員限定のページは、誰が読んでいるのかを知る必要があります。アプリユーザーを使うと、アプリの利用者が自分のアカウントを持てます。メールに届くコードでサインインし、自分の行だけを見られます。Busabase の画面は一切見えず、シートも使いません。

アプリユーザーは Busabase Cloud で、ウェブサイトとして公開したアプリに使えます。

アプリユーザー、メンバー、ゲストの違い

誰どんな人かできること
メンバーあなたのチームBusabase でスペースを開き、シートを使い、権限に応じてベース・ドキュメント・アプリを扱う
アプリユーザーアプリが対象とする人(ショップの購入者など)あなたのアプリにだけサインインする。シートなし、Busabase の画面なし、パスワードなし。アプリが見せる内容のうち、自分の行だけが見える
ゲストサインインせずにアプリを使う人商品の閲覧やゲスト購入など、アプリが公開している機能

アプリユーザーはスペースごとに 1 つのプールにまとまります。同じメールアドレスで 2 つのアプリにサインインした人は、両方を使った 1 人のアプリユーザーです。アプリユーザーがメンバーになることはなく、アプリユーザーになってもワークスペースへのアクセス権は得られません。

アプリのサインインをオンにする

そのアプリの管理権限が必要です。Busabase Cloud では、スペースが Plus 以上のプラン(トライアルを含む)である必要があります。Free ではスイッチがロックされ、アップグレードボタンが表示されます。サインインをオンにしたまま Free に戻った場合、新しいコードは送信されず、サインイン済みの人はセッションの期限までそのままです。サインインをオフにすることはいつでもできます。

  1. アプリを開き、設定 → ユーザーのサインインに進みます。
  2. このアプリへのサインインを許可するをオンにします。
  3. メールに表示する名前を入力します。サインインメールの差出人名と件名に表示される名前です。空欄ならアプリ名が使われます。
  4. 保存をクリックします。

設定はこれだけです。アカウントは Busabase が保存するので、ユーザー用のテーブルは不要です。

どの行が誰のものか

どの行がどの購入者のものかは、設定ではなくアプリ自身が決めます。アプリは購入者の ID を、注文ベースの customer-account のようなアプリユーザー列(または普通のテキスト列)に保存します。サインインした購入者が注文すると、アプリのサーバーがその人のアプリユーザー ID をこの列に書き込みます。購入者が「注文履歴」を開くと、アプリは customer-account がサインイン中の購入者と一致する行を Busabase に求め、購入者の ID は Busabase が確認済みのサインインから埋めます。他人の ID を名乗ることはできません。

  • 持ち主の列が空の行は誰のものでもありません。ゲスト購入の注文はこのままです。
  • アプリユーザー列では各 ID が購入者のメールアドレスで表示され、無効にした購入者には印が付き、削除したアカウントは削除されたアプリユーザーと表示されます。メールアドレスをクリックすると、状態・最終サインイン・サインインしたアプリと、アプリユーザーを管理へのリンクが表示されます。行を編集するとき、スペースのオーナーと管理者はメールアドレスで購入者を選べます。ほかのメンバーは現在の値をそのままにするか、クリアできます。
  • ID を入れたテキスト列がすでにある場合は、列の設定で種類をアプリユーザーに変えてください。値はすべてそのまま残ります。
  • テンプレートを書き出すとき、アプリユーザー列の値は含まれません。ID はこのスペースの購入者のもので、ほかのスペースでは意味がないためです。列そのものは残ります。

サインインをオフにすると全員がサインアウトされます

このアプリへのサインインを許可するをオフにすると、そのアプリのセッションはすべて直ちに終了します。アプリが下記のとおり作られていれば(開発者向けを参照)、ゲスト向けの機能はそのまま使えます。

購入者に見えるもの

  1. アプリでメールアドレスを入力します。
  2. 6 桁のコードが届きます。作ったり忘れたりするパスワードはありません。
  3. コードを入力するとサインインでき、そのブラウザでは 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_FIELDownerField がそのベースのアプリユーザー列でもテキスト列でもないアプリのコードで列のスラッグを直す

ゲスト向けの流れを止めない

サインインは任意の機能で、なくてもアプリは動かなければなりません。bb.appUsers.getSettings({ appId }) で設定を一度読み、enabled: false が返るか、リクエストが 404 で失敗した場合(アプリユーザー機能のない古いサーバー)は、アカウントへのリンクをすべて隠し、ゲスト購入などの公開機能をそのまま使えるようにしてください。

On this page