Freigeben über


Integrieren von Azure App Configuration mit dem Dienstconnector

Diese Seite zeigt unterstützte Authentifizierungsmethoden und Clients und zeigt Beispielcode, mit dem Sie Azure-App Konfiguration mit anderen Clouddiensten mithilfe von Service Verbinden or verbinden können. Möglicherweise können Sie mit anderen Methoden trotzdem eine Verbindung mit der App-Konfiguration herstellen. Auf dieser Seite werden auch die Namen und Werte der Standardumgebungsvariablen angezeigt, die Sie erhalten, wenn Sie die Dienstverbindung erstellen.

Unterstützte Computedienste

Der Dienst-Verbinden or kann verwendet werden, um die folgenden Computedienste mit Azure-App Konfiguration zu verbinden:

  • Azure App Service
  • Azure-Funktionen
  • Azure Container Apps
  • Azure Spring Apps

Unterstützte Authentifizierungstypen und Clienttypen

Die folgende Tabelle zeigt, welche Kombinationen von Authentifizierungsmethoden und Clients unterstützt werden, um Ihren Computedienst mit Azure-App Konfiguration mithilfe von Service Verbinden or zu verbinden. Ein "Ja" gibt an, dass die Kombination unterstützt wird, während ein "Nein" angibt, dass sie nicht unterstützt wird.

Clienttyp Systemseitig zugewiesene verwaltete Identität Benutzerseitig zugewiesene verwaltete Identität Geheimnis/Verbindungszeichenfolge Dienstprinzipal
.NET Ja Ja Ja Ja
Java Ja Ja Ja Ja
Node.js Ja Ja Ja Ja
Python Ja Ja Ja Ja
Keine Ja Ja Ja Ja

Diese Tabelle gibt an, dass alle Kombinationen von Clienttypen und Authentifizierungsmethoden in der Tabelle unterstützt werden. Alle Clienttypen können eine der Authentifizierungsmethoden verwenden, um mithilfe von Service Verbinden or eine Verbindung mit Azure-App Konfiguration herzustellen.

Standardumgebungsvariablennamen oder Anwendungseigenschaften und Beispielcode

Verwenden Sie die folgenden Verbindungsdetails, um Computedienste mit Azure-App Konfigurationsspeichern zu verbinden. Weitere Informationen zu Benennungskonventionen finden Sie im Artikel "Service Verbinden or internals".

Systemseitig zugewiesene verwaltete Identität

Standardname der Umgebungsvariablen Beschreibung Beispielwert
AZURE_APPCONFIGURATION_ENDPOINT App Configuration-Endpunkt https://<App-Configuration-name>.azconfig.io

Beispielcode

Lesen Sie die schritte und den folgenden Code, um mithilfe einer vom System zugewiesenen verwalteten Identität eine Verbindung mit Azure-App Konfiguration herzustellen.

  1. Installieren Sie Abhängigkeiten.

    dotnet add package Microsoft.Extensions.Configuration.AzureAppConfiguration
    dotnet add package Azure.Identity
    
  2. Authentifizieren Sie sich mithilfe Azure.Identity des Azure-App Konfigurationsendpunkts aus den von Service Verbinden or hinzugefügten Umgebungsvariablen. Wenn Sie den folgenden Code verwenden, heben Sie die Auskommentierung des Teils des Codeschnipsels für den Authentifizierungstyp auf, den Sie verwenden möchten.

    using Azure.Identity;
    using Microsoft.Extensions.Configuration;
    using Microsoft.Extensions.Configuration.AzureAppConfiguration;
    
    string endpoint = Environment.GetEnvironmentVariable("AZURE_APPCONFIGURATION_ENDPOINT");
    
    // Uncomment the following lines according to the authentication type.
    // 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);
    

Benutzerseitig zugewiesene verwaltete Identität

