Доступ к Конфигурации приложений Azure с помощью Microsoft Entra ID

Поставщик конфигурации .NET

Если приложение использует любой из следующих пакетов, аудитория может быть настроена с помощью метода ConfigureClientOptions . Чтобы настроить аудиторию, используйте версию 8.2.0 или более позднюю версию любого из следующих пакетов.

• Microsoft.Extensions.Configuration.AzureAppConfiguration
• Microsoft.Azure.AppConfiguration.AspNetCore
• Microsoft.Azure.AppConfiguration.Functions.Worker

В следующем фрагменте кода показано, как добавить поставщика конфигурации приложений Azure в приложение .NET с облачной аудиторией.

builder.AddAzureAppConfiguration(o =>
    {
        o.Connect(
            myStoreEndpoint,
            new DefaultAzureCredential());

        o.ConfigureClientOptions(clientOptions =>
            clientOptions.Audience = "{Cloud specific audience here}");
    });

Azure SDK для .NET

Если ваше приложение использует следующий пакет, аудитория может быть настроена в ConfigurationClientOptions при создании объекта ConfigurationClient. Используйте версию 1.6.0 или более позднюю версию следующего пакета.

• Azure.Data.AppConfiguration

В следующем фрагменте кода показано, как создать экземпляр клиента конфигурации с аудиторией, специфичной для облачных технологий.

var configurationClient = new ConfigurationClient(
    myStoreEndpoint,
    new DefaultAzureCredential(),
    new ConfigurationClientOptions
    {
        Audience = "{Cloud specific audience here}"
    });

Поставщик конфигурации Spring

Если ваше приложение использует любой из следующих пакетов, целевую аудиторию можно настроить, настроив ConfigurationClientBuilder через интерфейс ConfigurationClientCustomizer, после чего добавьте её в реестр начальной загрузки. Чтобы настроить аудиторию, используйте версию 5.22.0 или более позднюю версию следующих пакетов.

• spring-cloud-azure-appconfiguration-config
• spring-cloud-azure-appconfiguration-config-web

В следующем фрагменте кода показано, как добавить поставщика конфигурации приложений Azure в приложение Spring Boot с облачной аудиторией.

import com.azure.data.appconfiguration.ConfigurationClientBuilder;
import com.azure.data.appconfiguration.models.ConfigurationAudience;
import com.azure.spring.cloud.appconfiguration.config.ConfigurationClientCustomizer;

public class CustomClient implements ConfigurationClientCustomizer {

    @Override
    public void customize(ConfigurationClientBuilder builder, String endpoint) {
        builder.audience(ConfigurationAudience.fromString("{Cloud specific audience here}"));
    }
}

Затем зарегистрируйте CustomClient в реестре начальной загрузки.

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.AutoConfiguration;
import org.springframework.boot.autoconfigure.SpringBootApplication;

import hello.impl.AppConfigClientImpl;

@SpringBootApplication
@AutoConfiguration
public class Application {

	public static void main(String[] args) {
		SpringApplication app = new SpringApplication(Application.class);
		
		// Register the ConfigurationClientCustomizer in the bootstrap context
		app.addBootstrapRegistryInitializer(registry -> {
			registry.register(CustomClient.class, context -> new CustomClient());
		});
		
		app.run(args);
	}

}

Azure SDK для Java

Если ваше приложение использует упомянутый ниже пакет, аудитория может быть настроена путем передачи опции audience -параметра ConfigurationClientBuilder во время сборки ConfigurationClient. Используйте версию 1.8.0 или более позднюю версию следующего пакета.

• azure-data-appconfiguration

В следующем фрагменте кода показано, как создать экземпляр клиента конфигурации с аудиторией, специфичной для облачных технологий.

ConfigurationClient configurationClient = new ConfigurationClientBuilder()
    .endpoint(myStoreEndpoint)
    .credential(new DefaultAzureCredentialBuilder().build())
    .audience(ConfigurationAudience.fromString("{Cloud specific audience here}"))
    .buildClient();

Поставщик конфигурации JavaScript

Если ваше приложение использует следующий пакет, аудиторию можно настроить, передавая свойство clientOptions в функцию audience. Используйте версию 1.0.0 или более позднюю версию следующего пакета.

• @azure/app-configuration-provider

В следующем фрагменте кода показано, как загрузить конфигурацию приложений Azure в приложении JavaScript с облачной аудиторией.

const appConfig = await load(myStoreEndpoint, credential, {
    clientOptions: {
        audience: "{Cloud specific audience here}"
    }
});

Azure SDK для JavaScript

Если ваше приложение использует следующий пакет, целевая аудитория может быть настроена, передав параметр audience в конструктор AppConfigurationClient. Используйте версию 1.9.0 или более позднюю версию следующего пакета.

• @azure/app-configuration

