mcpField
A
auth-tool-cloudbase

auth-tool-cloudbase

github.com/tencentcloudbaseセキュリティ1.2k49 回インストール今日更新
リポジトリ

auth-tool-cloudbase について

CloudBase アプリの認証プロバイダーとログイン方法を設定するスキルです。実装前にプロバイダーの準備状況を確認し、アプリ側の設定と MCP 管理ログインを区別します。

主な機能

  1. 01認証プロバイダーの設定
  2. 02ログイン方法の準備状況確認
  3. 03公開鍵とドメインの設定
  4. 04SMS・メール配信の設定
  5. 05アプリ側と MCP 認証の区別

活用シーン

  1. 01実装前のログインプロバイダー有効化
  2. 02Web 認証フローの前提条件確認
  3. 03SMS またはメールログインの設定
  4. 04既存アプリのログイン設定確認

MCP 対応

queryAppAuth や manageAppAuth などの CloudBase MCP ツールで、アプリ認証を設定します。auth ツールは MCP 管理側のログインに使用します。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/tencentcloudbase/cloudbase-ai-toolkit --skill auth-tool-cloudbase

インストール後、Claude Code で/auth-tool-cloudbaseを入力して読み込まれたか確認します。

同梱ファイルchecklist.mdreferences/extended-guide.md

詳細

関連スキル（ローカルのみ）

関連する CloudBase スキルは、このスキルと同じ場所に配置されています。../auth-tool-cloudbase/SKILL.md のように、ローカルの相対パスを使用してください。

参照先の関連スキルファイルがこの環境に存在しない場合は、CloudBase プラグイン全体（または不足しているスキル）のインストールをユーザーに依頼してください。リモートのスキルやプロトコルの Markdown を HTTP で取得して、エージェントのコンテキストに読み込んではいけません。

アクティベーション契約

まずこのスキルを使用する場合
  • CloudBase の認証プロバイダー、ログイン方法、公開可能キーの前提条件、SMS／メールの配信、またはサードパーティログインの準備状況を確認、有効化、無効化、または設定するタスクの場合。
  • プロバイダーの状態とログイン設定を確認するまで、認証の実装を進められない場合。
  • auth-web-cloudbase を使用する前に、CloudBase Web 認証フローでプロバイダーの検証が必要な場合。
コードを書く前に読む場合
  • プロバイダーのセットアップ、認証コンソールの設定、公開可能キーの取得、ログイン方法の利用可否、SMS／メール送信者の設定、またはサードパーティプロバイダーの認証情報に関する依頼の場合。
  • プロバイダーの設定と、Web、ミニプログラム、Node、または生の HTTP による認証実装が混在するタスクの場合。
続けて読むスキル
  • Web 認証 UI -> ../auth-web-cloudbase/SKILL.md
  • ミニプログラムのネイティブ認証 -> ../auth-wechat-miniprogram/SKILL.md
  • Node のサーバーサイド ID／カスタムチケット -> ../auth-nodejs-cloudbase/SKILL.md
  • ネイティブアプリ／生の HTTP 認証クライアント -> ../http-api-cloudbase/SKILL.md
以下の用途には使用しないでください
  • あらゆるログインまたは登録リクエストに対するデフォルトの実装ガイド。
  • プロバイダーの変更が伴わない場合に、ミニプログラムのネイティブ認証の動作を置き換えるもの。
  • Node 側の呼び出し元の ID、ユーザー検索、またはカスタムログインチケットのフローを置き換えるもの。
  • フロントエンドの統合、セッション管理、またはクライアント UX の実装を置き換えるもの。
よくある間違い／注意点
  • 必要なプロバイダーを有効化する前に、ログイン UI を作成する。
  • 「auth」という記述があれば、すべてプロバイダー管理タスクだと判断する。
  • クラウド関数で Web ログインを実装する。
  • ネイティブアプリの認証を Web SDK のフローにルーティングする。
  • 変更安全性プロトコル（cloudbase-platform/references/protocols/change-safety-protocol.md）に従う前に、設定やコードを変更する。
  • 既存アプリケーションで、準備状況がすでに確認できているのにプロバイダーの問い合わせを繰り返し、アクティブなログインおよび登録ハンドラーの接続を進めない。
最小チェックリスト
  • 認証を実装する前に、Authentication Activation Checklist を読んでください。
  • 匿名ログインはデフォルトで無効です。公開可能な accessKey だけでは、ゲートウェイで認証された匿名セッションは作成されません。@cloudbase/js-sdk 3.x では、必要に応じてこのスキルを使用して匿名ログインを有効にし、その後、NoSQL の app.database() CRUD を実行する前にクライアントから await auth.signInAnonymously()（または同等の認証済みセッション）を呼び出す必要があります。そうしないと、ゲートウェイから 401 が返されます。管理者パネルなど、確認済みのログインが必要なアプリでは、AuthGuard／RLS を適用し、ログイン戦略の切り替えだけに頼らず is_anonymous を拒否してください。

概要

CloudBase の認証プロバイダー（Anonymous、Username/Password、SMS、Email、WeChat、Google など）を設定します。

前提条件：CloudBase 環境 ID（env）

MCP ツールの境界

次の2つの認証ドメインは分けてください。

  • auth：MCP／管理側のログイン専用です。status、start_auth、set_env、logout、get_temp_credentials に使用します。
  • queryAppAuth／manageAppAuth：アプリ側の認証設定用です。ログイン方法、プロバイダー設定、公開可能キー、静的ドメイン、クライアント設定、カスタムログインキーに使用します。

このスキルでは、次の順序で実行することを推奨します。

  1. 必要な操作がある場合は、まず queryAppAuth／manageAppAuth を使用します。
  2. callCloudApi は、フォールバックとして、または未加工のリクエスト形式をデバッグする場合にのみ使用します。
  3. アプリ側のプロバイダー設定を MCP の auth ツールに戻さないでください。
  4. ログインと登録のハンドラーが有効な既存プロジェクトでは、必要なログイン方法と公開可能キーが確認できた後、プロバイダー設定の確認を繰り返さないでください。有効なフロントエンドハンドラーに戻り、実際のユーザーフローを完了してください。

詳細ガイド

詳しいシナリオ、例、パターンについては、extended-guide.md をお読みください。

リファレンス一覧

パッケージに含まれるすべてのリファレンスファイル（スキルのリントで到達性を確保するために必要です）。

コメント

Markdown 対応