auth-wechat-miniprogram

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

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

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

有効化の条件

まずこのスキルを使う場合

• タスクが WeChat ミニプログラムの認証動作、wx.cloud の ID、OPENID / UNIONID、または CloudBase でミニプログラムの呼び出し元を識別する方法に関する場合。
• プロジェクトが CloudBase のミニプログラムで、認証に関する質問がプロバイダー設定ではなく、ミニプログラムのネイティブ ID に関する場合。

コードを書く前に読む場合

• リクエストにミニプログラムのログイン、クラウド関数内のユーザー ID、または wx.cloud の認証に関する前提が含まれている場合。
• ユーザーがミニプログラムで Web 形式のログインページや明示的なトークン交換を求めている場合は、ミニプログラムのネイティブ認証動作を案内してください。

併せて読む

• ミニプログラムのプロジェクト実装 -> ../miniprogram-development/SKILL.md
• クラウド関数の実装 -> ../cloud-functions/SKILL.md

使用しない場合

• Web ベースの WeChat ログインや Web 認証 UI。
• プロバイダーの有効化／無効化や認証コンソールの設定。
• ミニプログラムの ID 処理以外の、汎用的な Node 側の認証フロー。

よくある間違い／注意点

• wx.cloud のミニプログラムに Web 形式のログインページを生成する。
• ミニプログラムの認証をプロバイダー設定の問題として扱う。
• 呼び出し元の ID がクラウド関数に自動的に注入されることを忘れる。

このスキルを使用する場合

CloudBase プロジェクトでの WeChat ミニプログラム認証に、このスキルを使用してください。

次のような場合に使用します。

• CloudBase を使った、ID を認識する WeChat ミニプログラムのフローを実装する
• クラウド関数でユーザー ID（openid、unionid）にアクセスする
• WeChat 認証と CloudBase の連携方法を理解する
• ユーザーの識別が必要なミニプログラムの機能を構築する

主な利点： CloudBase を使った WeChat ミニプログラム認証はシームレスかつ自動で、複雑な OAuth フローは必要ありません。ミニプログラムがクラウド関数を呼び出すと、ユーザーの openid が自動的に注入され、WeChat によって検証されます。

次の場合は使用しないでください：

• Web ベースの WeChat ログイン（auth-web スキルを使用してください）
• Node SDK によるサーバー側の認証（auth-nodejs スキルを使用してください）
• WeChat 以外の認証方式（該当する認証スキルを使用してください）

---

このスキルの使い方（コーディングエージェント向け）

1. CloudBase 環境を確認する

   • ユーザーに以下を尋ねます。
     • env – CloudBase 環境 ID
     • ミニプログラムが CloudBase 環境にリンクされていることを確認する

2. 認証フローを把握する

   • WeChat ミニプログラム認証はネイティブかつ自動です
   • ほとんどの場合、明示的なログイン API 呼び出しは必要ありません
   • ユーザー ID はクラウド関数内で自動的に利用できます
   • すべての認証検証は CloudBase が処理します

3. このファイルからシナリオを選ぶ

   • クラウド関数での基本的なユーザー ID の確認には、シナリオ 2 を使用します
   • ミニプログラムの初期化には、シナリオ 1 を使用します
   • ミニプログラムからクラウド関数を呼び出してユーザー ID を受け取るには、シナリオ 3 を使用します
   • 認証のテストには、シナリオ 4 を使用します

4. CloudBase API の形式を厳密に守る

   • クラウド関数では wx-server-sdk を使用します
   • ミニプログラムのクライアントコードでは wx.cloud を使用します
   • このファイルに記載されているメソッド名とパラメーター形式を正式なものとして扱います

5. API に確信が持てない場合

   • CloudBase の公式ミニプログラムドキュメントを参照します
   • 公式ドキュメントに記載されているメソッドのみを使用します

---

基本概念

WeChat ミニプログラム認証が CloudBase でどのように機能するか

1. 自動認証:

   • ミニプログラムのユーザーがクラウド関数を呼び出すと、WeChat が自動的にユーザーの ID を注入します
   • 複雑な OAuth フローやトークン管理は不要です
   • CloudBase が ID の真正性を検証します

2. ユーザー識別子:

   • OPENID – この特定のミニプログラムにおけるユーザーの一意の識別子
   • APPID – ミニプログラムの App ID
   • UNIONID – (任意) 同じ WeChat オープンプラットフォームアカウント配下のすべてのアプリにまたがる一意の識別子
     • ミニプログラムが WeChat オープンプラットフォームアカウントに紐付けられている場合にのみ利用可能です
     • 複数のミニプログラムや公式アカウントにまたがって同一のユーザーを識別するのに役立ちます

3. セキュリティ:

   • openid、appid、unionid は検証済みで信頼できます
   • WeChat がすでに認証を完了しています
   • 開発者は追加の検証なしでこれらの識別子を直接使用できます

4. 明示的なログインは不要:

   • ユーザーはミニプログラムを使用すると自動的に認証されます
   • ほとんどの場合、ログイン API を呼び出す必要はありません
   • ID はクラウド関数ですぐに利用できます

---

拡張ガイド

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

リファレンスインデックス

パッケージ化されたすべてのリファレンスファイル (スキルの lint 到達可能性に必要):

• extended-guide.md