Adicionar um certificado de aplicação a um cluster do Service Fabric

Artigo
03/25/2023

Este script de exemplo explica como criar um certificado no Key Vault e, em seguida, implementá-lo num dos conjuntos de dimensionamento de máquinas virtuais em que o cluster é executado. Este cenário não utiliza diretamente o Service Fabric, mas depende de Key Vault e de conjuntos de dimensionamento de máquinas virtuais.

Nota

Recomendamos que utilize o módulo do Azure Az PowerShell para interagir com o Azure. Veja Instalar o Azure PowerShell para começar. Para saber como migrar para o módulo do Az PowerShell, veja Migrar o Azure PowerShell do AzureRM para o Az.

Se necessário, instale o Azure PowerShell com a instrução encontrada no guia de Azure PowerShell e, em seguida, execute Connect-AzAccount para criar uma ligação com o Azure.

Criar um certificado no Key Vault

$VaultName = ""
$CertName = ""
$SubjectName = "CN="

$policy = New-AzKeyVaultCertificatePolicy -SubjectName $SubjectName -IssuerName Self -ValidityInMonths 12
Add-AzKeyVaultCertificate -VaultName $VaultName -Name $CertName -CertificatePolicy $policy

Em alternativa, carregue um certificado existente para Key Vault

$VaultName= ""
$CertName= ""
$CertPassword= ""
$PathToPFX= ""

$bytes = [System.IO.File]::ReadAllBytes($PathToPFX)
$base64 = [System.Convert]::ToBase64String($bytes)
$jsonBlob = @{
   data = $base64
   dataType = 'pfx'
   password = $CertPassword
   } | ConvertTo-Json
$contentbytes = [System.Text.Encoding]::UTF8.GetBytes($jsonBlob)
$content = [System.Convert]::ToBase64String($contentbytes)

$SecretValue = ConvertTo-SecureString -String $content -AsPlainText -Force

# Upload the certificate to the key vault as a secret
$Secret = Set-AzKeyVaultSecret -VaultName $VaultName -Name $CertName -SecretValue $SecretValue

Atualizar o perfil dos conjuntos de dimensionamento de máquinas virtuais com o certificado

$ResourceGroupName = ""
$VMSSName = ""
$CertStore = "My" # Update this with the store you want your certificate placed in, this is LocalMachine\My

# If you have added your certificate to the keyvault certificates, use
$CertConfig = New-AzVmssVaultCertificateConfig -CertificateUrl (Get-AzKeyVaultCertificate -VaultName $VaultName -Name $CertName).SecretId -CertificateStore $CertStore

# Otherwise, if you have added your certificate to the keyvault secrets, use
$CertConfig = New-AzVmssVaultCertificateConfig -CertificateUrl (Get-AzKeyVaultSecret -VaultName $VaultName -Name $CertName).Id -CertificateStore $CertStore

$VMSS = Get-AzVmss -ResourceGroupName $ResourceGroupName -VMScaleSetName $VMSSName

# If this KeyVault is already known by the virtual machine scale set, for example if the cluster certificate is deployed from this keyvault, use
$VMSS.virtualmachineprofile.osProfile.secrets[0].vaultCertificates.Add($CertConfig)

# Otherwise use
$VMSS = Add-AzVmssSecret -VirtualMachineScaleSet $VMSS -SourceVaultId (Get-AzKeyVault -VaultName $VaultName).ResourceId  -VaultCertificate $CertConfig

Atualizar o conjunto de dimensionamento de máquinas virtuais

Update-AzVmss -ResourceGroupName $ResourceGroupName -VirtualMachineScaleSet $VMSS -VMScaleSetName $VMSSName

Se quiser que o certificado seja colocado em vários tipos de nós no cluster, a segunda e terceira partes deste script devem ser repetidas para cada tipo de nó que deve ter o certificado.

Explicação do script

Este script utiliza os seguintes comandos: cada comando na tabela está ligado a documentação específica do comando.

Comando	Notas
New-AzKeyVaultCertificatePolicy	Cria uma política dentro da memória que representa o certificado
Add-AzKeyVaultCertificate	Implementa a política para Key Vault Certificados
Set-AzKeyVaultSecret	Implementa a política para Key Vault Segredos
New-AzVmssVaultCertificateConfig	Cria uma configuração dentro da memória que representa o certificado numa VM
Get-AzVmss
Add-AzVmssSecret	Adiciona o certificado à definição dentro da memória do conjunto de dimensionamento de máquinas virtuais
Update-AzVmss	Implementa a nova definição do conjunto de dimensionamento de máquinas virtuais

Passos seguintes

Para obter mais informações sobre o módulo do Azure PowerShell, veja Documentação do Azure PowerShell.

Podem ser encontrados exemplos de Azure PowerShell adicionais para o Azure Service Fabric nos exemplos de Azure PowerShell.