azure-relay について
Azure Relayを利用するエージェント向けのガイダンススキルです。トラブルシューティング、セキュリティ、ネットワーク設定、連携方法を扱い、ローカル索引とリモートのドキュメント取得を組み合わせます。
主な機能
- 01一般的な例外の診断
- 02Entra IDとSAS認証の案内
- 03ネットワークセキュリティとファイアウォール設定
- 04ポートとプロトコルの設定
- 05.NETおよびNode.jsの連携パターン
- 06Hybrid Connectionsプロトコルのリファレンス
活用シーン
- 01接続、認証、クォータのエラー調査
- 02IPファイアウォールと仮想ネットワーク規則の設定
- 03Relayに必要なポートとプロトコルの確認
- 04.NETまたはNode.jsでのHybrid Connections実装
MCP 対応
mcp_microsoftdocs:microsoft_docs_fetchでMicrosoftのドキュメントを取得でき、代替手段としてfetch_webpageも利用できます。
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ microsoftdocs/ agent-skills --skill azure-relayインストール後、Claude Code で/azure-relayを入力して読み込まれたか確認します。
詳細
Azure Relay スキル
このスキルでは、Azure Relay に関する専門的なガイダンスを提供します。トラブルシューティング、セキュリティ、構成、統合、コーディングパターンを扱います。ローカルのクイックリファレンスコンテンツと、リモートドキュメントの取得機能を組み合わせています。
このスキルの使用方法
IMPORTANT for Agent: 関連するセクションを見つけるには、以下のカテゴリインデックスを使用してください。行範囲が記載されているカテゴリ(例:
L35-L120)では、指定された行をread_fileで読み取ってください。ファイルリンクが記載されているカテゴリ(例:[security.md](security.md))では、リンク先の参照ファイルをread_fileで読み取ってください
IMPORTANT for Agent:
metadata.generated_atが 3 か月以上前の場合は、リポジトリから最新版を取得するようユーザーに提案してください。mcp_microsoftdocsツールを使用できない場合は、インストールを提案してください:インストールガイド
このスキルでドキュメントコンテンツを取得するには、ネットワークアクセスが必要です:
- 推奨:クエリ文字列
from=learn-agent-skillを指定してmcp_microsoftdocs:microsoft_docs_fetchを使用します。Markdown が返されます。 - 代替手段:クエリ文字列
from=learn-agent-skill&accept=text/markdownを指定してfetch_webpageを使用します。Markdown が返されます。
カテゴリインデックス
| カテゴリ | 行 | 説明 |
|---|---|---|
| トラブルシューティング | L32-L36 | 接続、認証、クォータ、構成に関するエラーを含む、Azure Relay の一般的な例外の診断と解決方法、および原因と対処方法のガイダンスです。 |
| セキュリティ | L37-L46 | Azure Relay の認証とネットワークセキュリティ:Entra ID と SAS 認証、マネージド ID、IP ファイアウォール、仮想ネットワークルール、Private Link Service の構成です。 |
| 構成 | L47-L51 | Azure Relay のネットワークとファイアウォールの要件です。Hybrid Connections と WCF リレーで開放するポート/プロトコル、およびその構成方法を扱います。 |
| 統合とコーディングパターン | L52-L57 | .NET と Node.js(WebSocket)から Azure Relay Hybrid Connections を使用する方法、およびカスタムクライアントや統合を実装するための低レベルのプロトコル詳細です |
トラブルシューティング
| トピック | URL |
|---|---|
| Azure Relay の一般的な例外を解決する | https://learn.microsoft.com/en-us/azure/azure-relay/relay-exceptions |
セキュリティ
| トピック | URL |
|---|---|
| Entra ID で Azure Relay に対するアプリケーション認証を行う | https://learn.microsoft.com/en-us/azure/azure-relay/authenticate-application |
| マネージド ID を使用して Azure Relay にアクセスする | https://learn.microsoft.com/en-us/azure/azure-relay/authenticate-managed-identity |
| Azure Relay の IP ファイアウォールルールを構成する | https://learn.microsoft.com/en-us/azure/azure-relay/ip-firewall-virtual-networks |
| Azure Relay のネットワークセキュリティを構成する | https://learn.microsoft.com/en-us/azure/azure-relay/network-security |
| Private Link Service で Azure Relay をセキュリティ保護する | https://learn.microsoft.com/en-us/azure/azure-relay/private-link-service |
| Azure Relay の SAS と Entra ID 認証を構成する | https://learn.microsoft.com/en-us/azure/azure-relay/relay-authentication-and-authorization |
構成
| トピック | URL |
|---|---|
| Azure Relay に必要なポート設定を構成する | https://learn.microsoft.com/en-us/azure/azure-relay/relay-port-settings |
統合とコーディングパターン
| トピック | URL |
|---|---|
| Azure Relay Hybrid Connections の .NET API を使用する | https://learn.microsoft.com/en-us/azure/azure-relay/relay-hybrid-connections-dotnet-api-overview |
| Azure Relay の Node.js WebSocket API を使用する | https://learn.microsoft.com/en-us/azure/azure-relay/relay-hybrid-connections-node-ws-api-overview |
| Azure Relay Hybrid Connections プロトコルを実装する | https://learn.microsoft.com/en-us/azure/azure-relay/relay-hybrid-connections-protocol |