Standardname der Umgebungsvariablen Beschreibung Beispielwert
AZURE_APPCONFIGURATION_ENDPOINT App Configuration-Endpunkt https://App-Configuration-name>.azconfig.io
AZURE_APPCONFIGURATION_CLIENTID Ihre Client-ID <client-ID>

Beispielcode

Lesen Sie die schritte und den folgenden Code, um mithilfe einer vom Benutzer zugewiesenen verwalteten Identität eine Verbindung mit Azure-App Konfiguration herzustellen.

  1. Installieren Sie Abhängigkeiten.

    dotnet add package Microsoft.Extensions.Configuration.AzureAppConfiguration
    dotnet add package Azure.Identity
    
  2. Authentifizieren Sie sich mithilfe Azure.Identity des Azure-App Konfigurationsendpunkts aus den von Service Verbinden or hinzugefügten Umgebungsvariablen. Wenn Sie den folgenden Code verwenden, heben Sie die Auskommentierung des Teils des Codeschnipsels für den Authentifizierungstyp auf, den Sie verwenden möchten.

    using Azure.Identity;
    using Microsoft.Extensions.Configuration;
    using Microsoft.Extensions.Configuration.AzureAppConfiguration;
    
    string endpoint = Environment.GetEnvironmentVariable("AZURE_APPCONFIGURATION_ENDPOINT");
    
    // Uncomment the following lines according to the authentication type.
    // 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);
    

Verbindungszeichenfolge

Standardname der Umgebungsvariablen Beschreibung Beispielwert
AZURE_APPCONFIGURATION_CONNECTIONSTRING Ihre App Configuration-Verbindungszeichenfolge Endpoint=https://<App-Configuration-name>.azconfig.io;Id=<ID>;Secret=<secret>

Beispielcode

Lesen Sie die schritte und den folgenden Code, um mithilfe eines Verbindungszeichenfolge eine Verbindung mit Azure-App Konfiguration herzustellen.

  1. Installieren Sie Abhängigkeiten.

    dotnet add package Microsoft.Extensions.Configuration.AzureAppConfiguration
    
  2. Rufen Sie die App-Konfigurations-Verbindungszeichenfolge aus den Von Service Verbinden or hinzugefügten Umgebungsvariablen ab.

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

Dienstprinzipal

Standardname der Umgebungsvariablen Beschreibung Beispielwert
AZURE_APPCONFIGURATION_ENDPOINT App Configuration-Endpunkt https://<AppConfigurationName>.azconfig.io
AZURE_APPCONFIGURATION_CLIENTID Ihre Client-ID <client-ID>
AZURE_APPCONFIGURATION_CLIENTSECRET Ihr geheimer Clientschlüssel <client-secret>
AZURE_APPCONFIGURATION_TENANTID Ihre Mandanten-ID <tenant-ID>

Beispielcode

Lesen Sie die schritte und den folgenden Code, um mithilfe eines Dienst principaL eine Verbindung mit Azure-App-Konfiguration herzustellen.

  1. Installieren Sie Abhängigkeiten.

    dotnet add package Microsoft.Extensions.Configuration.AzureAppConfiguration
    dotnet add package Azure.Identity
    
  2. Authentifizieren Sie sich mithilfe Azure.Identity des Azure-App Konfigurationsendpunkts aus den von Service Verbinden or hinzugefügten Umgebungsvariablen. Wenn Sie den folgenden Code verwenden, heben Sie die Auskommentierung des Teils des Codeschnipsels für den Authentifizierungstyp auf, den Sie verwenden möchten.

    using Azure.Identity;
    using Microsoft.Extensions.Configuration;
    using Microsoft.Extensions.Configuration.AzureAppConfiguration;
    
    string endpoint = Environment.GetEnvironmentVariable("AZURE_APPCONFIGURATION_ENDPOINT");
    
    // Uncomment the following lines according to the authentication type.
    // 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);
    

Nächste Schritte

Arbeiten Sie das unten aufgeführte Tutorial durch, um mehr über den Dienstconnector zu erfahren.