Azure Logic Apps には、Microsoft Power Automate、Microsoft Power Apps が マイクロソフトや検証済みサービスに接続するための 1,000 以上のコネクタ が用意されていますが、Microsoft Copilot Studio はこれらのあらかじめ構築されたコネクタを使用できます。あらかじめ構築されているコネクタが利用できないサービスとの通信をすることもあります。 カスタム コネクタでは、独自のトリガーとアクションを備えたコネクタを作成 (さらには共有) できるようにすることで、このシナリオに対応しています。
Lifecycle
1. API をビルドする
カスタム コネクタは、Logic Apps、Power Automate、Power Apps、または Copilot Studio がその REST や SOAP API との通信を可能する REST API のラッパーです。 これらの API は、次のようなものです。
- Spotify、Slack、Rackspace、またはユーザーが管理する API などのパブリック (パブリック インターネットで表示可能)。
- プライベート (ユーザーのネットワークでのみ表示可能)。
Logic Apps は SOAP API もサポートしています。
作成および管理する予定のパブリック API については、次の Microsoft Azure 製品のいずれかを使用することを検討してください。
プライベート API については、Microsoft は、オンプレミス データ ゲートウェイ を通じてオンプレミス データ接続を提供します。
2. API のセキュリティを確保する
API とコネクタに標準的な認証方法のいずれかを使用します (Microsoft Entra ID を推奨):
- 汎用 OAuth 2.0
- Microsoft Entra ID、Dropbox、GitHub、SalesForce などの特定サービスの OAuth 2.0
- 基本認証
- API キー
認証を実装する必要がないように、Azure portal で API に Microsoft Entra ID 認証を設定できます。 または、API のコードで認証を要求し、強制できます。 カスタム コネクタ用の Microsoft Entra ID の詳細については、Microsoft Entra ID による API とコネクタの保護 を参照してください。
2.1. OAuth 2.0
OAuth 2.0 を使用して自動的に認証する新しく作成されたカスタム コネクタには、コネクタごとのリダイレクト URI があります。 既存の OAuth 2.0 コネクタは、2024 年 2 月 17 日までにコネクタごとのリダイレクト URI を使用するように更新する必要があります。
- Web インターフェースを使用してカスタム コネクタを作成した場合は、カスタム コネクタを編集し、セキュリティ タブに移動して、一意のリダイレクト URL に更新 のチェックボックスをオンにし、コネクタごとのリダイレクト URI を有効にします。
-
コマンド ライン インターフェイス (CLI) を使用した複数認証 でカスタム コネクタを作成した場合は、CLI ツールを使用してコネクタを更新して
"redirectMode": "GlobalPerConnector"を設定する必要があります。 - カスタム コネクタが セキュリティ タブの設定または CLI ツールを使用してコネクタごとのリダイレクト URI を使用するように更新されたら、 OAuth 2.0 アプリからグローバル リダイレクト URI を削除します。 新しく生成された一意のリダイレクト URL を OAuth 2.0 アプリに追加する必要があります。
- この更新プログラムは、2024 年 2 月 17 日から既存の OAuth 2.0 カスタム コネクタに適用されます。 コネクタごとのリダイレクト URI を使用するように更新されていないカスタム コネクタは、新しい接続の機能を停止し、ユーザーにエラー メッセージを表示します。
- コネクタごとのリダイレクト URL に移行するために更新が必要なカスタム コネクタを見つけるには、管理コネクタ用 Power Apps の カスタム コネクタを管理者として取得 アクションを使用するフローを作成し、その結果を解析します。 この記事の後半で添付するフローでは、同じものを使用してすべてのカスタム コネクタを取得します。 次に、接続パラメーターのプロパティに フィルター 条件を適用して非 Oauth カスタム コネクタを フィルター し、さらに別の フィルター を適用して、コネクタごとの一意のリダイレクト URL を使用しないコネクタのみを選択します。 最後に、選択したカスタム コネクタをフローの最初で初期化された配列変数に配置し、それらのコネクタの名前と作成者を示す HTML テーブルを生成します。 このソリューション をインポートして、このフローを環境にインポートできます。 フローをさらに拡張して、HTML テーブルを電子メールとして自分に送信できます。 または、コネクタ作成者に直接メールを送信し、更新する必要があるコネクタの名前を提供するように拡張することもできます。
3. API について記述し、カスタム コネクタを定義する
認証されたアクセスを持つ API を取得したら、次に行うことは、Logic Apps、Power Automate、Power Apps、または Copilot Studio が API と通信できるように API を記述することです。 次のアプローチがサポートされています。
OpenAPI 定義 (以前の Swagger ファイル)
Postman コレクション
カスタム コネクタ ポータルを使用して最初から開始する (Power Automate および Power Apps のみ)
OpenAPI 概要と Postman コレクションはさまざまな形式を使用しますが、いずれも言語に依存せず、API を記述するコンピューター読み取り可能ドキュメントです。 これらのドキュメントは、API で使用される言語とプラットフォームに応じて、さまざまなツールで生成できます。 バックグラウンドでは、Logic Apps、Power Automate、Power Apps、および Copilot Studio が OpenAPI を使いコネクタを定義します。
4. Copilot Studio、Logic Apps、Power Automate、または Power Apps アプリでコネクタを使用する
カスタム コネクタは、既成のコネクタと同じように使用されます。 API への接続を作成し、その接続を使用して、カスタム コネクタ内で公開している任意の操作を呼び出す必要があります。
Power Automateで作成されたコネクタは Power Apps や Copilot Studio で使用可能で、Power Apps で作成されたコネクタは Power Automate と Copilot Studio で使用できます。 この可用性は、Logic Apps で作成されたコネクタには当てはまりません。 ただし、OpenAPI 定義または Postman コレクションを再利用し、サービスのいずれかでコネクタを再作成できます。 詳細については、適切なチュートリアルを参照してください。
チップ
API のフィールドを更新 (削除、追加、または変更) する場合は、次の手順を実行します。
- コネクタを再公開して、更新された API の Swagger を参照するようにします。
- そのコネクタを使用していたすべてのアプリの接続/データ ソースをすべて削除します。
- そのコネクタの接続/データ ソースをアプリに再度追加します。
5. 自分のコネクタの共有
Copilot Studio、Logic Apps、Power Automate、または Power Apps でリソースを共有するのと同じ方法で、組織内のーザーとコネクタを共有できます。 共有はオプションですが、コネクタを他のユーザーと共有したい場合があります。
詳細については、組織でカスタム コネクタを共有する をご覧ください。
6. 自分のコネクタを認定する
Copilot Studio、Logic Apps、Power Automate、Power Apps のすべてのユーザーとコネクタを共有する場合は、Microsoft 認定を受けるためにコネクタを提出する必要があります。 マイクロソフトは、コネクタをレビューし、技術とコンテンツのコンプライアンスを確認し、機能を検証します。
Virtual Network のサポート
Virtual Network にリンクされた Power Platform 環境でコネクタが使用されている場合、次の制限が適用されます。
カスタム コードを使用する際の、制限については、カスタム コネクタでのコードの書き込み で説明されています。
環境が仮想ネットワークに関連付けられる前に作成されたカスタム コネクタは、再保存する必要があります。
カスタム コネクタにコールバックしないロケーションヘッダーを返すトリガーはサポートされていません。
フィードバックを提供する
コネクタ プラットフォームの問題点や新機能のアイデアなど、フィードバックをお待ちしています。 フィードバックを提供するには、「問題を送信するか、コネクタに関するヘルプを入手する」にアクセスし、フィードバックの種類を選択します。