セキュリティとアクセス制御

​

概要

​

認証

​

APIキーの管理

Organization
└── API Keys
    ├── production   (issued by: alice)   Last used: 2 hours ago
    ├── development  (issued by: bob)     Last used: 30 days ago
    └── ci-cd        (issued by: alice)   Last used: never

• デフォルトでは有効期限なし — キーは手動で削除するまで有効です。
• 最終使用日時が各キーに記録されます。
• 発行者の追跡 — キーを作成したメンバーが記録されます。
• 監査ログ — キーの作成・削除イベントがログに記録されます。

​

APIキーエンドポイント

​

ロールベースアクセス制御（RBAC）

​

ロール階層

Platform Level
└── super_admin          # サービス全体の管理

Organization Level
├── Owner                # 組織のオーナー（組織ごとに1名）
├── Admin                # 組織の管理者
└── Member               # 一般メンバー

​

組織ロール

​

権限マトリックス

​

ロールのルール

• 各組織には正確に1名のOwnerがいます。
• オーナーシップは別のメンバーに移転できます（元のオーナーはAdminになります）。
• OwnerとAdminのみが新しいメンバーを招待できます。
• Memberは自分のAPIキーを管理できますが、他者が作成したキーを参照・削除することはできません。

​

組織ベースの隔離

​

アプリケーションレイヤー

​

データベースレイヤー（Row Level Security）

ALTER TABLE tool_set ENABLE ROW LEVEL SECURITY;

CREATE POLICY tool_set_tenant_isolation ON tool_set
  USING (organization_id = current_setting('app.current_org_id'));

SET app.current_org_id = :orgId

• tool_set
• tool
• tool_set_version
• run
• apikey
• webhook
• audit_log

​

監査ログ

​

監査ログのデータモデル

interface AuditLog {
  id: string;
  orgId: string;
  userId: string;         // アクションを実行したユーザー
  action: string;         // 例: "member.added"
  targetType: string;     // 例: "member"
  targetId: string;       // 影響を受けたリソースのID
  details: object;        // 変更の詳細
  ipAddress: string;
  createdAt: Date;
}

​

監査ログの閲覧

​

Sandboxの隔離

• プロセスの隔離 — 各Sandboxは個別のコンテナまたはVMです。
• ネットワークの隔離 — SandboxはAPIサーバーの内部ネットワークにアクセスできません。
• 設定可能な環境変数 — シークレットはToolSetごとに注入され、ToolSet間で共有されません。
• 自動クリーンアップ — 実行完了またはタイムアウト後にSandboxは終了されます。

​

ベストプラクティス

• 環境ごとに異なるAPIキーを使用する（本番、ステージング、CI/CD） — キーが漏洩した場合の影響範囲を限定するためです。
• APIキーの使用状況を監査する — 最終使用日時を定期的に確認し、不要になったキーは削除してください。
• 最小権限のロールを割り当てる — Toolの作成・編集のみが必要な開発者にはMemberを使用してください。
• 監査ログを定期的に確認する — 予期しないアクセスパターンを検出するためです。
• 組織間でAPIキーを共有しない — 各キーは単一の組織にスコープされています。

​

関連ドキュメント

• REST API — 認証の詳細とエンドポイントリファレンス
• Webhook — イベント通知のセキュリティ（署名検証）
• Sandboxプロバイダー — 実行環境の隔離