カスタム コネクタ
Azure Logic Apps、Microsoft Power Automate、Microsoft Power Apps には、Microsoft および検証済みサービスに接続するための 900 個のコネクタ 以上が用意されていますが、あらかじめ構築されているコネクタが利用できないサービスとの通信が必要になることもあります。 カスタム コネクタでは、独自のトリガーとアクションを備えたコネクタを作成 (さらには共有) できるようにすることで、このシナリオに対応しています。
Lifecycle
1. API をビルドする
カスタム コネクタは、REST API (Logic Apps は SOAP API もサポートします) のラッパーで、Logic Apps、Power Automate、または Power Apps に REST または SOAP API との通信を許可します。 これらの API は、次のようなものです。
- Spotify、Slack、Rackspace、またはユーザーが管理する API などのパブリック (パブリック インターネットで表示可能)。
- プライベート (ユーザーのネットワークでのみ表示可能)。
作成および管理する予定のパブリック API については、次の Microsoft Azure 製品のいずれかを使用することを検討してください。
プライベート API については、Microsoft は、オンプレミス データ ゲートウェイ を通じてオンプレミス データ接続を提供します。
2. API のセキュリティを確保する
標準的な認証方法のいずれかを使用して、API とコネクタをセキュリティで保護します (Azure Active Directory を推奨)。
- 汎用 OAuth 2.0
- 特定サービス向け OAuth 2.0 (Azure Active Directory (Azure AD)、Dropbox、GitHub、SalesForce など)
- 基本認証
- API キー
認証を実装する必要がないように、Azure portal で API に Azure AD 認証を設定できます。 または、API のコードで認証を要求し、強制できます。 カスタム コネクタ用の Azure AD の詳細については、Azure ADによる API とコネクタの保護に関するページをご覧ください。
3. API について記述し、カスタム コネクタを定義する
認証されたアクセスを持つ AP Iを取得したら、次に行うことは、Logic Apps、Power Automate、または Power Apps が API と通信できるように API を記述することです。 次のアプローチがサポートされています。
OpenAPI 定義 (以前の Swagger ファイル)
Postman コレクション
カスタム コネクタ ポータルを使用して最初から開始する (Power Automate および Power Apps のみ)
OpenAPI 概要と Postman コレクションはさまざまな形式を使用しますが、いずれも言語に依存せず、API を記述するコンピューター読み取り可能ドキュメントです。 これらのドキュメントは、API で使用される言語とプラットフォームに応じて、さまざまなツールで生成できます。 バックグラウンドでは、Logic Apps、Power Automate および Power Apps が OpenAPI を使いコネクタを定義します。
4. Logic Apps、 Power Automate、または Power Apps アプリでコネクタを使用する
カスタム コネクタは、Microsoft マネージド コネクタが使用されるのと同じ方法で使用されます。 API への接続を作成し、その接続を使用して、カスタム コネクタ内で公開している任意の操作を呼び出す必要があります。
Power Automate で作成されたコネクタは Power Apps で利用可能です。 同様に、Power Apps で作成されたコネクタは、Power Automate で使用できます。 これは、Logic Apps で作成されたコネクタには当てはまりません。 ただし、OpenAPI 定義または Postman コレクションを再利用し、サービスのいずれかでコネクタを再作成できます。 詳細については、適切なチュートリアルを参照してください。
5. 自分のコネクタの共有
Logic Apps、Power Automate、または Power Apps でリソースを共有するのと同じ方法で、組織内のユーザーとコネクタを共有できます。 共有はオプションですが、コネクタを他のユーザーと共有したい場合があります。
詳しくは、「組織でカスタム コネクタを共有する」をご覧ください。
6. 自分のコネクタを認定する
Logic Apps、Power Automate、Power Apps のすべてのユーザーとコネクタを共有する場合は、コネクタを Microsoft に送って認定を受けてください。 Microsoft では、コネクタをレビューし、技術とコンテンツのコンプライアンスを確認し、機能を検証します。
詳細については、「Microsoft の認定を受けるためにコネクタを提出する」を参照してください。
チュートリアル
チュートリアルでは Cognitive Services Text Analytics API を使用します。 Microsoft は、この API 用のコネクタをすでに提供しています。 これは、カスタム コネクタのライフサイクルや、カスタム コネクタがどのように独自のシナリオをサポートするかを教えるのに適した例です。
シナリオ
作成するコネクタでは、テキスト入力のセンチメント スコア (0.000 から 1.000) を返す テキスト分析 センチメント 操作を公開します。
前提条件
次のいずれかのサブスクリプション:
- Azure サブスクリプション (Logic Apps)
- Power Automate
- Power Apps
Logic Apps、Power Automate フロー、または Power Apps を作成する方法についての基本的な理解。
Cognitive Services Text Analytics API の API キー。
API キーを取得する
Text Analytics API は、API キーを使用してユーザーを認証します。 ユーザーがカスタム コネクタを介して API への接続を作成する場合、ユーザーはこのキーの値を指定します。 API キーを取得するには:
API キーを要求 して、API を試します。 これには、Azure サブスクリプションは必要ありません。
Azure サブスクリプションに Text Analytics APIを追加 します。 サブスクリプションで API リソースを取得したら、キーセクションから API キーを取得します。
チュートリアルを開始する
Logic Apps を使用している場合は、以下を参照してください:
Power Automate または Power Apps を使用している場合は、以下を参照してください:
詳細ガイダンス
このセクションのチュートリアルとビデオは、Power Platform コネクタを実装の一部として活用するために必要な分析情報を提供します。
チュートリアル
次のチュートリアルでは、特定のカスタム コネクタ シナリオについて詳しく説明します。
- OpenAPI 定義を拡張する
- カスタム コネクタ用に Postman コレクションを作成する
- Azure Active Directory を使用して認証する
- Web API 用のカスタム コネクタを作成する
- トリガーとして Webhook を使用する
- Logic Apps SOAP API コネクタを作成する
動画
次の 45 分間のビデオでは、Power Platform コネクタがどのように機能するかを示します。 また、単純なカスタム コネクタと詳細なカスタム コネクタを作成する方法も示します。
参照
フィードバックを提供する
コネクタ プラットフォームの問題点や新機能のアイデアなどのフィードバックをお待ちしています。 フィードバックを提供するには、「問題を送信するか、コネクタに関するヘルプを入手する」にアクセスし、フィードバックの種類を選択します。