Bagikan melalui


Mengintegrasikan Azure App Configuration dengan Service Koneksi or

Halaman ini memperlihatkan metode dan klien autentikasi yang didukung, dan memperlihatkan kode sampel yang dapat Anda gunakan untuk menyambungkan Azure App Configuration ke layanan cloud lain menggunakan Service Koneksi or. Anda mungkin masih dapat tersambung ke App Configuration menggunakan metode lain. Halaman ini juga menampilkan nama dan nilai variabel lingkungan default yang Anda dapatkan saat membuat koneksi layanan.

Layanan komputasi yang didukung

Service Koneksi or dapat digunakan untuk menyambungkan layanan komputasi berikut ke Azure App Configuration:

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

Jenis Autentikasi yang Didukung serta jenis klien

Tabel di bawah ini menunjukkan kombinasi metode autentikasi dan klien mana yang didukung untuk menyambungkan layanan komputasi Anda ke Azure App Configuration menggunakan Service Koneksi or. "Ya" menunjukkan bahwa kombinasi didukung, sementara "Tidak" menunjukkan bahwa kombinasi tersebut tidak didukung.

Jenis klien Identitas terkelola yang ditetapkan sistem Identitas terkelola yang ditetapkan pengguna Rahasia/string koneksi Perwakilan layanan
.NET Ya Ya Ya Ya
Java Ya Ya Ya Ya
Node.js Ya Ya Ya Ya
Python Ya Ya Ya Ya
Tidak Ya Ya Ya Ya

Tabel ini menunjukkan bahwa semua kombinasi jenis klien dan metode autentikasi dalam tabel didukung. Semua jenis klien dapat menggunakan salah satu metode autentikasi untuk menyambungkan ke Azure App Configuration menggunakan Koneksi or Layanan.

Nama variabel lingkungan default atau properti aplikasi dan kode sampel

Gunakan detail koneksi di bawah ini untuk menyambungkan layanan komputasi ke penyimpanan Azure App Configuration. Untuk informasi selengkapnya tentang konvensi penamaan, periksa artikel Layanan Koneksi or internal.

Identitas terkelola yang ditetapkan sistem

Nama Variabel Lingkungan Deskripsi Sampel nilai
AZURE_APPCONFIGURATION_ENDPOINT Titik akhir App Configuration https://<App-Configuration-name>.azconfig.io

Kode Sampel

Lihat langkah-langkah dan kode di bawah ini untuk menyambungkan ke Azure App Configuration menggunakan identitas terkelola yang ditetapkan sistem.

  1. Instal dependensi.

    dotnet add package Microsoft.Extensions.Configuration.AzureAppConfiguration
    dotnet add package Azure.Identity
    
  2. Autentikasi menggunakan Azure.Identity dan dapatkan titik akhir Azure App Configuration dari variabel lingkungan yang ditambahkan oleh service Koneksi or. Saat menggunakan kode di bawah ini, batalkan komentar bagian cuplikan kode untuk jenis autentikasi yang ingin Anda gunakan.

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

Identitas terkelola yang ditetapkan pengguna

Nama Variabel Lingkungan Deskripsi Sampel nilai
AZURE_APPCONFIGURATION_ENDPOINT Titik Akhir App Configuration https://App-Configuration-name>.azconfig.io
AZURE_APPCONFIGURATION_CLIENTID ID klien Anda <client-ID>

Kode Sampel

Lihat langkah-langkah dan kode di bawah ini untuk menyambungkan ke Azure App Configuration menggunakan identitas terkelola yang ditetapkan pengguna.

  1. Instal dependensi.

    dotnet add package Microsoft.Extensions.Configuration.AzureAppConfiguration
    dotnet add package Azure.Identity
    
  2. Autentikasi menggunakan Azure.Identity dan dapatkan titik akhir Azure App Configuration dari variabel lingkungan yang ditambahkan oleh service Koneksi or. Saat menggunakan kode di bawah ini, batalkan komentar bagian cuplikan kode untuk jenis autentikasi yang ingin Anda gunakan.

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

String koneksi

Nama Variabel Lingkungan Deskripsi Sampel nilai
AZURE_APPCONFIGURATION_CONNECTIONSTRING String Koneksi ion App Configuration Anda Endpoint=https://<App-Configuration-name>.azconfig.io;Id=<ID>;Secret=<secret>

Kode Sampel

Lihat langkah-langkah dan kode di bawah ini untuk menyambungkan ke Azure App Configuration menggunakan string koneksi.

  1. Instal dependensi.

    dotnet add package Microsoft.Extensions.Configuration.AzureAppConfiguration
    
  2. Dapatkan string koneksi App Configuration dari variabel lingkungan yang ditambahkan oleh Service Koneksi or.

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

Perwakilan layanan

Nama Variabel Lingkungan Deskripsi Sampel nilai
AZURE_APPCONFIGURATION_ENDPOINT Titik Akhir App Configuration https://<AppConfigurationName>.azconfig.io
AZURE_APPCONFIGURATION_CLIENTID ID klien Anda <client-ID>
AZURE_APPCONFIGURATION_CLIENTSECRET Rahasia klien Anda <client-secret>
AZURE_APPCONFIGURATION_TENANTID ID penyewa Anda <tenant-ID>

Kode Sampel

Lihat langkah-langkah dan kode di bawah ini untuk menyambungkan ke Azure App Configuration menggunakan principaL layanan.

  1. Instal dependensi.

    dotnet add package Microsoft.Extensions.Configuration.AzureAppConfiguration
    dotnet add package Azure.Identity
    
  2. Autentikasi menggunakan Azure.Identity dan dapatkan titik akhir Azure App Configuration dari variabel lingkungan yang ditambahkan oleh service Koneksi or. Saat menggunakan kode di bawah ini, batalkan komentar bagian cuplikan kode untuk jenis autentikasi yang ingin Anda gunakan.

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

Langkah berikutnya

Ikuti tutorial yang tercantum di bawah ini untuk mempelajari lebih lanjut tentang Service Koneksi or.