Skip to content

テナントの BOT アカウント

テナントの Admin が作る PAT 専用の自動化アカウント

概要

テナント Admin は、設定のメンバー画面から自動化用の BOT を作成できる。 BOT は作成元の一つのテナントだけに属し、PAT で API と既存 CLI を利用する。 管理者は BOT の作成、停止、再開、PAT の発行と取り消しを行える。 BOT は画面と対話用のセッションには入れない。 CLI の改修は範囲外で、既存の CLI に BOT の PAT を渡して使う。

振る舞い

所属と権限

BOT は既存の利用者レコードに account_kind=bot と bot_tenant_id を持つ。 所属、役割、プロジェクトの明示所属、PAT のスコープ判定を既存の仕組みと共有する。 BOT の役割は Member 相当まで(テナントでもプロジェクトでも Member か Viewer)に縛る。 BOT を Admin で作る、BOT を Admin に上げる、BOT を Admin でテナントやプロジェクトに加える操作は 400(bot-role-too-strong)で断る。 自動化に Admin の力が要るようになったら、この上限を緩める余地を残している。 BOT 自身の PAT では BOT 管理や PAT 発行を行えない。 BOT は個人用プロジェクト(My Tasks の Inbox)を持たない。個人用プロジェクトのエンドポイントは BOT には 404 を返す。 これらの操作には人のセッション認証が必要になる。

BOT を別のテナントのメンバーやプロジェクトのゲストに追加する操作、メール招待、招待の承諾は拒否する。 所属を取り除く操作の代わりに、BOT の停止を使う。 BOT のパスワード、パスキー、OAuth、TOTP、端末認証、対話用セッションは利用できない。

PAT の管理

PAT は発行時に一度だけ表示する。 管理画面を閉じると平文の値を消し、一覧では末尾 4 文字だけを表示する。 PAT の有効期限は必須で、発行時点から最大 365 日とする。 画面は端末の時計から期限を作るので、上限には 5 分の猶予を足す。 期限、スコープ、許可プロジェクトを絞ることで、漏えいした鍵の有効範囲を小さくする。

BOT を停止すると、その BOT の PAT をすべて取り消す。 再開しても取り消した PAT は復活せず、新しい鍵を発行する必要がある。 利用者レコードは残すため、過去のコメント、担当、操作履歴の投稿者を維持できる。

表示

担当者、担当者の候補、コメント投稿者、操作履歴、所属一覧に BOT の表示を付ける。 BOT はメンションの候補とコメントの投稿者にもなれる。

メール

メンションを含む通知データは既存の通知機構で扱うが、BOT にメールは配信しない。 メールアドレスは <利用者 UUID>@bots.task.invalid を内部で割り当てる。 この値は BOT の識別用で、受信箱を持たない。 メール送信前に BOT 専用アドレスを除外し、通知メールでは利用者の種別も検査する。

漏えいした PAT の範囲

PAT を取得した第三者は、その BOT の所属と役割、トークンのスコープ、有効期限、許可プロジェクトの交差で許された API 操作を行える。 書き込み権限を与えた場合は、タスクやコメントなどのデータを変更できる。 BOT の役割は Member 相当までなので、漏えいした PAT でメンバーの追加や役割の変更(人への権限の委任)は行えない。 必要なスコープに絞り、プロジェクト制限を併用する。

BOT の PAT から新しい PAT や BOT を発行することはできない。 人のセッションや端末トークンへ交換することもできない。 漏えい時は PAT を取り消すか BOT を停止し、関連する操作履歴を確認する。

データ

users に足した列は次のとおりである。

列 型 制約 説明
account_kind text NOT NULL、既定値は human 利用者の種別。human か bot
bot_tenant_id uuid tenants への外部キー。テナントを消すと BOT も消える BOT の持ち主のテナント。人では空

BOT の行は CHECK 制約で縛る。宛先は <利用者 UUID>@bots.task.invalid に限り、パスワードと TOTP を持たず、プラットフォーム管理者にならない。

列の定義は m20261106000000_tenant_bots.rs にある。

API

BOT の管理のエンドポイントは次のとおりである。

メソッド パス 説明
GET /v1/tenants/{tenant_id}/bots BOT の一覧
POST /v1/tenants/{tenant_id}/bots BOT の作成
PATCH /v1/tenants/{tenant_id}/bots/{bot_id} BOT の停止と再開
GET /v1/tenants/{tenant_id}/bots/{bot_id}/tokens PAT の一覧
POST /v1/tenants/{tenant_id}/bots/{bot_id}/tokens PAT の発行
DELETE /v1/tenants/{tenant_id}/bots/{bot_id}/tokens/{token_id} PAT の取り消し

GET /v1/personal_tokens/me と、利用者を返す応答は account_kind を含む。 BOT に Admin の役割を渡す要求は 400 を返し、message は bot-role-too-strong になる。

認可

操作 誰が スコープ
BOT の一覧、作成、停止、再開 テナントのオーナーと Admin の人。セッション認証に限る PAT では使えない
BOT の PAT の一覧、発行、取り消し テナントのオーナーと Admin の人。セッション認証に限る PAT では使えない
BOT の PAT による API の利用 BOT PAT のスコープとプロジェクト制限の範囲

テナントが 2FA を強制していれば、2FA を満たさない Admin は BOT の管理のエンドポイントで 403 になる。 BOT の PAT は 2FA の強制の対象から外す。

画面

項目 値
URL /{tenant}/settings/members
入口 テナントの設定のメンバー

BOT の欄はテナントのオーナーと Admin にだけ表示する。 欄では BOT の一覧、作成、停止と再開、PAT の発行と取り消しを行う。 BOT の役割は Member か Viewer から選ぶ。

未実装と既知の制限

  • メンションのチップには BOT の表示を付けていない。チップは Vue の部品でなく CSS で描くため

決定の記録

日付 決定 理由
2026-11-04 BOT の宛先を <利用者 UUID>@bots.task.invalid にし、メールアドレスを任意にしない 宛先を読む箇所が広く、届かない宛先なら型を変えずに送信の一箇所で止められる
2026-11-04 PAT の有効期限を必須にし、上限を 365 日とする BOT の鍵は人が日々見ない所に置かれ、漏れても気づきにくい
2026-11-04 BOT は削除せず、停止だけにする コメントや担当の投稿者を残す
2026-11-05 BOT の役割を Member 相当までに縛る Admin の BOT の PAT から人へ権限を委ねられるため
2026-11-05 BOT は個人用プロジェクトを持たない 個人用プロジェクトの Admin として、テナントの外の人をゲストに加えられるため
2026-11-05 BOT の PAT をテナントの 2FA の強制の対象から外す BOT は TOTP もパスキーも持てず、PAT の発行は 2FA を満たした Admin に限るため

Type to search…

↑↓ navigate↵ selectEsc close