サービスコネクタを使用して Azure App Configuration を統合する

[アーティクル]
02/06/2024

このページでは、サポートされている認証方法とクライアントを示し、Service Connector を使用して Azure App Configuration を他のクラウドサービスに接続するために使用できるサンプルコードを示します。引き続き他のメソッドを使用して App Configuration に接続できる場合があります。このページには、サービス接続を作成するときに取得する既定の環境変数の名前と値も示されています。

サポートされているコンピューティングサービス

Service Connector を使用して、次のコンピューティングサービスを Azure アプリ Configuration に接続できます。

Azure App Service
Azure Functions
Azure Container Apps
Azure Spring Apps

サポートされている認証の種類とクライアントの種類

次の表は、Service Connector を使用してコンピューティングサービスを Azure アプリ Configuration に接続するためにサポートされている認証方法とクライアントの組み合わせを示しています。 "はい" は組み合わせがサポートされていることを示し、"いいえ" はサポートされていないことを示します。

クライアントタイプ	システム割り当てマネージド ID	ユーザー割り当てマネージド ID	シークレット/接続文字列	サービスプリンシパル
.NET	はい	イエス	イエス	はい
Java	はい	イエス	イエス	はい
Node.js	はい	イエス	イエス	はい
Python	はい	イエス	イエス	はい
なし	有効	イエス	イエス	はい

この表は、表内のクライアント・タイプと認証方法のすべての組み合わせがサポートされていることを示しています。すべてのクライアントの種類では、任意の認証方法を使用して、Service Connector を使用して Azure アプリ Configuration に接続できます。

デフォルトの環境変数の名前またはアプリケーションのプロパティとサンプルコード

下の接続の詳細を使用して、コンピューティングサービスを Azure App Configuration ストアに接続します。名前付け規則の詳細については、Service Connector の内部の記事を参照してください。

システム割り当てマネージド ID

既定の環境変数名	説明	サンプルの値
AZURE_APPCONFIGURATION_ENDPOINT	App Configuration のエンドポイント	`https://<App-Configuration-name>.azconfig.io`

サンプルコード

次のステップとコードへ参照して、システム割り当てマネージド ID を使用してAzure App Configurationに接続します。

依存関係をインストールします。

dotnet add package Microsoft.Extensions.Configuration.AzureAppConfiguration
dotnet add package Azure.Identity

Azure.Identity を使用して認証し、Service Connector によって追加された環境変数から Azure App Configuration エンドポイントを取得します。次のコードを使用する場合は、使用する認証型のコードスニペットの一部をコメント解除します。

using Azure.Identity;
using Microsoft.Extensions.Configuration;
using Microsoft.Extensions.Configuration.AzureAppConfiguration;

string endpoint = Environment.GetEnvironmentVariable("AZURE_APPCONFIGURATION_ENDPOINT");

// Uncomment the following lines corresponding to the authentication type you want to use.
// system-assigned managed identity
// var credential = new DefaultAzureCredential();

// user-assigned managed identity
// var credential = new DefaultAzureCredential(
//     new DefaultAzureCredentialOptions
//     {
//         ManagedIdentityClientId = Environment.GetEnvironmentVariable("AZURE_APPCONFIGURATION_CLIENTID");
//     });

// service principal 
// var tenantId = Environment.GetEnvironmentVariable("AZURE_APPCONFIGURATION_TENANTID");
// var clientId = Environment.GetEnvironmentVariable("AZURE_APPCONFIGURATION_CLIENTID");
// var clientSecret = Environment.GetEnvironmentVariable("AZURE_APPCONFIGURATION_CLIENTSECRET");
// var credential = new ClientSecretCredential(tenantId, clientId, clientSecret);

var client = new ConfigurationClient(new Uri(endpoint), credential);

pom.xml ファイルに次の依存関係を追加します。

<dependency>
    <groupId>com.azure</groupId>
    <artifactId>azure-data-appconfiguration</artifactId>
    <version>1.4.9</version>
</dependency>
<dependency>
    <groupId>com.azure</groupId>
    <artifactId>azure-identity</artifactId>
    <version>1.1.5</version>
</dependency>

azure-identity を使用して認証し、Service Connector によって追加された環境変数から Azure App Configuration エンドポイントを取得します。次のコードを使用する場合は、使用する認証型のコードスニペットの一部をコメント解除します。

// Uncomment the following lines corresponding to the authentication type you want to use.
// for system-managed identity
// DefaultAzureCredential defaultCredential = new DefaultAzureCredentialBuilder().build();

