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
- Aprire il portale di Microsoft Azure usando il collegamento: https://ms.portal.azure.com/.
- 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".
- 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
- I certificati con estensione *.pfx possono essere caricati in Azure Key Vault usando uno script di PowerShell.
- Installare il modulo AzureRM per PowerShell seguendo questa istruzione: https://learn.microsoft.com/ru-ru/powershell/azure/install-azurerm-ps?view=azurermps-5.4.0
- Eseguire uno script in PowerShell come nell'esempio seguente:
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
- 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
- Fare clic sul pulsante "Dashboard" nel pannello sinistro per vedere l'insieme di credenziali delle chiavi creato in precedenza.
- 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.
- Fai clic sul riquadro "Segreti".
- 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".
- È 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.
- Aprire il portale legacy https://manage.windowsazure.com/.
- Fai clic su "Azure Active Directory" dal pannello di sinistra e seleziona il tuo.
- In Active Directory aperta scegliere la scheda "Registrazione app".
- Fare clic sul pulsante "Registrazione nuova applicazione" nel pannello inferiore per creare una nuova voce di applicazione.
- 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.
- Fai clic sul pulsante "Crea".
Configurare l'applicazione
- Aprire la scheda "Registrazioni app".
- Trova un'applicazione appropriata. Il campo "ID applicazione" ha lo stesso valore del parametro del client Key< Vault>.
- Fare clic sul pulsante "Impostazioni", quindi aprire la scheda "Chiavi".
- 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.
- 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.
- Tornare al portale di Microsoft Azure (https://ms.portal.azure.com/),
- Aprire l'archivio dell'insieme di credenziali delle chiavi e fare clic sul riquadro "Criteri di accesso".
- 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".
- 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.