bkend-auth について
bkend.ai の認証とセキュリティに関するリファレンスです。ログイン方式、トークン、アクセス制御、セッションを扱い、MCP のドキュメント検索を使った REST 認証の実装方法を説明します。
主な機能
- 01メール、ソーシャル、マジックリンク認証
- 02JWT アクセストークンとリフレッシュトークン
- 03パスワードリセットとアカウント操作
- 04RBAC と行レベルセキュリティ
- 05デバイスごとのセッション管理
活用シーン
- 01サインアップとログインフローの実装
- 02ソーシャルまたはマジックリンク認証の追加
- 03ロールと行レベルのアクセス制御
- 04ユーザーセッションの確認と取り消し
MCP 対応
bkend MCP には専用の認証ツールがありません。search_docs で認証ガイドとコード例を探し、REST API コードの生成に活用する手順を説明します。
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ ww-w-ai/ bkit-claude-code --skill bkend-authインストール後、Claude Code で/bkend-authを入力して読み込まれたか確認します。
詳細
bkend.ai 認証とセキュリティガイド
認証方法
| 方法 | 説明 |
|---|---|
| メールアドレス+パスワード | メールアドレスとパスワードでの登録およびログイン |
| ソーシャル(Google) | OAuth 2.0 によるソーシャルログイン |
| ソーシャル(GitHub) | OAuth 2.0 によるソーシャルログイン |
| マジックリンク | メールリンクでのログイン(パスワード不要) |
JWT トークン構造
- アクセストークン:有効期間は1時間です
- リフレッシュトークン:有効期間は7日間です
- 自動更新:
POST /v1/auth/refresh
パスワードポリシー
8文字以上で、大文字、小文字、数字、特殊文字を含めてください。
MCP 認証ワークフロー
bkend MCP には専用の認証ツールはありません。次のワークフローを使用してください。
- ドキュメントを検索:クエリ「email signup」または「social login」で
search_docsを実行します - サンプルを取得:クエリ「auth code examples」で
search_docsを実行します - コードを生成:検索結果に基づいて、AI が REST API コードを生成します
検索可能な認証ドキュメント
| ドキュメント ID | 内容 |
|---|---|
3_howto_implement_auth | 登録、ログイン、トークン管理のガイド |
6_code_examples_auth | メール、ソーシャル、マジックリンクのコード例 |
主要なパターン
User: "Add social login"
→ search_docs(query: "social login implementation")
→ Returns auth guide with REST API patterns
→ AI generates social login code
REST 認証 API(主要なエンドポイント)
エンドポイントの全一覧については、search_docs を使用するか、Live Reference を確認してください。
| メソッド | エンドポイント | 説明 |
|---|---|---|
| POST | /v1/auth/email/signup | 登録 |
| POST | /v1/auth/email/signin | ログイン |
| GET | /v1/auth/me | 現在のユーザー |
| POST | /v1/auth/refresh | トークンを更新 |
| POST | /v1/auth/signout | ログアウト |
| GET/POST | /v1/auth/:provider/callback | ソーシャルログインのコールバック |
| POST | /v1/auth/password/reset/request | パスワードリセットをリクエスト |
| POST | /v1/auth/password/reset/confirm | リセットを確定 |
| POST | /v1/auth/password/change | パスワードを変更 |
| GET | /v1/auth/sessions | セッション一覧 |
| DELETE | /v1/auth/sessions/:sessionId | セッションを削除 |
| DELETE | /v1/auth/withdraw | アカウントを削除 |
その他のエンドポイント(MFA、招待、ユーザー管理)については、search_docs または Live Reference を使用してください。
RBAC(ロールベースのアクセス制御)
| グループ | 説明 | 範囲 |
|---|---|---|
| admin | CRUD 全操作 | すべてのデータ |
| user | 認証済みユーザー | 全データの読み取り、自身のデータの書き込み |
| self | 所有者のみ | createdBy に基づく |
| guest | 未認証ユーザー | 読み取りのみ(通常) |
RLS(行レベルセキュリティ)
- テーブルごとの行レベルアクセス制御
- 4段階のポリシー:admin/user/self/guest
- createdBy フィールドに基づく自動フィルタリング
セッション管理
- デバイスごとのセッション追跡
GET /v1/auth/sessions- セッション一覧DELETE /v1/auth/sessions/:sessionId- セッションを削除
公式ドキュメント(Live Reference)
最新の認証ドキュメントを参照するには、WebFetch を使用してください。
- 認証の概要:https://raw.githubusercontent.com/popup-studio-ai/bkend-docs/main/en/authentication/01-overview.md
- MCP 認証ガイド:https://raw.githubusercontent.com/popup-studio-ai/bkend-docs/main/en/mcp/06-auth-tools.md
- セキュリティ:https://raw.githubusercontent.com/popup-studio-ai/bkend-docs/main/en/security/01-overview.md
- 目次全体:https://raw.githubusercontent.com/popup-studio-ai/bkend-docs/main/SUMMARY.md
コメント
Markdown 対応