次の方法で共有


Service Connector を使用して Azure Functions をサービスに接続する方法

Azure Functions は、Service Connector でサポートされているコンピューティング サービスの 1 つです。 バインドを使用して Azure Functions を他のサービスと接続することをお勧めしますが、クライアント SDK を使用することもできます。 この記事は、次の内容を理解するのに役立ちます。

  • Service Connector と Functions のバインド間の関係。
  • バインドまたは SDK を使用して Functions を他の Azure サービスに接続するために Service Connector によって使用されるプロセス。
  • 各シナリオで Service Connector とユーザーがそれぞれ担う責任。

前提条件

Service Connector と Azure Functions のバインド

Azure Functions のバインド

バインドは Azure Functions で使用される概念であり、関数コードでクライアント SDK を操作することなく、サービスに関数を接続する簡単な方法を提供することを目的としています。

バインドでは、入力、出力、トリガーをサポートできます。 バインディングを使うと、Functions ホストがデータ アクセスを自動処理できるようにサービスへの接続を構成できます。 詳細については、「Azure Functions でのトリガーとバインドの概念」を参照してください。

関数バインドでは、シークレット/接続文字列認証の種類と ID ベースの認証の種類の両方がサポートされます。

Service Connector

Service Connector は、開発者がコンピューティング サービスをターゲット バッキング サービスに簡単に接続するのに役立つ Azure サービスです。 Azure Functions は、Service Connector でサポートされているコンピューティング サービスの 1 つです

Service Connector は、論理的に抽象化された概念に似た関数バインドと比較して、直接操作できる Azure サービスです。 これは、接続のライフサイクル全体に API を提供します 。たとえばcreatedeletevalidate、正常性と list configurations.

Service Connector では、シークレット/接続文字列認証の種類と ID ベースの認証の種類の両方もサポートされます。

Azure Functions バインドでの接続

Functions バインドでは、 connection 関数フォルダー内のバインド ファイル (通常はファイル) で定義されている function.json プロパティです。 これは、ターゲット サービスに対する認証にバインド ランタイムによって使用されるアプリ設定の名前またはプレフィックスを定義します。

Service Connector での接続

connection In Service Connector は、Service Connector に属する特定の Azure リソースを指します。

Azure Functions バインドによって使用されるバインドは connection 、Service Connector で使用されるバインドに configuration name 対応します。 構成名は、Service Connect がコンピューティング サービスの構成に保存するアプリ設定キー名を指します。

Service Connector を使用して Azure Functions を他のクラウド サービスに接続する

Service Connector を使用すると、バインドまたは SDK を使用して Azure Functions をクラウド サービスに接続するために必要な作業量が削減されます。 アプリ 設定、ネットワーク、ID、アクセス許可の割り当てなどのクラウド リソース構成を引き継ぎ、ユーザーが機能ビジネス ロジックに集中できるようにします。 次のセクションでは、Service Connector を使用して、さまざまな接続メカニズムと認証方法を使用して関数接続を簡略化する方法について説明します。

バインド

  • シークレット/接続文字列
シナリオ 操作 説明 サービス コネクタなし Service Connector を使用する
ローカル プロジェクト バインドの追加 ターゲット サービスの種類とバインドの種類 (in/out/trigger) に従って、関数にバインドを追加します。 User User
バインドを使用する 認証の接続文字列を設定し、バインドでlocal.settings.json定義されている変数を使用するように関数コードを変更します。 User User
クラウド リソース アプリケーションの設定の構成 関数リソースの構成でアプリ設定として接続文字列を構成します。 User Service Connector
ネットワークを構成する ターゲット サービスのネットワーク構成で関数リソースからのアクセスが許可されていることを確認します。 User Service Connector
  • ID ベースの認証
シナリオ 操作 説明 サービス コネクタなし Service Connector を使用する
ローカル プロジェクト バインドの追加 ターゲット サービスの種類とバインドの種類 (in/out/trigger) に従って、関数にバインドを追加します。 User User
バインドを使用する 認証の接続文字列を設定し、バインドでlocal.settings.json定義されている変数を使用するように関数コードを変更します。 User User
クラウド リソース アプリケーションの設定の構成 サービス エンドポイントなど、Azure 関数の ID 設定を構成します。 User Service Connector
ネットワークを構成する ターゲット サービスのネットワーク構成で関数リソースからのアクセスが許可されていることを確認します。 User Service Connector
ID の構成 システム ID を使用して認証する場合は、システム ID が有効になっていることを確認します。 User Service Connector
アクセス許可の割り当て ターゲット サービスにアクセスできるように、ID に必要なロールを割り当てます。 User Service Connector

関数バインドで Service Connector を使用する場合は、Service Connector によって構成された関数のキー名に特に注意してください。 バインド ファイルのプロパティで connection 定義されているキー名と同じキー名であることを確認します。 異なる場合は、バインド ファイルの名前を変更するか、Service Connector の customize keys 機能を使用して Service Connector の既定の構成名をカスタマイズ します

SDK

  • シークレット/接続文字列
シナリオ 操作 説明 サービス コネクタなし Service Connector を使用する
ローカル プロジェクト 依存関係を追加する ターゲット サービスとランタイムに従って依存関係パッケージを追加します。 User User
SDK クライアントの開始 で認証local.settings.jsonの接続文字列を設定します。 接続文字列を使用してターゲット サービス SDK を開始します。 User User
クラウド リソース アプリケーションの設定の構成 関数の構成でアプリ設定として接続文字列を構成します。 User Service Connector
ネットワークを構成する ターゲット サービスのネットワーク構成で関数リソースからのアクセスが許可されていることを確認します。 User Service Connector
  • ID ベースの認証
シナリオ 操作 説明 サービス コネクタなし Service Connector を使用する
ローカル プロジェクト 依存関係を追加する ターゲット サービスとランタイムに従って依存関係パッケージを追加します。 User User
SDK クライアントの開始 で認証local.settings.jsonの接続文字列を設定します。 接続文字列を使用してターゲット サービス SDK を開始します。 User User
クラウド リソース アプリケーションの設定の構成 関数の構成でアプリ設定として接続文字列を構成します。 User Service Connector
ネットワークを構成する ターゲット サービスのネットワーク構成で関数リソースからのアクセスが許可されていることを確認します。 User Service Connector
ID の構成 システム ID を使用して認証する場合は、システム ID が有効になっていることを確認します。 User Service Connector
アクセス許可の割り当て ターゲット サービスにアクセスできるように、ID に必要なロールを割り当てます。 User Service Connector

次のステップ

さまざまなターゲット サービスを統合し、その構成設定と認証方法について確認する方法について説明します。