В следующем фрагменте кода показано, как создать экземпляр клиента конфигурации с аудиторией, специфичной для облачных технологий.

const client = new AppConfigurationClient(myStoreEndpoint, new DefaultAzureCredential(), {
    audience: "{Cloud specific audience here}",
});

Поставщик конфигурации Python

Если ваше приложение использует следующий пакет, целевой сегмент может быть настроен путем передачи ключевого слова audience методу load. Используйте версию 2.4.0 или более позднюю версию следующего пакета.

• azure-appconfiguration-provider

В следующем фрагменте кода показано, как загрузить конфигурацию приложений Azure в приложении Python с облачной аудиторией.

from azure.appconfiguration.provider import load
from azure.identity import DefaultAzureCredential

config = load(
    endpoint=myStoreEndpoint,
    credential=DefaultAzureCredential(),
    audience="{Cloud specific audience here}",
)

Azure SDK для Python

Если ваше приложение использует следующий пакет, аудитория может быть настроена, передавая аргумент audience конструктору AzureAppConfigurationClient. Используйте версию 1.8.0 или более позднюю версию следующего пакета.

• azure-appconfiguration

В следующем фрагменте кода показано, как создать экземпляр клиента конфигурации с аудиторией, специфичной для облачных технологий.

from azure.appconfiguration import AzureAppConfigurationClient
from azure.identity import DefaultAzureCredential

client = AzureAppConfigurationClient(
    myStoreEndpoint,
    DefaultAzureCredential(),
    audience="{Cloud specific audience here}",
)

Чтобы настроить аудиторию Entra ID, сначала импортируйте следующие пакеты в приложении Go:

import (
    "github.com/Azure/azure-sdk-for-go/sdk/azcore/cloud"
    "github.com/Azure/azure-sdk-for-go/sdk/azcore/policy"
)

Поставщик конфигурации Go

Если ваше приложение использует следующий пакет, аудиторию можно настроить, передав ClientOptions вместе с конфигурацией облака в функцию Load. Используйте версию 1.0.0 или более позднюю версию следующего пакета.

• azureappconfiguration

В следующем фрагменте кода показано, как загрузить конфигурацию приложений Azure в приложении Go с облачной аудиторией.

credential, _:= azidentity.NewDefaultAzureCredential(nil)

authOptions := azureappconfiguration.AuthenticationOptions{
    Endpoint: myStoreEndpoint,
    Credential: credential,
}

cloudConfig := cloud.Configuration{
    Services: map[cloud.ServiceName]cloud.ServiceConfiguration{
        azappconfig.ServiceName: {
            Audience: "{Cloud specific audience here}",
        },
    },
}

options := &azureappconfiguration.Options{
    ClientOptions: &azappconfig.ClientOptions{
        ClientOptions: policy.ClientOptions{
            Cloud: cloudConfig,
        },
    },
}

appConfig, _ := azureappconfiguration.Load(context.Background(), authOptions, options)

Пакет Azure SDK для Go

Если приложение использует следующий пакет, аудитория может быть настроена с помощью облачной конфигурации. Используйте версию 2.1.0 или более позднюю версию следующего пакета.

• azappconfig

В следующем фрагменте кода показано, как создать экземпляр клиента конфигурации с аудиторией, специфичной для облачных технологий.

credential, _:= azidentity.NewDefaultAzureCredential(nil)

cloudConfig := cloud.Configuration{
    Services: map[cloud.ServiceName]cloud.ServiceConfiguration{
        azappconfig.ServiceName: {
            Audience: "{Cloud specific audience here}",
        },
    },
}

clientOptions := &azappconfig.ClientOptions{
    ClientOptions: policy.ClientOptions{
        Cloud: cloudConfig,
    },
}

client, _ := azappconfig.NewClient(myStoreEndpoint, credential, clientOptions)

Поставщик Kubernetes

Если ваше приложение работает в Kubernetes и вы используете поставщик конфигурации приложений Azure для Kubernetes, настройка пользователей зависит от того, как установлен поставщик.

• Расширение AKS: настройка аудитории не требуется. Расширение автоматически определяет аудиторию на основе облака, в котором она выполняется.
• Диаграмма Helm: аудитория может быть настроена во время установки, задав env.azureAppConfigurationAudience параметр. Чтобы настроить аудиторию, используйте версию 2.6.0 или более позднюю поставщика конфигурации приложений Azure для Kubernetes.

Команда ниже демонстрирует, как установить поставщика Kubernetes конфигурации приложений Azure с помощью Helm для облачной инфраструктуры.

helm install azureappconfiguration.kubernetesprovider \
    oci://mcr.microsoft.com/azure-app-configuration/helmchart/kubernetes-provider \
    --namespace azappconfig-system \
    --create-namespace \
    --set env.azureAppConfigurationAudience="{Cloud specific audience here}"