導入
このモジュールでは、カスタム コネクタについて検討し、それらを Microsoft Power Apps、Microsoft Power Automate、および Microsoft Azure Logic Apps で構成して使用する方法について説明します。
このモジュールの内容は次のとおりです。
カスタム コネクタの役割について学習する。
コネクタを構築し、Power Automate フロー内で使用する。
コネクタを使用すると、アプリおよびフローの作成者は、次の方法でクラウド内の他のアプリ、データ、およびデバイスに簡単に接続できます。
接続は、作成者が検索できる一貫した反復可能な方法で行われます。
コネクタには、操作が行われる際に作成者が制御できるアクションがあります。
コネクタには、トリガー イベントが発生したときに自動化を開始できるトリガーがあります。
コネクタは、Power Automate、Power Apps と Logic Apps を基になるサービスと通信可能にする API のプロキシまたはラッパーです。 多くのコネクタは事前に定義されており、何も定義しなくても使用できます。 これらの組み込みコネクタ定義には、Microsoft などのサービスが含まれます。 使用するサービスまたは API に事前構築済みのコネクタがない場合、独自のカスタム コネクタを構築できます。 事前構築済みのコネクタでは API から必要なすべてのトリガーとアクションを公開されない場合、これらの追加要件を処理するために、使用可能なコネクタに追加してカスタム コネクタを構築できます。 カスタム コネクタを定義すると、組み込みコネクタと同様に、その環境内でアプリやフローを構築する際にカスタム コネクタの使用が可能になります。
API の識別または構築
最初のタスクは、コネクタの参照 を確認して、API/サービスに適切なコネクタが既に存在するかどうかを判断することです。 適切なコネクタが存在しない場合は、独自のカスタム コネクタを構築できます。 パブリック (インターネットで使用できる) またはプライベート (ユーザーの内部ネットワークのみ) で REST API を記述するカスタム コネクタを定義できます。 プライベート API では、内部リソースにアクセスするために、オンプレミス データ ゲートウェイ が必要です。
互換性のある API が存在しない場合、開発者は Microsoft Azure Functions や Azure App Service など、REST API をホストできる任意のテクノロジを使用して API を構築できます。 また、Azure API Management を使用して、API の管理機能とガバナンスを強化できます。
API の記述
Power Apps および Power Automate でどのトリガーおよびアクションを API から利用できるかを知るには、カスタム コネクタを構築する際にそれらを識別する必要があります。 このタスクを実行するには、メーカー ポータルでコネクタ定義を手動で編集するか、サポートされている形式で定義をインポートします。 このプロセスには、API の認証要件の識別が含まれます。
コネクタの使用
環境内でカスタム コネクタを構築すると、それらのコネクタは組み込みコネクタと同じ方法で使用することができます。 これらのコネクタは、構築に使用した環境以外の環境でも使用できます。 コネクタ定義は、作成された環境からエクスポートした後、それを必要とする環境にインポートする必要があります。 そのコネクタを他の人々と共有して、他の共有リソースと同様に使用可能にすることもできます。
オープンソースとしてコネクタを認定および共有する
カスタム コネクタは、定義が存在する環境でのみ使用できるため、他の Microsoft の顧客はそれらを使用できません。 カスタム コネクタ定義をオープンソースとして共有することで、GitHub での利用が可能になり、他の顧客が自分の環境にインポートすることができます。 コネクタを認定することで、作成したカスタム コネクタをすべての顧客環境で事前構築済みのコネクタとして利用可能にできます。 コネクタの認定には、API を所有しているか、API 所有者からコネクタを公開するための明示的なアクセス許可を得ている必要があります。
詳細については、認定プロセス を参照してください。
プロセスのこのステップはオプションであり、コネクタを共有し、認定済みとして記載する場合にのみ必要です。 内部向けコネクタは、この認定プロセスを完了する必要はありません。
コネクタの記述
コネクタのアクションおよびトリガーを定義するには、コネクタを記述する必要があります。 カスタム コネクタは、必要な API トリガーとアクションだけを記述することで定義できます。 たとえば、API に 100 個のアクションと 10 個のトリガーが用意されている場合は、単一のアクションでカスタム コネクタを作成できます。 変更が必要になれば、後で記述することもできます。
API を記述する際は、次のアプローチの少なくとも 1 つを使用します。 OpenAPI 定義をインポートする場合、ポータルでコネクタの定義を引き続き手動で操作できます。
ポータルに手動で作成する - このアプローチを使用する場合、API ドキュメントと入力および出力の例を使用して、それぞれのアクションとトリガーを定義します。 このアプローチは、定義をインポートできないシンプルな API に適しています。 このアプローチを使用して、インポート後に定義を調整することもできます。
OpenAPI 定義をインポートする - OpenAPI は、REST を記述する仕様で、関連付けられているすべてのリソースと操作を効果的にマッピングすることで、API を開発および使用するタスクを簡素化します。 多くのサービス/API では OpenAPI 定義が公開されており、カスタム コネクタで API を記述するためにインポートすることができます。 バージョン 2.0 のインポートはサポート対象ですが、バージョン 3.0 は現在のサポート対象ではありません。 このアプローチは、API の公開元から OpenAPI 定義を入手できる場合に役立ちます。また、API を開発している場合は、定義を公開できます。
GitHub からインポートする - コネクタを Power Platform コネクタ リポジトリからインポートします。 これは、リポジトリにコネクタが既に公開されており、そのコネクタを変更する場合、またはカスタム コネクタとして使用する場合に最適なアプローチです。
Azure からエクスポートする - API が Azure App Service や Microsoft Azure Functions として構築されている場合、または Microsoft Azure API Management で管理されている場合、ユーザーはそれらのサービスから API エクスポートし、最初のカスタム コネクタ定義を自動的に作成できます。
認証済み API を使用する
カスタム コネクタ アーキテクチャは、認証済み API の使用をサポートしています。 カスタム コネクタを定義する場合、API に対する認証方法を指定します。 認証の選択肢では、匿名、パスワード保護、OAuth 2.0、および API キー アクセスがサポートされています。
認証なし - この選択肢は、匿名アクセスを許可する API 用であり、ユーザーが特定の認証タイプを構成しない場合の既定値です。
基本認証 - この選択肢は、各要求に対してユーザーとパスワードが送信されることを必要とする API 用です。
OAuth 2.0 - OAuth 2.0 は認証のための業界標準プロトコルです。 この選択肢は、OAuth 2.0 を使用する任意の API 用に構成できます。 Microsoft Entra ID、GitHub、および Azure DevOps などの Microsoft サービス用にユーザーが選択できる事前構築済みの構成を使用できます。 Dropbox、Slack、Stripe などのその他サービスには、同様の事前構築済みの構成を使用できます。 事前構築済みの構成は、ID プロバイダーの構成に指定が必要なものを簡略化します。
API キー - API キーは、API を呼び出す際にクライアントが提供するトークンです。 通常、API の公開元がキーを提供し、キーはカスタム コネクタからの各要求に含まれている必要があります。
カスタム コネクタは、アプリおよびフロー作成者が API/サービスを簡単に使用するのに役立ちます。 ほとんどの場合、作成者は、コネクタを使用せずに API を直接呼び出します。ただし、作成者は要求の作成、結果の解釈および認証の処理方法について理解する必要があります。 このプロセスは、アプリまたはフローでカスタム コネクタが使用される度に完了する必要があります。
また、イベントによって開始されるようにフローを有効にするトリガーを含むカスタム コネクタを用意する能力レベルに到達することは、作成者にとって必ずしも容易ではありません。 カスタム コネクタを使用すると、コネクタを使ってアプリやフローを構築するときに、アクションとその結果を使用する方法を簡単に見つけることができます。
次のユニットでは、カスタム コネクタの作成方法について説明します。