// for user-assigned managed identity
// DefaultAzureCredential defaultCredential = new DefaultAzureCredentialBuilder()
//     .managedIdentityClientId(System.getenv("AZURE_APPCONFIGURATION_CLIENTID"))
//     .build();

// for service principal
// ClientSecretCredential defaultCredential = new ClientSecretCredentialBuilder()
//   .clientId(System.getenv("AZURE_APPCONFIGURATION_CLIENTID"))
//   .clientSecret(System.getenv("AZURE_APPCONFIGURATION_CLIENTSECRET"))
//   .tenantId(System.getenv("AZURE_APPCONFIGURATION_TENANTID"))
//   .build();

String endpoint = System.getenv("AZURE_APPCONFIGURATION_ENDPOINT");

ConfigurationClient configurationClient = new ConfigurationClientBuilder()
    .credential(credential)
    .endpoint(endpoint)
    .buildClient();

依存関係をインストールします。

pip install azure-appconfiguration
pip install azure-identity

import os
from azure.appconfiguration import AzureAppConfigurationClient
from azure.identity import ManagedIdentityCredential, ClientSecretCredential

# Uncomment the following lines corresponding to the authentication type you want to use.
# system-assigned managed identity
# cred = ManagedIdentityCredential()

# user-assigned managed identity
# managed_identity_client_id = os.getenv('AZURE_APPCONFIGURATION_CLIENTID')
# cred = ManagedIdentityCredential(client_id=managed_identity_client_id)

# service principal
# tenant_id = os.getenv('AZURE_APPCONFIGURATION_TENANTID')
# client_id = os.getenv('AZURE_APPCONFIGURATION_CLIENTID')
# client_secret = os.getenv('AZURE_APPCONFIGURATION_CLIENTSECRET')
# cred = ClientSecretCredential(tenant_id=tenant_id, client_id=client_id, client_secret=client_secret)

endpoint_url = os.getenv('AZURE_APPCONFIGURATION_ENDPOINT')

client = AzureAppConfigurationClient(base_url="your_endpoint_url", credential=credential)

依存関係をインストールします。

npm install --save @azure/identity
npm install @azure/app-configuration

@azure/identity を使用して認証し、Service Connector によって追加された環境変数から Azure App Configuration エンドポイントを取得します。次のコードを使用する場合は、使用する認証型のコードスニペットの一部をコメント解除します。

import { DefaultAzureCredential,ClientSecretCredential } from "@azure/identity";
const appConfig = require("@azure/app-configuration");

// Uncomment the following lines corresponding to the authentication type you want to use.
// for system-assigned managed identity
// const credential = new DefaultAzureCredential();

// for user-assigned managed identity
// const clientId = process.env.AZURE_APPCONFIGURATION_CLIENTID;
// const credential = new DefaultAzureCredential({
//     managedIdentityClientId: clientId
// });

// for service principal
// const tenantId = process.env.AZURE_APPCONFIGURATION_TENANTID;
// const clientId = process.env.AZURE_APPCONFIGURATION_CLIENTID;
// const clientSecret = process.env.AZURE_APPCONFIGURATION_CLIENTSECRET;
// const credential = new ClientSecretCredential(tenantId, clientId, clientSecret);

const endpoint = process.env.AZURE_APPCONFIGURATION_ENDPOINT;

const client = new appConfig.AppConfigurationClient(
    endpoint,
    credential
);

ユーザー割り当てマネージド ID

既定の環境変数名	説明	サンプルの値
AZURE_APPCONFIGURATION_ENDPOINT	App Configuration のエンドポイント	`https://App-Configuration-name>.azconfig.io`
AZURE_APPCONFIGURATION_CLIENTID	クライアント ID	`<client-ID>`

サンプルコード

次のステップとコードへ参照して、ユーザー割り当てマネージド ID を使用してAzure App Configurationに接続します。

依存関係をインストールします。

dotnet add package Microsoft.Extensions.Configuration.AzureAppConfiguration
dotnet add package Azure.Identity

using Azure.Identity;
using Microsoft.Extensions.Configuration;
using Microsoft.Extensions.Configuration.AzureAppConfiguration;

string endpoint = Environment.GetEnvironmentVariable("AZURE_APPCONFIGURATION_ENDPOINT");

// Uncomment the following lines corresponding to the authentication type you want to use.
// system-assigned managed identity
// var credential = new DefaultAzureCredential();

// user-assigned managed identity
// var credential = new DefaultAzureCredential(
//     new DefaultAzureCredentialOptions
//     {
//         ManagedIdentityClientId = Environment.GetEnvironmentVariable("AZURE_APPCONFIGURATION_CLIENTID");
//     });

