Bu hızlı başlangıç, Azure Hizmetleri'nde kullanıcının kimliğini doğrulamak için Azure PowerShell ile Azure Kimlik kitaplığını kullanmaktır. Geliştiriciler, çağrılarının kimliğini doğrulamak için Visual Studio veya Visual Studio Code da kullanabilir. Daha fazla bilgi için bkz . Azure Identity istemci kitaplığıyla istemcinin kimliğini doğrulama.
Azure'da oturum açma
Connect-AzAccount komutunu çalıştırın.
Connect-AzAccount
PowerShell varsayılan tarayıcınızı açabiliyorsa bunu yapar ve bir Azure oturum açma sayfası yükler.
Aksi takdirde adresinde bir tarayıcı sayfası https://aka.ms/devicelogin açın ve terminalinizde görüntülenen yetkilendirme kodunu girin.
Tarayıcıda hesabınızın kimlik bilgileriyle oturum açın.
Anahtar kasanıza erişim izni verme
Rol Tabanlı Erişim Denetimi (RBAC) aracılığıyla uygulamanıza anahtar kasanıza izin vermek için az role assignment create Azure CLI komutunu kullanarak bir rol atayın.
az role assignment create --role "Key Vault Secrets User" --assignee "<app-id>" --scope "/subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/Microsoft.KeyVault/vaults/<your-unique-keyvault-name>"
Rol Tabanlı Erişim Denetimi (RBAC) aracılığıyla uygulamanıza anahtar kasanıza izin vermek için New-AzRoleAssignment Azure PowerShell cmdlet'ini kullanarak bir rol atayın.
New-AzRoleAssignment -ObjectId "<app-id>" -RoleDefinitionName "Key Vault Secrets User" -Scope "/subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/Microsoft.KeyVault/vaults/<your-unique-keyvault-name>"
, <subscription-id>ve <resource-group-name> <your-unique-keyvault-name> değerlerini gerçek değerlerinizle değiştirin<app-id>. <app-id> , Microsoft Entra'da kayıtlı uygulamanızın Uygulama (istemci) kimliğidir.
Yeni .NET konsol uygulaması oluşturma
Komut kabuğunda aşağıdaki komutu çalıştırarak adlı key-vault-console-appbir proje oluşturun:
dotnet new console --name key-vault-console-app
Yeni oluşturulan key-vault-console-app dizinine geçin ve projeyi oluşturmak için aşağıdaki komutu çalıştırın:
dotnet build
Derleme çıkışı hiçbir uyarı veya hata içermemelidir.
Build succeeded.
0 Warning(s)
0 Error(s)
Paketleri yükleme
Komut kabuğundan .NET için Azure Key Vault gizli istemci kitaplığını yükleyin:
dotnet add package Azure.Security.KeyVault.Secrets
Bu hızlı başlangıç için Azure Identity istemci kitaplığını da yüklemeniz gerekir:
dotnet add package Azure.Identity
Ortam değişkenlerini belirleme
Bu uygulama anahtar kasası adını adlı KEY_VAULT_NAMEbir ortam değişkeni olarak kullanıyor.
Windows
set KEY_VAULT_NAME=<your-key-vault-name>
Windows PowerShell
$Env:KEY_VAULT_NAME="<your-key-vault-name>"
macOS veya Linux
export KEY_VAULT_NAME=<your-key-vault-name>
Nesne modeli
.NET için Azure Key Vault gizli istemci kitaplığı gizli dizileri yönetmenize olanak tanır. Kod örnekleri bölümünde istemci oluşturma, gizli dizi ayarlama, gizli dizi alma ve gizli dizi silme işlemi gösterilir.
Kod örnekleri
Yönerge ekleme
aşağıdaki yönergeleri Program.cs en üstüne ekleyin:
using System;
using Azure.Identity;
using Azure.Security.KeyVault.Secrets;
Kimlik doğrulaması yapma ve istemci oluşturma
Çoğu Azure hizmeti için uygulama istekleri yetkilendirilmelidir. Azure Identity istemci kitaplığı tarafından sağlanan DefaultAzureCredential sınıfının kullanılması, kodunuzda Azure hizmetlerine parolasız bağlantılar uygulamak için önerilen yaklaşımdır. DefaultAzureCredential birden çok kimlik doğrulama yöntemini destekler ve çalışma zamanında hangi yöntemin kullanılacağını belirler. Bu yaklaşım, uygulamanızın ortama özgü kod uygulamadan farklı ortamlarda (yerel ve üretim) farklı kimlik doğrulama yöntemleri kullanmasını sağlar.
Bu hızlı başlangıçta, DefaultAzureCredential Azure CLI'da oturum açmış yerel geliştirme kullanıcısının kimlik bilgilerini kullanarak anahtar kasasında kimlik doğrulaması yapar. Uygulama Azure'a dağıtıldığında, aynı DefaultAzureCredential kod App Service, Sanal Makine veya diğer hizmetlere atanan yönetilen kimliği otomatik olarak bulabilir ve kullanabilir. Daha fazla bilgi için bkz . Yönetilen Kimliğe Genel Bakış.
Bu örnekte, anahtar kasanızın adı biçiminde https://<your-key-vault-name>.vault.azure.netanahtar kasası URI'sine genişletilir. Anahtar kasasında kimlik doğrulaması hakkında daha fazla bilgi için bkz . Geliştirici Kılavuzu.
string keyVaultName = Environment.GetEnvironmentVariable("KEY_VAULT_NAME");
var kvUri = "https://" + keyVaultName + ".vault.azure.net";
var client = new SecretClient(new Uri(kvUri), new DefaultAzureCredential());
Gizli dizi kaydetme
Konsol uygulamasının kimliği doğrulandıktan sonra anahtar kasasına bir gizli dizi ekleyin. Bu görev için SetSecretAsync yöntemini kullanın.
Yöntemin ilk parametresi gizli dizi için bir ad kabul eder. Bu örnekte değişkeni secretName "mySecret" dizesini depolar.
Yöntemin ikinci parametresi gizli dizi için bir değer kabul eder. Bu örnekte gizli dizi, kullanıcı tarafından komut satırı aracılığıyla giriş yapılır ve değişkeninde secretValuedepolanır.
await client.SetSecretAsync(secretName, secretValue);
Not
Gizli dizi adı varsa, kod bu gizli dizinin yeni sürümünü oluşturur.
Gizli dizi alma
Şimdi GetSecretAsync yöntemiyle önceden ayarlanmış değeri alabilirsiniz.
var secret = await client.GetSecretAsync(secretName);
Gizli diziniz olarak kaydedilir secret.Value.
Gizli anahtarı silme
Son olarak, StartDeleteSecretAsync ve PurgeDeletedSecretAsync yöntemleriyle anahtar kasanızdan gizli diziyi silelim.
var operation = await client.StartDeleteSecretAsync(secretName);
// You only need to wait for completion if you want to purge or recover the key.
await operation.WaitForCompletionAsync();
await client.PurgeDeletedSecretAsync(secretName);
Örnek kod
Aşağıdaki adımları tamamlayarak .NET konsol uygulamasını Key Vault ile etkileşim kuracak şekilde değiştirin:
Program.cs içindeki kodu aşağıdaki kodla değiştirin:
using System;
using System.Threading.Tasks;
using Azure.Identity;
using Azure.Security.KeyVault.Secrets;
namespace key_vault_console_app
{
class Program
{
static async Task Main(string[] args)
{
const string secretName = "mySecret";
var keyVaultName = Environment.GetEnvironmentVariable("KEY_VAULT_NAME");
var kvUri = $"https://{keyVaultName}.vault.azure.net";
var client = new SecretClient(new Uri(kvUri), new DefaultAzureCredential());
Console.Write("Input the value of your secret > ");
var secretValue = Console.ReadLine();
Console.Write($"Creating a secret in {keyVaultName} called '{secretName}' with the value '{secretValue}' ...");
await client.SetSecretAsync(secretName, secretValue);
Console.WriteLine(" done.");
Console.WriteLine("Forgetting your secret.");
secretValue = string.Empty;
Console.WriteLine($"Your secret is '{secretValue}'.");
Console.WriteLine($"Retrieving your secret from {keyVaultName}.");
var secret = await client.GetSecretAsync(secretName);
Console.WriteLine($"Your secret is '{secret.Value.Value}'.");
Console.Write($"Deleting your secret from {keyVaultName} ...");
DeleteSecretOperation operation = await client.StartDeleteSecretAsync(secretName);
// You only need to wait for completion if you want to purge or recover the secret.
await operation.WaitForCompletionAsync();
Console.WriteLine(" done.");
Console.Write($"Purging your secret from {keyVaultName} ...");
await client.PurgeDeletedSecretAsync(secretName);
Console.WriteLine(" done.");
}
}
}
Test edin ve doğrulayın
Uygulamayı çalıştırmak için aşağıdaki komutu yürütebilirsiniz.
dotnet run
İstendiğinde bir gizli dizi değeri girin. Örneğin, mySecretPassword.
Aşağıdaki çıkışın bir varyasyonu görüntülenir:
Input the value of your secret > mySecretPassword
Creating a secret in <your-unique-keyvault-name> called 'mySecret' with the value 'mySecretPassword' ... done.
Forgetting your secret.
Your secret is ''.
Retrieving your secret from <your-unique-keyvault-name>.
Your secret is 'mySecretPassword'.
Deleting your secret from <your-unique-keyvault-name> ... done.
Purging your secret from <your-unique-keyvault-name> ... done.
Sonraki adımlar
Key Vault ve uygulamalarınızla tümleştirme hakkında daha fazla bilgi edinmek için aşağıdaki makalelere bakın: