AzureKeyVault@2 - Azure Key Vault v2 görevi

Syntax

# Azure Key Vault v2
# Download Azure Key Vault secrets.
- task: AzureKeyVault@2
  inputs:
    azureSubscription: # string. Alias: ConnectedServiceName. Required. Azure subscription. 
    KeyVaultName: # string. Required. Key vault. 
    SecretsFilter: '*' # string. Required. Secrets filter. Default: *.
    #RunAsPreJob: false # boolean. Make secrets available to whole job. Default: false.

Girişler

Görev denetimi seçenekleri

Tüm görevlerin, görev girişlerine ek olarak denetim seçenekleri vardır. Daha fazla bilgi için bkz . Denetim seçenekleri ve ortak görev özellikleri.

Çıkış değişkenleri

Açıklamalar

Sürüm 2.0'daki yenilikler: Gizli dizilerde %3B, %5B desteği eklendi.

Kimlik doğrulama anahtarları, depolama hesabı anahtarları, veri şifreleme anahtarları gibi gizli dizileri indirmek için bu görevi kullanın. Bir Azure Key Vault örneğinden PFX dosyaları ve parolaları. Görev, kasadan gizli dizilerin tümünün veya bir alt kümesinin en son değerlerini getirmek ve bunları bir işlem hattının sonraki görevlerinde kullanılabilecek değişkenler olarak ayarlamak için kullanılabilir. Görev Düğüm tabanlıdır ve Linux, macOS ve Windows'da aracılarla çalışır.

Azure Key Vault kimlik bilgilerini alma noktasında işlem hatlarında hata forbidden alıyorum

Azure anahtar kasasında gerekli izinler eksikse bu durum oluşur. Sorunu çözmek için doğru izinlere sahip bir erişim ilkesi ekleyin.

Ön koşullar

Görev aşağıdaki Önkoşullara sahiptir:

• Azure Resource Manager hizmeti bağlantısını kullanarak Azure Pipelines veya Team Foundation Server'a bağlı bir Azure aboneliği.
• Gizli dizileri içeren bir Azure Key Vault.

Bir anahtar kasası oluşturabilirsiniz:

• Azure portal
• Azure PowerShell kullanarak
• Azure CLI kullanarak

Anahtar kasasına gizli diziler ekleme:

• Set-AzureKeyVaultSecret PowerShell cmdlet'ini kullanarak. Gizli dizi yoksa, bu cmdlet onu oluşturur. Gizli dizi zaten varsa, bu cmdlet bu gizli dizinin yeni bir sürümünü oluşturur.

• Azure CLI kullanarak. Anahtar kasasına gizli dizi eklemek için, örneğin PlaceholderPassword değerine sahip SQLPassword adlı gizli diziyi yazın:

  az keyvault secret set --vault-name 'ContosoKeyVault' --name 'SQLPassword' --value 'PlaceholderPassword'
  

Gizli dizilere erişmek istediğinizde:

• Azure hizmet bağlantısının kasada en az Alma ve Listeleme izinlerine sahip olduğundan emin olun. Bu izinleri Azure portal ayarlayabilirsiniz:

  • Kasanın Ayarlar dikey penceresini açın, Erişim ilkeleri'ni ve ardından Yeni ekle'yi seçin.
  • Erişim ilkesi ekle dikey penceresinde Sorumlu seç'i seçin ve istemci hesabınız için hizmet sorumlusunu seçin.
  • Erişim ilkesi ekle dikey penceresinde Gizli dizi izinleri'ni seçin ve Al ve Liste seçeneğinin işaretlendiğinden (işaretlendiğinden) emin olun.
  • Değişiklikleri kaydetmek için Tamam'ı seçin.

Kasadan getirilen değer bir sertifikaysa (örneğin, pfx dosyası), görev değişkeni PFX'in içeriğini dize biçiminde içerir. PfX dosyasını görev değişkeninden almak için aşağıdaki PowerShell kodunu kullanabilirsiniz:

$kvSecretBytes = [System.Convert]::FromBase64String("$(PfxSecret)")
$certCollection = New-Object System.Security.Cryptography.X509Certificates.X509Certificate2Collection
$certCollection.Import($kvSecretBytes,$null,[System.Security.Cryptography.X509Certificates.X509KeyStorageFlags]::Exportable)

Sertifika dosyası makinede yerel olarak depolanacaksa, parolayla şifrelemek iyi bir uygulamadır:

 #Get the file created
$password = 'your password'
$protectedCertificateBytes = $certCollection.Export([System.Security.Cryptography.X509Certificates.X509ContentType]::Pkcs12, $password)
$pfxPath = [Environment]::GetFolderPath("Desktop") + "\MyCert.pfx"
[System.IO.File]::WriteAllBytes($pfxPath, $protectedCertificateBytes)

Daha fazla bilgi için bkz. Azure Key Vault sertifikalarını kullanmaya başlama.

Gereksinimler