Mengintegrasikan Azure App Configuration dengan Service Koneksi or
Artikel
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.
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);
Tambahkan dependensi berikut dalam file pom.xml Anda:
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.
// Uncomment the following lines according to the authentication type.
// for system-managed identity
// DefaultAzureCredential defaultCredential = new DefaultAzureCredentialBuilder().build();
// for user-assigned managed identity
// DefaultAzureCredential defaultCredential = new DefaultAzureCredentialBuilder()
// .managedIdentityClientId(System.getenv("AZURE_APPCONFIGURATION_CLIENTID"))
// .build();
// for service principal
// ClientSecretCredential defaultCredential = new ClientSecretCredentialBuilder()
// .clientId(System.getenv("AZURE_APPCONFIGURATION_CLIENTID"))
// .clientSecret(System.getenv("AZURE_APPCONFIGURATION_CLIENTSECRET"))
// .tenantId(System.getenv("AZURE_APPCONFIGURATION_TENANTID"))
// .build();
String endpoint = System.getenv("AZURE_APPCONFIGURATION_ENDPOINT");
ConfigurationClient configurationClient = new ConfigurationClientBuilder()
.credential(credential)
.endpoint(endpoint)
.buildClient();
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.
import os
from azure.appconfiguration import AzureAppConfigurationClient
from azure.identity import ManagedIdentityCredential, ClientSecretCredential
# Uncomment the following lines according to the authentication type.
# system-assigned managed identity
# cred = ManagedIdentityCredential()
# user-assigned managed identity
# managed_identity_client_id = os.getenv('AZURE_APPCONFIGURATION_CLIENTID')
# cred = ManagedIdentityCredential(client_id=managed_identity_client_id)
# service principal
# tenant_id = os.getenv('AZURE_APPCONFIGURATION_TENANTID')
# client_id = os.getenv('AZURE_APPCONFIGURATION_CLIENTID')
# client_secret = os.getenv('AZURE_APPCONFIGURATION_CLIENTSECRET')
# cred = ClientSecretCredential(tenant_id=tenant_id, client_id=client_id, client_secret=client_secret)
endpoint_url = os.getenv('AZURE_APPCONFIGURATION_ENDPOINT')
client = AzureAppConfigurationClient(base_url="your_endpoint_url", credential=credential)
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.
import { DefaultAzureCredential,ClientSecretCredential } from "@azure/identity";
const appConfig = require("@azure/app-configuration");
// Uncomment the following lines according to the authentication type.
// for system-assigned managed identity
// const credential = new DefaultAzureCredential();
// for user-assigned managed identity
// const clientId = process.env.AZURE_APPCONFIGURATION_CLIENTID;
// const credential = new DefaultAzureCredential({
// managedIdentityClientId: clientId
// });
// for service principal
// const tenantId = process.env.AZURE_APPCONFIGURATION_TENANTID;
// const clientId = process.env.AZURE_APPCONFIGURATION_CLIENTID;
// const clientSecret = process.env.AZURE_APPCONFIGURATION_CLIENTSECRET;
// const credential = new ClientSecretCredential(tenantId, clientId, clientSecret);
const endpoint = process.env.AZURE_APPCONFIGURATION_ENDPOINT;
const client = new appConfig.AppConfigurationClient(
endpoint,
credential
);
Untuk bahasa lain, Anda dapat menggunakan informasi koneksi yang diatur service Koneksi or ke variabel lingkungan untuk menyambungkan ke Azure App Configuration. Untuk detail variabel lingkungan, lihat Mengintegrasikan Azure App Configuration dengan Service Koneksi or.
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.
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);
Tambahkan dependensi berikut dalam file pom.xml Anda:
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.
// Uncomment the following lines according to the authentication type.
// for system-managed identity
// DefaultAzureCredential defaultCredential = new DefaultAzureCredentialBuilder().build();
// for user-assigned managed identity
// DefaultAzureCredential defaultCredential = new DefaultAzureCredentialBuilder()
// .managedIdentityClientId(System.getenv("AZURE_APPCONFIGURATION_CLIENTID"))
// .build();
// for service principal
// ClientSecretCredential defaultCredential = new ClientSecretCredentialBuilder()
// .clientId(System.getenv("AZURE_APPCONFIGURATION_CLIENTID"))
// .clientSecret(System.getenv("AZURE_APPCONFIGURATION_CLIENTSECRET"))
// .tenantId(System.getenv("AZURE_APPCONFIGURATION_TENANTID"))
// .build();
String endpoint = System.getenv("AZURE_APPCONFIGURATION_ENDPOINT");
ConfigurationClient configurationClient = new ConfigurationClientBuilder()
.credential(credential)
.endpoint(endpoint)
.buildClient();
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.
import os
from azure.appconfiguration import AzureAppConfigurationClient
from azure.identity import ManagedIdentityCredential, ClientSecretCredential
# Uncomment the following lines according to the authentication type.
# system-assigned managed identity
# cred = ManagedIdentityCredential()
# user-assigned managed identity
# managed_identity_client_id = os.getenv('AZURE_APPCONFIGURATION_CLIENTID')
# cred = ManagedIdentityCredential(client_id=managed_identity_client_id)
# service principal
# tenant_id = os.getenv('AZURE_APPCONFIGURATION_TENANTID')
# client_id = os.getenv('AZURE_APPCONFIGURATION_CLIENTID')
# client_secret = os.getenv('AZURE_APPCONFIGURATION_CLIENTSECRET')
# cred = ClientSecretCredential(tenant_id=tenant_id, client_id=client_id, client_secret=client_secret)
endpoint_url = os.getenv('AZURE_APPCONFIGURATION_ENDPOINT')
client = AzureAppConfigurationClient(base_url="your_endpoint_url", credential=credential)
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.
import { DefaultAzureCredential,ClientSecretCredential } from "@azure/identity";
const appConfig = require("@azure/app-configuration");
// Uncomment the following lines according to the authentication type.
// for system-assigned managed identity
// const credential = new DefaultAzureCredential();
// for user-assigned managed identity
// const clientId = process.env.AZURE_APPCONFIGURATION_CLIENTID;
// const credential = new DefaultAzureCredential({
// managedIdentityClientId: clientId
// });
// for service principal
// const tenantId = process.env.AZURE_APPCONFIGURATION_TENANTID;
// const clientId = process.env.AZURE_APPCONFIGURATION_CLIENTID;
// const clientSecret = process.env.AZURE_APPCONFIGURATION_CLIENTSECRET;
// const credential = new ClientSecretCredential(tenantId, clientId, clientSecret);
const endpoint = process.env.AZURE_APPCONFIGURATION_ENDPOINT;
const client = new appConfig.AppConfigurationClient(
endpoint,
credential
);
Untuk bahasa lain, Anda dapat menggunakan informasi koneksi yang diatur service Koneksi or ke variabel lingkungan untuk menyambungkan ke Azure App Configuration. Untuk detail variabel lingkungan, lihat Mengintegrasikan Azure App Configuration dengan Service Koneksi or.
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();
Tambahkan dependensi berikut dalam file pom.xml Anda:
Untuk bahasa lain, Anda dapat menggunakan informasi koneksi yang diatur service Koneksi or ke variabel lingkungan untuk menyambungkan ke Azure App Configuration. Untuk detail variabel lingkungan, lihat Mengintegrasikan Azure App Configuration dengan Service Koneksi or.
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.
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);
Tambahkan dependensi berikut dalam file pom.xml Anda:
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.
// Uncomment the following lines according to the authentication type.
// for system-managed identity
// DefaultAzureCredential defaultCredential = new DefaultAzureCredentialBuilder().build();
// for user-assigned managed identity
// DefaultAzureCredential defaultCredential = new DefaultAzureCredentialBuilder()
// .managedIdentityClientId(System.getenv("AZURE_APPCONFIGURATION_CLIENTID"))
// .build();
// for service principal
// ClientSecretCredential defaultCredential = new ClientSecretCredentialBuilder()
// .clientId(System.getenv("AZURE_APPCONFIGURATION_CLIENTID"))
// .clientSecret(System.getenv("AZURE_APPCONFIGURATION_CLIENTSECRET"))
// .tenantId(System.getenv("AZURE_APPCONFIGURATION_TENANTID"))
// .build();
String endpoint = System.getenv("AZURE_APPCONFIGURATION_ENDPOINT");
ConfigurationClient configurationClient = new ConfigurationClientBuilder()
.credential(credential)
.endpoint(endpoint)
.buildClient();
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.
import os
from azure.appconfiguration import AzureAppConfigurationClient
from azure.identity import ManagedIdentityCredential, ClientSecretCredential
# Uncomment the following lines according to the authentication type.
# system-assigned managed identity
# cred = ManagedIdentityCredential()
# user-assigned managed identity
# managed_identity_client_id = os.getenv('AZURE_APPCONFIGURATION_CLIENTID')
# cred = ManagedIdentityCredential(client_id=managed_identity_client_id)
# service principal
# tenant_id = os.getenv('AZURE_APPCONFIGURATION_TENANTID')
# client_id = os.getenv('AZURE_APPCONFIGURATION_CLIENTID')
# client_secret = os.getenv('AZURE_APPCONFIGURATION_CLIENTSECRET')
# cred = ClientSecretCredential(tenant_id=tenant_id, client_id=client_id, client_secret=client_secret)
endpoint_url = os.getenv('AZURE_APPCONFIGURATION_ENDPOINT')
client = AzureAppConfigurationClient(base_url="your_endpoint_url", credential=credential)
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.
import { DefaultAzureCredential,ClientSecretCredential } from "@azure/identity";
const appConfig = require("@azure/app-configuration");
// Uncomment the following lines according to the authentication type.
// for system-assigned managed identity
// const credential = new DefaultAzureCredential();
// for user-assigned managed identity
// const clientId = process.env.AZURE_APPCONFIGURATION_CLIENTID;
// const credential = new DefaultAzureCredential({
// managedIdentityClientId: clientId
// });
// for service principal
// const tenantId = process.env.AZURE_APPCONFIGURATION_TENANTID;
// const clientId = process.env.AZURE_APPCONFIGURATION_CLIENTID;
// const clientSecret = process.env.AZURE_APPCONFIGURATION_CLIENTSECRET;
// const credential = new ClientSecretCredential(tenantId, clientId, clientSecret);
const endpoint = process.env.AZURE_APPCONFIGURATION_ENDPOINT;
const client = new appConfig.AppConfigurationClient(
endpoint,
credential
);
Untuk bahasa lain, Anda dapat menggunakan informasi koneksi yang diatur service Koneksi or ke variabel lingkungan untuk menyambungkan ke Azure App Configuration. Untuk detail variabel lingkungan, lihat Mengintegrasikan Azure App Configuration dengan Service Koneksi or.
Langkah berikutnya
Ikuti tutorial yang tercantum di bawah ini untuk mempelajari lebih lanjut tentang Service Koneksi or.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.