mcpField
C
catalyst-authentication

catalyst-authentication

github.com/catalystbyzohoセキュリティ701.0k 回インストール今日更新
リポジトリ

catalyst-authentication について

Catalystアプリの認証実装とトラブルシューティングを支援するスキルです。ログインフロー、環境ごとのZAID設定、関数のアクセスルール、OAuthや外部IDプロバイダーの設定を案内します。

主な機能

  1. 01ホステッド／埋め込みログインの案内
  2. 02ユーザー登録とセッション確認
  3. 03開発・本番環境のZAID確認
  4. 04関数認証ルールの案内
  5. 05OAuthと外部ログインのリファレンス

活用シーン

  1. 01登録またはログインの実装
  2. 02本番環境でのソーシャルログイン失敗の調査
  3. 03外部APIのOAuthトークン管理

MCP 対応

利用可能な場合、MCPを使ってCatalyst CacheのSegment IDを検索できます。このスキル自体がMCPサーバーのインターフェースを提供するとは記載されていません。

インストール

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

$npx skills add https://github.com/catalystbyzoho/agent-skills --skill catalyst-authentication

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

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
auth-basics.md
auth-thirdparty.md
connections.md

詳細

ローカル認証にはプレーンな catalyst serve が必要です

認証がローカルで機能するのは、catalyst serve 経由でサーバーを起動した場合のみです。認証の開発にネイティブの開発サーバー（npm run dev、vite、next dev、ng serve など）は絶対に使用しないでください。Catalyst の認証ミドルウェア、Cookie の挿入、/__catalyst/sdk/init.js は catalyst serve 経由でのみ利用できます。

仕組み

  1. フローの種類を特定する — ホスト型ログイン（Catalyst のログインページにリダイレクト）、埋め込み型ログイン（カスタム UI）、またはバックエンドの getCurrentUser チェックです。
  2. references/auth-basics.md を読み込む — サインアップ／ログインのフロー、ZAID に関する注意点、ホスト型ログインと埋め込み型ログイン、よくある認証エラーを確認します。
  3. ZAID に関する警告 — ZAID は Development と Production で異なります。これは本番環境で最も多い認証の問題です。必ず環境を確認してください。
  4. セキュリティルール — 関数を呼び出せるユーザーを制御するクエリの場合は、catalyst-functions スキルの references/functions-basics.md にあるセキュリティルールのセクションを参照してください。セキュリティルールには 2 つのパラメーターがあります。（a）methods — 関数で有効にする HTTP メソッド（GET／POST／PUT／DELETE／PATCH）です（メソッドを削除すると、その HTTP メソッドが完全にブロックされます）。（b）authentication — 関数全体に適用され、メソッドごとには設定できない単一の二値フラグです（optional = 公開、required = 認証済みユーザーのみ）。ロールベースのデータアクセス制御については、DataStore のスコープと権限（Console → Table → Scopes and Permissions）を参照してください。
  5. OAuth／接続 — 外部 API の OAuth トークン管理（Zoho またはサードパーティー）については、references/connections.md を読み込みます。
  6. サードパーティー認証／ソーシャルログイン — クエリに Okta、Auth0、Duo、カスタム IdP、Google／Facebook／LinkedIn／Microsoft ログイン、generateCustomToken、または signinWithJwt が含まれる場合は、references/auth-thirdparty.md を読み込みます。

セキュリティチェックリスト

  • ZAID は環境ごとに異なります。 Development の ZAID は Production の ZAID と異なります。Development で設定したソーシャルログイン（Google、Facebook、LinkedIn、Microsoft）は、本番環境への移行前に Production の ZAID と本番アプリのドメインを使って必ず再設定してください。誤った ZAID を使うと、本番環境ですべてのソーシャルログインが通知なしに失敗します。
  • DataStore の権限は関数レベルの認証とは別です。 セキュリティルールで認証を必須にすると、関数を呼び出せるユーザーだけが制御されます。App User テーブルの権限（Console → Table → Scopes and Permissions）では、認証済みユーザーが実行できる DataStore 操作を個別に制御します。

トリガー

次の内容には、このスキルを使用してください："authentication"、"user management"、"login"、"signup"、getCurrentUser、"ZAID"、registerUser、isUserAuthenticated、signOut、"cross-domain logout"、"hosted login"、"embedded login"、"Connections"、"OAuth token"、getConnector、getAccessToken、"Security Rules"、"App User"、"credentials include"、"auth redirect"、"third-party auth"、"third-party authentication"、"social login"、"Google login"、"Facebook login"、"LinkedIn login"、"Microsoft login"、signinWithJwt、generateCustomToken、"Okta"、"Auth0"、"Duo"、"custom IdP"。

参照資料

参照資料クエリの内容が次の場合に読み込みます…
references/auth-basics.mdユーザーのサインアップ／ログイン、getCurrentUser、Web SDK の認証フロー、ZAID に関する注意点、ホスト型ログインと埋め込み型ログイン、よくある認証エラー
references/auth-thirdparty.mdサードパーティー認証サービス（Okta、Auth0、Duo）、ソーシャルログイン（Google／Facebook／LinkedIn／Microsoft）、generateCustomToken、signinWithJwt、トークンフロー、コンソールの設定
catalyst-functions スキルセキュリティルール — 関数の呼び出し制御（methods、authentication: optional/required）
references/connections.md外部 API の OAuth トークン管理 — getConnector、getAccessToken、Zoho およびサードパーティーサービスとの接続

コメント

Markdown 対応