// service principal 
// var tenantId = Environment.GetEnvironmentVariable("AZURE_APPCONFIGURATION_TENANTID");
// var clientId = Environment.GetEnvironmentVariable("AZURE_APPCONFIGURATION_CLIENTID");
// var clientSecret = Environment.GetEnvironmentVariable("AZURE_APPCONFIGURATION_CLIENTSECRET");
// var credential = new ClientSecretCredential(tenantId, clientId, clientSecret);

var client = new ConfigurationClient(new Uri(endpoint), credential);

pom.xml ファイルに次の依存関係を追加します。

<dependency>
    <groupId>com.azure</groupId>
    <artifactId>azure-data-appconfiguration</artifactId>
    <version>1.4.9</version>
</dependency>
<dependency>
    <groupId>com.azure</groupId>
    <artifactId>azure-identity</artifactId>
    <version>1.1.5</version>
</dependency>

// Uncomment the following lines corresponding to the authentication type you want to use.
// for system-managed identity
// DefaultAzureCredential defaultCredential = new DefaultAzureCredentialBuilder().build();

// for user-assigned managed identity
// DefaultAzureCredential defaultCredential = new DefaultAzureCredentialBuilder()
//     .managedIdentityClientId(System.getenv("AZURE_APPCONFIGURATION_CLIENTID"))
//     .build();

// for service principal
// ClientSecretCredential defaultCredential = new ClientSecretCredentialBuilder()
//   .clientId(System.getenv("AZURE_APPCONFIGURATION_CLIENTID"))
//   .clientSecret(System.getenv("AZURE_APPCONFIGURATION_CLIENTSECRET"))
//   .tenantId(System.getenv("AZURE_APPCONFIGURATION_TENANTID"))
//   .build();

String endpoint = System.getenv("AZURE_APPCONFIGURATION_ENDPOINT");

ConfigurationClient configurationClient = new ConfigurationClientBuilder()
    .credential(credential)
    .endpoint(endpoint)
    .buildClient();

依存関係をインストールします。

pip install azure-appconfiguration
pip install azure-identity

import os
from azure.appconfiguration import AzureAppConfigurationClient
from azure.identity import ManagedIdentityCredential, ClientSecretCredential

# Uncomment the following lines corresponding to the authentication type you want to use.
# system-assigned managed identity
# cred = ManagedIdentityCredential()

# user-assigned managed identity
# managed_identity_client_id = os.getenv('AZURE_APPCONFIGURATION_CLIENTID')
# cred = ManagedIdentityCredential(client_id=managed_identity_client_id)

# service principal
# tenant_id = os.getenv('AZURE_APPCONFIGURATION_TENANTID')
# client_id = os.getenv('AZURE_APPCONFIGURATION_CLIENTID')
# client_secret = os.getenv('AZURE_APPCONFIGURATION_CLIENTSECRET')
# cred = ClientSecretCredential(tenant_id=tenant_id, client_id=client_id, client_secret=client_secret)

endpoint_url = os.getenv('AZURE_APPCONFIGURATION_ENDPOINT')

client = AzureAppConfigurationClient(base_url="your_endpoint_url", credential=credential)

依存関係をインストールします。

npm install --save @azure/identity
npm install @azure/app-configuration

import { DefaultAzureCredential,ClientSecretCredential } from "@azure/identity";
const appConfig = require("@azure/app-configuration");

// Uncomment the following lines corresponding to the authentication type you want to use.
// for system-assigned managed identity
// const credential = new DefaultAzureCredential();

// for user-assigned managed identity
// const clientId = process.env.AZURE_APPCONFIGURATION_CLIENTID;
// const credential = new DefaultAzureCredential({
//     managedIdentityClientId: clientId
// });

// for service principal
// const tenantId = process.env.AZURE_APPCONFIGURATION_TENANTID;
// const clientId = process.env.AZURE_APPCONFIGURATION_CLIENTID;
// const clientSecret = process.env.AZURE_APPCONFIGURATION_CLIENTSECRET;
// const credential = new ClientSecretCredential(tenantId, clientId, clientSecret);

const endpoint = process.env.AZURE_APPCONFIGURATION_ENDPOINT;

const client = new appConfig.AppConfigurationClient(
    endpoint,
    credential
);

接続文字列

既定の環境変数名	説明	サンプルの値
AZURE_APPCONFIGURATION_CONNECTIONSTRING	App Configuration の接続文字列	`Endpoint=https://<App-Configuration-name>.azconfig.io;Id=<ID>;Secret=<secret>`

