Configurazione dei certificati per l'interfaccia della riga di comando di Azure nell'hub di Azure Stack o in Azure Stack Development Kit

1. Trovare il percorso del certificato nel computer. Il percorso può variare a seconda della posizione in cui è stato installato Python.

2. Per trovare il percorso, aprire un prompt cmd o un prompt di PowerShell con privilegi elevati e digitare: az --version. La versione e il percorso python vengono visualizzati nel prompt.

   azure-cli                         2.30.0
   
   core                              2.30.0
   telemetry                          1.0.6
   
   Python location 'C:\Program Files (x86)\Microsoft SDKs\Azure\CLI2\python.exe'
   Extensions directory 'C:\Users\username\.azure\cliextensions'
   
   Python (Windows) 3.8.9 (tags/v3.8.9:a743f81, Apr  6 2021, 13:22:56) [MSC v.1928 32 bit (Intel)]
   
   Legal docs and information: aka.ms/AzureCliLegal
   
   Your CLI is up-to-date.
   
   Please let us know how we are doing: https://aka.ms/azureclihats
   and let us know if you're interested in trying out our newest features: https://aka.ms/CLIUXstudy
   

3. Passare alla directory in cui è installata l'interfaccia della riga di comando di Azure. Ad esempio, usando il percorso nel passaggio 2, cd "C:\Program Files (x86)\Microsoft SDKs\Azure\CLI2\.

4. Digitare il comando seguente:

   .\python -c "import certifi; print(certifi.where())"
   

   Verrà restituito il percorso del percorso del certificato nel computer. Il percorso specifico dipende dal sistema operativo e dalla versione di Python installata. Ad esempio:

   C:\Program Files (x86)\Microsoft SDKs\Azure\CLI2\lib\site-packages\certifi\cacert.pem
   

   Prendere nota del percorso del certificato. Il percorso verrà usato nel passaggio successivo.

5. Considerare attendibile il certificato radice della CA dell'hub di Azure Stack aggiungendolo al certificato Python esistente.

   $cerFile = "<Fully qualified path to the cer certificate exported from `
   your Azure Stack Hub and saved. For example: C:\Users\user1\Downloads\root.cer"
   $pythonCertStore = <result from step 4>
   
   $cerDir = Split-Path -Parent $cerFile
   $pemFile = "$cerDir\root.pem"
   Write-Host "Converting certificate to PEM format at $pemFile"
   certutil -encode $cerFile $pemFile
   $root = New-Object System.Security.Cryptography.X509Certificates.X509Certificate2
   $root.Import($pemFile)
   
   # X509Certificate2.Thumbprint calculates SHA1 hash of the public key. You can get sha1 of the pem file by using openssl, 
   # e.g. openssl x509 -noout -fingerprint -sha1 -inform pem -in ./root.pem
   # Alternatively, 'Get-FileHash' gives the same value (without ':') for the corresponding cer file
   # Since the thumbprint is a unique value for the certificate, it is commonly used to find a particular certificate in a certificate store
   Write-Host "Extracting required information from the cert file"
   $md5Hash    = (Get-FileHash -Path $cerFile -Algorithm MD5).Hash.ToLower()
   $sha1Hash   = (Get-FileHash -Path $cerFile -Algorithm SHA1).Hash.ToLower()
   $sha256Hash = (Get-FileHash -Path $cerFile -Algorithm SHA256).Hash.ToLower()
   
   $issuerEntry  = [string]::Format("# Issuer: {0}", $root.Issuer)
   $subjectEntry = [string]::Format("# Subject: {0}", $root.Subject)
   $labelEntry   = [string]::Format("# Label: {0}", $root.Subject.Split('=')[-1])
   $serialEntry  = [string]::Format("# Serial: {0}", $root.GetSerialNumberString().ToLower())
   $md5Entry     = [string]::Format("# MD5 Fingerprint: {0}", $md5Hash)
   $sha1Entry    = [string]::Format("# SHA1 Fingerprint: {0}", $sha1Hash)
   $sha256Entry  = [string]::Format("# SHA256 Fingerprint: {0}", $sha256Hash)
   $certText = (Get-Content -Path $pemFile -Raw).ToString().Replace("`r`n","`n")
   
   $rootCertEntry = "`n" + $issuerEntry + "`n" + $subjectEntry + "`n" + $labelEntry + "`n" + `
   $serialEntry + "`n" + $md5Entry + "`n" + $sha1Entry + "`n" + $sha256Entry + "`n" + $certText
   
   Write-Host "Adding the certificate content to Python Cert store"
   Add-Content $pythonCertStore $rootCertEntry
   
   Write-Host "Python Cert store was updated to allow the Azure Stack Hub CA root certificate"
   

Per istruzioni sull'installazione e la connessione con l'interfaccia della riga di comando di Azure, vedere Installare l'interfaccia della riga di comando di Azure nell'hub di Azure Stack.

Quando si configura l'interfaccia della riga di comando, considerare attendibile il certificato radice della CA dell'hub di Azure Stack aggiungendolo al certificato Python esistente.

1. Trovare il percorso del certificato nel computer. Il percorso può variare a seconda della posizione in cui è stato installato Python. È necessario che pip e il modulo certificato siano installati. Usare il comando Python seguente dal prompt di bash:

   az --version
   

   Prendere nota del percorso del certificato. Ad esempio: ~/lib/python3.5/site-packages/certifi/cacert.pem. Il percorso specifico dipende dal sistema operativo e dalla versione di Python installata.

2. Eseguire il comando bash seguente con il percorso del certificato.

   • Per un computer Linux remoto:

     sudo cat PATH_TO_PEM_FILE >> ~/<yourpath>/cacert.pem
     

   • Per un computer Linux all'interno dell'ambiente hub di Azure Stack:

     sudo cat /var/lib/waagent/Certificates.pem >> ~/<yourpath>/cacert.pem
     

Per istruzioni su Installazione e connessione con l'interfaccia della riga di comando di Azure, vedere Installare l'interfaccia della riga di comando di Azure nell'hub di Azure Stack.