カスタム コネクタのライフサイクルの概要
カスタム コネクタの作成を始める前に、カスタム コネクタのライフサイクルに含まれる各ステップに関するすべての詳細を知る必要があります。 次の図は、カスタム コネクタの作成と使用に関連するすべてのタスクを示したものです。
API を作成して保護する
カスタム コネクタは REST API のラッパーであり、基になるサービスが Power Apps、Power Automate、または Azure Logic Apps と通信できるようにします。 カスタム コネクタの作成を始める前に、API が完全に機能していることを確認してください。
REST API または SOAP API として利用できる限り、API には任意の言語とプラットフォームを使用できます。 次に次に例をいくつか示します。
NOAA、US Census API、EU Open Data Portal など、パブリックに利用可能な API。
自分で作成してクラウド ホスティング プロバイダー (Azure、Heroku、Google Cloud など) にデプロイした API。
非公開 API (自分のネットワークにのみ表示されます)。接続は、オンプレミス データ ゲートウェイ経由で可能になります。
お使いのネットワークにデプロイされているカスタム基幹業務 API。 API がパブリック インターネット上で公開されている場合、API に接続できます。または、ゲートウェイ (現在、Power Automate および Power Apps で利用できます) を介して接続できます。
Microsoft のテクノロジの場合、次のプラットフォームのいずれかを使用することをお勧めします。
API とコネクタをセキュリティで保護するために、標準的な認証方法のいずれかを使用できます (Microsoft Entra ID を推奨)。
特定サービス向け OAuth 2.0 (Microsoft Entra ID、Dropbox、GitHub、Salesforce など)
コードで認証を実装する必要がないように、Azure portal で API に Microsoft Entra ID 認証を設定できます。 必要な場合は、API のコードで認証を要求し、強制できます。 カスタム コネクタ用の Microsoft Entra ID の詳細は、Microsoft Entra ID による API とコネクタの保護について説明しているページで確認してください。
API について記述し、カスタム コネクタを定義する
API を用意した後、次のステップで検討することは、Power Apps、Power Automate、および Azure Logic Apps が API と通信できるように、API のインターフェイスとその操作を記述する方法です。 API の記述方法が決まったら、API を適切なサービスに登録するコネクタを作成します。
次のいずれかの方法を使用して API を記述します。
OpenAPI 定義 (以前の Swagger ファイル)。 詳細については、OpenAPI 定義からカスタム コネクタを作成すると Swagger とはを参照してください。
また、Power Apps と Power Automate でカスタム コネクタ ウィザードを使って、空のカスタム接続から始めることもできます。 詳細については、カスタム コネクタを一から作成するを参照してください。
OpenAPI 定義は使用する形式が異なりますが、言語に依存せず、コンピューターが読み取り可能なドキュメントに、API の処理とパラメーターが記述されます。 これらのドキュメントは、API で使用される言語とプラットフォームに応じて、さまざまなツールで生成できます。 バックグラウンドでは、Power Apps、Power Automate、Logic Apps で OpenAPI を使用し、コネクタが定義されています。
カスタム コネクタを使用する
組み込みコネクタを使う場合と同じ方法で、カスタム コネクタを使うことができます。 API への接続を作成し、組み込みコネクタの操作を呼び出すのと同じ方法で、API によって提供される操作を呼び出します。
Power Apps または Power Automate で作成されたコネクタは、どちらのサービスでも使うことができますが、Azure Logic Apps で作成されたコネクタは、他のサービスで直接使うことはできません。 ただし、Azure Logic Apps のコネクタの作成に使われたのと同じ OpenAPI 定義を使って、簡単にコネクタを作成し直すことができます。
Power Apps、Power Automate、Azure Logic Apps からのカスタム コネクタの使用に関する詳細については、以下を参照してください。
カスタム コネクタを共有する
Power Apps、Power Automate、Logic Apps でリソースを共有するのと同じ方法で、組織内の他のユーザーとコネクタを共有できます。 共有は任意ですが、コネクタを他のユーザーと共有する必要がある場合に便利です。 詳しくは、組織でカスタム コネクタを共有するをご覧ください。
カスタム コネクタを認定する
Power Apps、Power Automate、Logic Apps のすべてのユーザーとコネクタを共有する場合は、コネクタを Microsoft に送って認定を受けてください。 このプロセス中、Microsoft はコネクタをレビューし、技術およびコンテンツに関するコンプライアンスを確認して、機能を検証します。 詳細については、Microsoft の認定を受けるためにコネクタを提出するを参照してください。