サンプルコード

次のステップとコードへ参照して、接続文字列を使用してAzure App Configurationに接続します。

依存関係をインストールします。

dotnet add package Microsoft.Extensions.Configuration.AzureAppConfiguration

Service Connector によって追加された環境変数からそのApp Configuration接続文字列を取得します。

using Microsoft.Extensions.Configuration;
using Microsoft.Extensions.Configuration.AzureAppConfiguration;

var connectionString = Environment.GetEnvironmentVariable("AZURE_APPCONFIGURATION_CONNECTIONSTRING");
var builder = new ConfigurationBuilder();
builder.AddAzureAppConfiguration(connectionString);

var config = builder.Build();

pom.xml ファイルに次の依存関係を追加します：

<dependency>
    <groupId>com.azure</groupId>
    <artifactId>azure-data-appconfiguration</artifactId>
    <version>1.4.9</version>
</dependency>

Service Connector によって追加された環境変数からそのApp Configuration接続文字列を取得します。

String connectionString = System.getenv("AZURE_APPCONFIGURATION_CONNECTIONSTRING");
ConfigurationClient configurationClient = new ConfigurationClientBuilder()
    .connectionString(connectionString)
    .buildClient();

依存関係をインストールします。
```
pip install azure-appconfiguration
```

Service Connector によって追加された環境変数からそのApp Configuration接続文字列を取得します。

import os
from azure.appconfiguration import AzureAppConfigurationClient

connection_string = os.getenv('AZURE_APPCONFIGURATION_CONNECTIONSTRING')
app_config_client = AzureAppConfigurationClient.from_connection_string(connection_string)

依存関係をインストールします。
```
npm install @azure/app-configuration
```

Service Connector によって追加された環境変数からそのApp Configuration接続文字列を取得します。

const appConfig = require("@azure/app-configuration");

const connection_string = process.env.AZURE_APPCONFIGURATION_CONNECTIONSTRING;
const client = new appConfig.AppConfigurationClient(connection_string);

サービスプリンシパル

既定の環境変数名	説明	サンプルの値
AZURE_APPCONFIGURATION_ENDPOINT	App Configuration のエンドポイント	`https://<AppConfigurationName>.azconfig.io`
AZURE_APPCONFIGURATION_CLIENTID	クライアント ID	`<client-ID>`
AZURE_APPCONFIGURATION_CLIENTSECRET	クライアントシークレット	`<client-secret>`
AZURE_APPCONFIGURATION_TENANTID	テナント ID	`<tenant-ID>`

サンプルコード

次のステップとコードへ参照して、サービスプリンシパルを使用してAzure App Configurationに接続します。

依存関係をインストールします。

dotnet add package Microsoft.Extensions.Configuration.AzureAppConfiguration
dotnet add package Azure.Identity

using Azure.Identity;
using Microsoft.Extensions.Configuration;
using Microsoft.Extensions.Configuration.AzureAppConfiguration;

string endpoint = Environment.GetEnvironmentVariable("AZURE_APPCONFIGURATION_ENDPOINT");

// Uncomment the following lines corresponding to the authentication type you want to use.
// system-assigned managed identity
// var credential = new DefaultAzureCredential();

// user-assigned managed identity
// var credential = new DefaultAzureCredential(
//     new DefaultAzureCredentialOptions
//     {
//         ManagedIdentityClientId = Environment.GetEnvironmentVariable("AZURE_APPCONFIGURATION_CLIENTID");
//     });

// service principal 
// var tenantId = Environment.GetEnvironmentVariable("AZURE_APPCONFIGURATION_TENANTID");
// var clientId = Environment.GetEnvironmentVariable("AZURE_APPCONFIGURATION_CLIENTID");
// var clientSecret = Environment.GetEnvironmentVariable("AZURE_APPCONFIGURATION_CLIENTSECRET");
// var credential = new ClientSecretCredential(tenantId, clientId, clientSecret);

var client = new ConfigurationClient(new Uri(endpoint), credential);

pom.xml ファイルに次の依存関係を追加します。

<dependency>
    <groupId>com.azure</groupId>
    <artifactId>azure-data-appconfiguration</artifactId>
    <version>1.4.9</version>
</dependency>
<dependency>
    <groupId>com.azure</groupId>
    <artifactId>azure-identity</artifactId>
    <version>1.1.5</version>
</dependency>

// Uncomment the following lines corresponding to the authentication type you want to use.
// for system-managed identity
// DefaultAzureCredential defaultCredential = new DefaultAzureCredentialBuilder().build();

