Acesse o Configuração de Aplicativos do Azure usando Microsoft Entra ID

Provedor de configuração do .NET

Se o aplicativo usar qualquer um dos pacotes a seguir, o público-alvo poderá ser configurado utilizando o método ConfigureClientOptions . Use a versão 8.2.0 ou posterior de qualquer um dos pacotes a seguir para configurar o público-alvo.

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

O snippet de código a seguir demonstra como adicionar o provedor de Configuração de Aplicativos do Azure a um aplicativo .NET com um público específico da nuvem.

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

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

SDK do Azure para .NET

Se o seu aplicativo usar o pacote a seguir, a audiência poderá ser configurada no ConfigurationClientOptions ao construir o objeto ConfigurationClient. Use a versão 1.6.0 ou posterior do pacote a seguir.

• Azure.Data.AppConfiguration

O snippet de código a seguir demonstra como instanciar um cliente de configuração com um público específico da nuvem.

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

Provedor de configuração do Spring

Se seu aplicativo utilizar algum dos pacotes a seguir, o público-alvo poderá ser configurado personalizando o ConfigurationClientBuilder por meio da interface ConfigurationClientCustomizer e, em seguida, adicionando-o ao registro de bootstrap. Use a versão 5.22.0 ou posterior dos seguintes pacotes para configurar o público-alvo.

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

O snippet de código a seguir demonstra como adicionar o provedor de Configuração de Aplicativos do Azure a um aplicativo Spring Boot com um público específico da nuvem.

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}"));
    }
}

Em seguida, registre-o CustomClient no registro de inicialização.

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);
	}

}

SDK do Azure para Java

Se o aplicativo usar o pacote a seguir, a audiência poderá ser configurada passando a opção audience para o ConfigurationClientBuilder ao construir um ConfigurationClient. Use a versão 1.8.0 ou posterior do pacote a seguir.

• azure-data-appconfiguration

O snippet de código a seguir demonstra como instanciar um cliente de configuração com um público específico da nuvem.

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

Provedor de configuração javaScript

Se o aplicativo usar o pacote a seguir, a audiência poderá ser configurada passando o clientOptions com a propriedade audience para a função load. Use a versão 1.0.0 ou posterior do pacote a seguir.

• @azure/app-configuration-provider

O snippet de código a seguir demonstra como carregar a Configuração de Aplicativos do Azure em um aplicativo JavaScript com um público específico da nuvem.

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

SDK do Azure para JavaScript

Se o seu aplicativo utilizar o pacote a seguir, é possível configurar o público alvo passando a opção audience para o construtor AppConfigurationClient. Use a versão 1.9.0 ou posterior do pacote a seguir.

• @azure/app-configuration

O snippet de código a seguir demonstra como instanciar um cliente de configuração com um público específico da nuvem.

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

Provedor de configuração do Python

Se o aplicativo usar o pacote a seguir, o público-alvo poderá ser configurado passando a palavra-chave audience para o load método. Use a versão 2.4.0 ou posterior do pacote a seguir.

• azure-appconfiguration-provider

O snippet de código a seguir demonstra como carregar a Configuração de Aplicativos do Azure em um aplicativo Python com um público específico da nuvem.

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

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

SDK do Azure para Python

Se o aplicativo usar o pacote a seguir, a audiência poderá ser configurada passando a palavra-chave audience para o construtor AzureAppConfigurationClient. Use a versão 1.8.0 ou posterior do pacote a seguir.

• azure-appconfiguration

O snippet de código a seguir demonstra como instanciar um cliente de configuração com um público específico da nuvem.

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

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

Para configurar o público-alvo do Entra ID, importe os seguintes pacotes em seu aplicativo Go primeiro:

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

Provedor de configuração Go

Se o aplicativo usar o pacote a seguir, o público-alvo poderá ser configurado passando a configuração de nuvem ClientOptions para a função Load. Use a versão 1.0.0 ou posterior do pacote a seguir.

• azureappconfiguration

O snippet de código a seguir demonstra como carregar a Configuração de Aplicativos do Azure em um aplicativo Go com um público específico da nuvem.

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)

SDK do Azure para linguagem Go

Se o aplicativo usar o pacote a seguir, o público-alvo poderá ser configurado utilizando a configuração de nuvem. Use a versão 2.1.0 ou posterior do pacote a seguir.

• azappconfig

O snippet de código a seguir demonstra como instanciar um cliente de configuração com um público específico da nuvem.

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)

Provedor do Kubernetes

Se o aplicativo for executado no Kubernetes e você usar o Provedor de Kubernetes de Configuração de Aplicativo do Azure, a configuração de audiência dependerá de como o provedor é instalado.

• Extensão do AKS: nenhuma configuração de público é necessária. A extensão determina automaticamente o público-alvo com base na nuvem em que ela é executada.
• Gráfico do Helm: o público-alvo pode ser configurado no momento da instalação definindo o env.azureAppConfigurationAudience parâmetro. Use a versão 2.6.0 ou posterior do Provedor de Kubernetes de Configuração de Aplicativo do Azure para configurar o público-alvo.

O comando a seguir demonstra como instalar o Provedor de Kubernetes de Configuração de Aplicativo do Azure usando o Helm para um público específico do ambiente de nuvem.

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}"

Azure PowerShell

Se você usar Azure PowerShell, o público-alvo poderá ser configurado definindo o parâmetro AzureAppConfigurationEndpointResourceId em um ambiente de Azure personalizado usando Add-AzEnvironment ou Set-AzEnvironment. Use a versão 15.6.0 ou posterior do módulo Az .

O exemplo a seguir demonstra como configurar o ambiente Bleu com a audiência e o sufixo de ponto de extremidade da Configuração de Aplicativos.

Add-AzEnvironment -Name "{Environment name}" `
    -AzureAppConfigurationEndpointResourceId "https://appconfig.sovcloud-api.fr" `
    -AzureAppConfigurationEndpointSuffix "appconfig.sovcloud-api.fr"

Para atualizar um ambiente existente:

Set-AzEnvironment -Name "{Environment name}" `
    -AzureAppConfigurationEndpointResourceId "https://appconfig.sovcloud-api.fr" `
    -AzureAppConfigurationEndpointSuffix "appconfig.sovcloud-api.fr"

Depois de configurar o ambiente, conecte-se a ele antes de executar os comandos de Configuração de Aplicativo:

Connect-AzAccount -Environment "{Environment name}"

CLI do Azure

Se você usar CLI do Azure, o público-alvo poderá ser configurado definindo a propriedade de ponto de extremidade appconfig_auth_token_audience em uma definição de nuvem usando az cloud register ou az cloud update.

O exemplo a seguir demonstra como configurar uma nuvem personalizada para Bleu com o público-alvo da Configuração de Aplicativos.

az cloud register --name <BleuCloudName> --cloud-config "{\"endpoints\":{\"resourceManager\":\"<BleuResourceManagerEndpoint>\",\"activeDirectory\":\"<BleuActiveDirectoryEndpoint>\",\"activeDirectoryResourceId\":\"<BleuActiveDirectoryResourceId>\",\"appconfig_auth_token_audience\":\"https://appconfig.sovcloud-api.fr\"}}"

Para atualizar a nuvem atual:

az cloud update -n <BleuCloudName> --cloud-config "{\"endpoints\": {\"appconfig_auth_token_audience\": \"https://appconfig.sovcloud-api.fr\"}}"

Depois de configurar a nuvem, defina-a como a nuvem ativa antes de executar os comandos de Configuração de Aplicativo:

az cloud set --name <BleuCloudName>