Manutenzione dell'archiviazione di Azure Key Vault

Si applica a
Dynamics 365 for Finance and Operations Microsoft Dynamics 365 for Financials

Panoramica

I dati sensibili per l'azienda vengono in genere usati in modo sicuro. Significa che una funzionalità o un'applicazione che lavora con questi dati deve supportare la crittografia dei dati, l'uso dei certificati e così via. Poiché la versione cloud di Microsoft Dynamics 365 for Finance and Operations non supporta un'archiviazione locale dei certificati, i clienti devono usare un'archiviazione dell'insieme di credenziali delle chiavi in questo caso. Azure Key Vault offre l'opportunità di importare chiavi crittografiche, certificati in Azure e di gestirli. Altre informazioni su Azure Key Vault: Che cos'è Azure Key Vault.

I dati seguenti sono necessari per definire l'integrazione tra Microsoft Dynamics 365 for Finance and Operations e Azure Key Vault:

  • URL dell'insieme di credenziali delle chiavi (nome DNS),
  • ID client (identificatore dell'applicazione),
  • Elenco dei certificati con i relativi nomi,
  • Chiave segreta (valore chiave).

Di seguito è disponibile una descrizione dettagliata dei passaggi di configurazione:

Creare uno spazio di archiviazione Key Vault

  1. Aprire il portale di Microsoft Azure usando il collegamento: https://ms.portal.azure.com/.
  2. Fai clic sul pulsante "Crea una risorsa" nel pannello di sinistra per creare una nuova risorsa. Scegliere il gruppo "Sicurezza + identità" e il tipo di risorsa "Key Vault".
  3. Viene aperta la pagina "Crea insieme di credenziali delle chiavi". Qui è necessario definire i parametri di archiviazione dell'insieme di credenziali delle chiavi e quindi fare clic sul pulsante "Crea":
  • Specificare il "nome" dell'insieme di credenziali delle chiavi. Questo parametro viene indicato in "Configurazione del client Azure Key Vault" come <KeyVaultName>.
  • Seleziona il tuo abbonamento.
  • Scegli un gruppo di risorse. È come una directory interna all'interno dell'archivio dell'insieme di credenziali delle chiavi. È possibile usare un gruppo di risorse esistente o crearne uno nuovo.
  • Seleziona la tua posizione.
  • Seleziona un piano tariffario.
  • Fai clic su "Crea".
  • Aggiungere l'insieme di credenziali delle chiavi creato al dashboard.

Caricare un certificato

La procedura di caricamento nell'archiviazione dell'insieme di credenziali delle chiavi dipende dal tipo di certificato.

Importazione dei certificati *.pfx

  1. I certificati con estensione *.pfx possono essere caricati in Azure Key Vault usando uno script di PowerShell.

Connect-AzAccount

$pfxFilePath = '<Localpath>'

$pwd = ''

$secretName = '<name>'

$keyVaultName = '<keyvault>'

$collection = New-ObjectSystem.Security.Cryptography.X509Certificates.X509Certificate2Collection

$collection. Import($pfxFilePath, $pwd,[System.Security.Cryptography.X509Certificates.X509KeyStorageFlags]::Exportable)

$pkcs 12ContentType =[System.Security.Cryptography.X509Certificates.X509ContentType]::P kcs12

$clearBytes = $collection. Export($pkcs 12ContentType)

$fileContentEncoded = [System.Convert]::ToBase64String($clearBytes)

$secret = ConvertTo-SecureString -String $fileContentEncoded -AsPlainText –Force

$secretContentType = 'application/x-pkcs12'

Set-AzKeyVaultSecret -VaultName $keyVaultName -Name $secretName -SecretValue $Secret -ContentType $secretContentType

Dove:

<Localpath> - percorso locale del file con certificato, ad esempio C:\<smth.pfx>

<Nome> - nome del certificato, ad esempio <SMTH>

<keyvault> - nome dell'archiviazione dell'insieme di credenziali delle chiavi

Se è necessaria la password, aggiungerla al tag $pwd

  1. Impostare un tag per il certificato caricato in Azure Key Vault.
  • Nel portale di Microsoft Azure fare clic sul pulsante "Dashboard"* e selezionare l'insieme di credenziali delle chiavi appropriato per aprirlo.
  • Fai clic sul riquadro "Segreti".
  • Trovare un segreto appropriato in base al nome del certificato e aprirlo.
  • Apri la scheda "Tag".
  • Impostare il nome del tag = "type" e il valore del tag = "certificate".

Nota: Il nome del tag e il valore del tag devono essere racchiusi tra virgolette e in minuscolo.

  • Fare clic sul pulsante OK e salvare il segreto aggiornato.

Importazione degli altri certificati

  1. Fare clic sul pulsante "Dashboard" nel pannello sinistro per vedere l'insieme di credenziali delle chiavi creato in precedenza.
  2. Selezionare l'insieme di credenziali delle chiavi appropriato per aprirlo. La scheda "Panoramica" mostra i parametri essenziali dell'archiviazione dell'insieme di credenziali delle chiavi, incluso il "nome DNS".

Nota: il nome DNS è un parametro obbligatorio per l'integrazione con l'insieme di credenziali delle chiavi, pertanto deve essere specificato nell'applicazione e fatto riferimento in "Configurazione del client Azure Key Vault" come <parametro dell'URL dell'insieme> di credenziali delle chiavi.

  1. Fai clic sul riquadro "Segreti".
  2. Fare clic sul pulsante "Genera/Importa" nella pagina "Segreti" per aggiungere un nuovo certificato all'archivio dell'insieme di credenziali delle chiavi. Sul lato destro della pagina devi definire i parametri del certificato:
  • Selezionare il valore "Manuale" nel campo "Opzioni di caricamento".
  • Immettere il nome del certificato nel campo "Nome".

Nota: il nome segreto è un parametro obbligatorio per l'integrazione con l'insieme di credenziali delle chiavi, pertanto deve essere specificato nell'applicazione. Viene indicato in "Configurazione del client Azure Key Vault" come <parametro SecretName> .

  • Apri un certificato per la modifica e copia tutto il suo contenuto, inclusi i tag di inizio e chiusura.
  • Incollare il contenuto copiato nel campo "Valore".
  • Abilitare il certificato.
  • Premi il pulsante "Crea".
  1. È possibile caricare diverse versioni del certificato e gestirle nell'archivio dell'insieme di credenziali delle chiavi. Se hai bisogno di caricare una nuova versione per un certificato esistente, seleziona un certificato appropriato e fai clic sul pulsante "Nuova versione".

Nota: la versione corrente deve essere definita nell'installazione dell'applicazione ed è indicata in "Configurazione del client Azure Key Vault" come <parametro SecretVersion> .

Creare un punto di accesso per l'applicazione

Creare un punto di ingresso per l'applicazione che usa l'archiviazione dell'insieme di credenziali delle chiavi.

  1. Aprire il portale legacy https://manage.windowsazure.com/.
  2. Fai clic su "Azure Active Directory" dal pannello di sinistra e seleziona il tuo.
  3. In Active Directory aperta scegliere la scheda "Registrazione app".
  4. Fare clic sul pulsante "Registrazione nuova applicazione" nel pannello inferiore per creare una nuova voce di applicazione.
  5. Specificare un "Nome" dell'applicazione e selezionare un tipo appropriato.

Nota: in questa pagina è anche possibile definire l'"URL di accesso", che deve avere un formato http://< AppName>, dove <AppName> è un nome di applicazione specificato nella pagina precedente.  <AppName> deve essere definito nei criteri di accesso per l'archiviazione dell'insieme di credenziali delle chiavi.

  1. Fai clic sul pulsante "Crea".

Configurare l'applicazione

  1. Aprire la scheda "Registrazioni app".
  2. Trova un'applicazione appropriata. Il campo "ID applicazione" ha lo stesso valore del parametro del client Key< Vault>.
  3. Fare clic sul pulsante "Impostazioni", quindi aprire la scheda "Chiavi".
  4. Genera una chiave. Viene usato per un accesso protetto all'archiviazione dell'insieme di credenziali delle chiavi dall'applicazione.
  • Compila il campo "Descrizione".
  • È possibile creare una chiave con un periodo di durata uguale a uno o due anni. Dopo aver fatto clic sul pulsante "Salva" nella parte inferiore della pagina, il valore della chiave diventa visibile.

Nota: il valore della chiave è un parametro obbligatorio per l'integrazione con l'insieme di credenziali delle chiavi. Deve essere copiato e quindi specificato nell'applicazione. Viene citato in "Configurazione del client Azure Key Vault" come <parametro della chiave> segreta di Key Vault.

  1. Copiare il valore di "ID client" dalla configurazione. È necessario specificarlo nell'applicazione e farvi riferimento in "Configurazione del client Azure Key Vault" come <parametro del client> Key Vault.

Aggiungere un'applicazione all'archiviazione dell'insieme di credenziali delle chiavi

Aggiungere l'applicazione all'archivio dell'insieme di credenziali delle chiavi creato in precedenza.

  1. Tornare al portale di Microsoft Azure (https://ms.portal.azure.com/),
  2. Aprire l'archivio dell'insieme di credenziali delle chiavi e fare clic sul riquadro "Criteri di accesso".
  3. Fare clic sul pulsante "Aggiungi nuovo" e scegliere l'opzione "Seleziona preside". Dovresti trovare la tua applicazione in base al nome. Quando l'applicazione viene trovata, fare clic sul pulsante "Seleziona".
  4. Compila il campo "Configura da modello" e fai clic sul pulsante Ok.

Nota: in questa pagina è anche possibile impostare le autorizzazioni per le chiavi, se necessario.