// for user-assigned managed identity
// DefaultAzureCredential defaultCredential = new DefaultAzureCredentialBuilder()
//     .managedIdentityClientId(System.getenv("AZURE_APPCONFIGURATION_CLIENTID"))
//     .build();

// for service principal
// ClientSecretCredential defaultCredential = new ClientSecretCredentialBuilder()
//   .clientId(System.getenv("AZURE_APPCONFIGURATION_CLIENTID"))
//   .clientSecret(System.getenv("AZURE_APPCONFIGURATION_CLIENTSECRET"))
//   .tenantId(System.getenv("AZURE_APPCONFIGURATION_TENANTID"))
//   .build();

String endpoint = System.getenv("AZURE_APPCONFIGURATION_ENDPOINT");

ConfigurationClient configurationClient = new ConfigurationClientBuilder()
    .credential(credential)
    .endpoint(endpoint)
    .buildClient();

依存関係をインストールします。

pip install azure-appconfiguration
pip install azure-identity

import os
from azure.appconfiguration import AzureAppConfigurationClient
from azure.identity import ManagedIdentityCredential, ClientSecretCredential

# Uncomment the following lines corresponding to the authentication type you want to use.
# system-assigned managed identity
# cred = ManagedIdentityCredential()

# user-assigned managed identity
# managed_identity_client_id = os.getenv('AZURE_APPCONFIGURATION_CLIENTID')
# cred = ManagedIdentityCredential(client_id=managed_identity_client_id)

# service principal
# tenant_id = os.getenv('AZURE_APPCONFIGURATION_TENANTID')
# client_id = os.getenv('AZURE_APPCONFIGURATION_CLIENTID')
# client_secret = os.getenv('AZURE_APPCONFIGURATION_CLIENTSECRET')
# cred = ClientSecretCredential(tenant_id=tenant_id, client_id=client_id, client_secret=client_secret)

endpoint_url = os.getenv('AZURE_APPCONFIGURATION_ENDPOINT')

client = AzureAppConfigurationClient(base_url="your_endpoint_url", credential=credential)

依存関係をインストールします。

npm install --save @azure/identity
npm install @azure/app-configuration

import { DefaultAzureCredential,ClientSecretCredential } from "@azure/identity";
const appConfig = require("@azure/app-configuration");

// Uncomment the following lines corresponding to the authentication type you want to use.
// for system-assigned managed identity
// const credential = new DefaultAzureCredential();

// for user-assigned managed identity
// const clientId = process.env.AZURE_APPCONFIGURATION_CLIENTID;
// const credential = new DefaultAzureCredential({
//     managedIdentityClientId: clientId
// });

// for service principal
// const tenantId = process.env.AZURE_APPCONFIGURATION_TENANTID;
// const clientId = process.env.AZURE_APPCONFIGURATION_CLIENTID;
// const clientSecret = process.env.AZURE_APPCONFIGURATION_CLIENTSECRET;
// const credential = new ClientSecretCredential(tenantId, clientId, clientSecret);

const endpoint = process.env.AZURE_APPCONFIGURATION_ENDPOINT;

const client = new appConfig.AppConfigurationClient(
    endpoint,
    credential
);

次のステップ

Service Connector の詳細については、以下のチュートリアルに従ってください。

Service Connector の概念について学習する

次の方法で共有

サービスコネクタを使用して Azure App Configuration を統合する

サポートされているコンピューティングサービス

サポートされている認証の種類とクライアントの種類

デフォルトの環境変数の名前またはアプリケーションのプロパティとサンプルコード

システム割り当てマネージド ID

サンプルコード

ユーザー割り当てマネージド ID

サンプルコード

接続文字列

サンプルコード

サービスプリンシパル

サンプルコード

次のステップ

フィードバック

その他のリソース

次の方法で共有

サービス コネクタを使用して Azure App Configuration を統合する

サポートされているコンピューティング サービス

サポートされている認証の種類とクライアントの種類

デフォルトの環境変数の名前またはアプリケーションのプロパティとサンプル コード

システム割り当てマネージド ID

サンプル コード

ユーザー割り当てマネージド ID

サンプル コード

接続文字列

サンプル コード

サービス プリンシパル

サンプル コード

次のステップ

フィードバック

その他のリソース

サービスコネクタを使用して Azure App Configuration を統合する

サポートされているコンピューティングサービス

デフォルトの環境変数の名前またはアプリケーションのプロパティとサンプルコード

サンプルコード

サンプルコード

サンプルコード

サービスプリンシパル

サンプルコード