AzureKeyVault@2 - Azure Key Vault v2 작업

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.

입력

작업 제어 옵션

모든 작업에는 작업 입력 외에 제어 옵션이 있습니다. 자세한 내용은 컨트롤 옵션 및 일반적인 작업 속성을 참조하세요.

출력 변수

설명

버전 2.0의 새로운 기능: 비밀에서 %3B, %5D에 대한 지원이 추가되었습니다.

인증 키, 스토리지 계정 키, 데이터 암호화 키, 와 같은 비밀을 다운로드하려면 이 작업을 사용합니다. AZURE Key Vault 인스턴스의 PFX 파일 및 암호입니다. 태스크를 사용하여 자격 증명 모음에서 비밀의 전체 또는 하위 집합의 최신 값을 가져와서 파이프라인의 후속 작업에 사용할 수 있는 변수로 설정할 수 있습니다. 작업은 노드 기반이며 Linux, macOS 및 Windows의 에이전트에서 작동합니다.

forbidden Azure Key Vault 자격 증명을 가져오는 시점에 파이프라인에 오류가 발생합니다.

Azure 키 자격 증명 모음에 필요한 권한이 없는 경우 이 문제가 발생합니다. 이 문제를 해결하려면 올바른 권한이 있는 액세스 정책을 추가합니다.

사전 요구 사항

작업에는 다음과 같은 필수 구성 요소가 있습니다.

• Azure Resource Manager 서비스 연결을 사용하여 Azure Pipelines 또는 Team Foundation Server에 연결된 Azure 구독입니다.
• 암호를 포함한 Azure Key Vault

키 자격 증명 모음을 만들 수 있습니다.

• Azure Portal에서
• Azure PowerShell 사용
• Azure CLI 사용

키 자격 증명 모음에 비밀을 추가합니다.

• PowerShell cmdlet Set-AzureKeyVaultSecret을 사용합니다. 비밀이 없으면 이 cmdlet이 만듭니다. 비밀이 이미 있는 경우 이 cmdlet은 해당 비밀의 새 버전을 만듭니다.

• Azure CLI 사용 키 자격 증명 모음에 비밀을 추가하려면(예: 값이 PlaceholderPassword인 SQLPassword라는 비밀) 다음을 입력합니다.

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

비밀에 액세스하려는 경우:

• Azure 서비스 연결에 자격 증명 모음에 대한 가져오기 및 나열 권한 이상이 있는지 확인합니다. Azure Portal 다음 권한을 설정할 수 있습니다.

  • 자격 증명 모음에 대한 설정 블레이드를 열고 액세스 정책을 선택한 다음, 새로 추가를 선택합니다.
  • 액세스 정책 추가 블레이드에서 보안 주체 선택을 선택하고 클라이언트 계정에 대한 서비스 주체를 선택합니다.
  • 액세스 정책 추가 블레이드에서 비밀 권한을 선택하고 가져오기 및 목록이 선택되어 있는지 확인합니다(선택됨).
  • 확인을 선택하여 변경 내용을 저장합니다.

자격 증명 모음에서 가져온 값이 인증서(예: PFX 파일)인 경우 작업 변수에는 문자열 형식의 PFX 내용이 포함됩니다. 다음 PowerShell 코드를 사용하여 작업 변수에서 PFX 파일을 검색할 수 있습니다.

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

인증서 파일이 컴퓨터에 로컬로 저장되는 경우 암호를 사용하여 암호화하는 것이 좋습니다.

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

자세한 내용은 Azure Key Vault 인증서 시작을 참조하세요.

요구 사항