Delen via


Configuratie van Azure-app integreren met Service Verbinding maken or

Op deze pagina ziet u ondersteunde verificatiemethoden en -clients en ziet u voorbeeldcode die u kunt gebruiken om Azure-app Configuratie te verbinden met andere cloudservices met behulp van Service Verbinding maken or. Mogelijk kunt u nog steeds verbinding maken met App Configuration met behulp van andere methoden. Op deze pagina worden ook de standaardnamen en waarden van omgevingsvariabelen weergegeven die u krijgt wanneer u de serviceverbinding maakt.

Ondersteunde rekenservices

Service Verbinding maken or kan worden gebruikt om de volgende rekenservices te verbinden met Azure-app-configuratie:

  • Azure App Service
  • Azure Functions
  • Azure Container Apps
  • Azure Spring Apps

Ondersteunde verificatietypen en clienttypen

In de onderstaande tabel ziet u welke combinaties van verificatiemethoden en -clients worden ondersteund voor het verbinden van uw rekenservice met Azure-app-configuratie met behulp van service Verbinding maken or. Een 'Ja' geeft aan dat de combinatie wordt ondersteund, terwijl een 'Nee' aangeeft dat deze niet wordt ondersteund.

Client-type Door het systeem toegewezen beheerde identiteit Door de gebruiker toegewezen beheerde identiteit Geheim/verbindingsreeks Service-principal
.NET Ja Ja Ja Ja
Java Ja Ja Ja Ja
Node.js Ja Ja Ja Ja
Python Ja Ja Ja Ja
Geen Ja Ja Ja Ja

Deze tabel geeft aan dat alle combinaties van clienttypen en verificatiemethoden in de tabel worden ondersteund. Alle clienttypen kunnen elk van de verificatiemethoden gebruiken om verbinding te maken met Azure-app Configuratie met behulp van de service Verbinding maken or.

Namen van standaardomgevingsvariabelen of toepassingseigenschappen en voorbeeldcode

Gebruik de onderstaande verbindingsgegevens om rekenservices te verbinden met Azure-app Configuratiearchieven. Raadpleeg het artikel Service Verbinding maken or internals voor meer informatie over naamconventies.

Door het systeem toegewezen beheerde identiteit

Naam van standaardomgevingsvariabele Beschrijving Voorbeeldwaarde
AZURE_APPCONFIGURATION_ENDPOINT App Configuration-eindpunt https://<App-Configuration-name>.azconfig.io

Voorbeeldcode

Raadpleeg de stappen en code hieronder om verbinding te maken met Azure-app Configuration met behulp van een door het systeem toegewezen beheerde identiteit.

  1. Installeer afhankelijkheden.

    dotnet add package Microsoft.Extensions.Configuration.AzureAppConfiguration
    dotnet add package Azure.Identity
    
  2. Verifieer met behulp van Azure.Identity het Azure-app Configuratie-eindpunt van de omgevingsvariabelen die zijn toegevoegd door Service Verbinding maken or. Als u de onderstaande code gebruikt, moet u het gedeelte van het codefragment verwijderen voor het verificatietype dat u wilt gebruiken.

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

Door de gebruiker toegewezen beheerde identiteit

Naam van standaardomgevingsvariabele Beschrijving Voorbeeldwaarde
AZURE_APPCONFIGURATION_ENDPOINT App Configuration-eindpunt https://App-Configuration-name>.azconfig.io
AZURE_APPCONFIGURATION_CLIENTID Uw client-id <client-ID>

Voorbeeldcode

Raadpleeg de stappen en code hieronder om verbinding te maken met Azure-app Configuratie met behulp van een door de gebruiker toegewezen beheerde identiteit.

  1. Installeer afhankelijkheden.

    dotnet add package Microsoft.Extensions.Configuration.AzureAppConfiguration
    dotnet add package Azure.Identity
    
  2. Verifieer met behulp van Azure.Identity het Azure-app Configuratie-eindpunt van de omgevingsvariabelen die zijn toegevoegd door Service Verbinding maken or. Als u de onderstaande code gebruikt, moet u het gedeelte van het codefragment verwijderen voor het verificatietype dat u wilt gebruiken.

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

Connection string

Naam van standaardomgevingsvariabele Beschrijving Voorbeeldwaarde
AZURE_APPCONFIGURATION_CONNECTIONSTRING De tekenreeks voor Verbinding maken van uw app-configuratie Endpoint=https://<App-Configuration-name>.azconfig.io;Id=<ID>;Secret=<secret>

Voorbeeldcode

Raadpleeg de stappen en code hieronder om verbinding te maken met Azure-app Configuration met behulp van een verbindingsreeks.

  1. Installeer afhankelijkheden.

    dotnet add package Microsoft.Extensions.Configuration.AzureAppConfiguration
    
  2. Haal de App Configuration-verbindingsreeks op uit de omgevingsvariabelen die door Service Verbinding maken or zijn toegevoegd.

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

Service-principal

Naam van standaardomgevingsvariabele Beschrijving Voorbeeldwaarde
AZURE_APPCONFIGURATION_ENDPOINT App Configuration-eindpunt https://<AppConfigurationName>.azconfig.io
AZURE_APPCONFIGURATION_CLIENTID Uw client-id <client-ID>
AZURE_APPCONFIGURATION_CLIENTSECRET Uw clientgeheim <client-secret>
AZURE_APPCONFIGURATION_TENANTID Uw tenant-id <tenant-ID>

Voorbeeldcode

Raadpleeg de onderstaande stappen en code om verbinding te maken met Azure-app Configuration met behulp van een service-principaL.

  1. Installeer afhankelijkheden.

    dotnet add package Microsoft.Extensions.Configuration.AzureAppConfiguration
    dotnet add package Azure.Identity
    
  2. Verifieer met behulp van Azure.Identity het Azure-app Configuratie-eindpunt van de omgevingsvariabelen die zijn toegevoegd door Service Verbinding maken or. Als u de onderstaande code gebruikt, moet u het gedeelte van het codefragment verwijderen voor het verificatietype dat u wilt gebruiken.

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

Volgende stappen

Volg de onderstaande zelfstudie voor meer informatie over Service Verbinding maken or.