Il server MCP di Azure consente di gestire le risorse di Azure Key Vault, incluse chiavi, segreti e certificati con richieste in linguaggio naturale. Non è necessario ricordare la sintassi dei comandi specializzata per gestire queste risorse.
Azure Key Vault è un servizio cloud per archiviare e accedere in modo sicuro a segreti, chiavi e certificati. Un segreto è qualsiasi elemento a cui si vuole controllare rigorosamente l'accesso, ad esempio chiavi API, password o stringhe di connessione.
Annotazioni
Parametri degli strumenti: gli strumenti del server MCP di Azure definiscono i parametri per i dati necessari per completare le attività. Alcuni di questi parametri sono specifici di ogni strumento e sono documentati qui. Altri parametri sono globali e condivisi da tutti gli strumenti. Per altre informazioni, vedere Parametri degli strumenti.
Amministrazione: recuperare tutte le impostazioni di HSM gestito
Comando CLI di esempio
azmcp keyvault admin settings get \
--vault <vault>
| Parametro |
Type |
Obbligatorio |
Description |
vault |
string |
Yes |
Nome del Key Vault. |
Alcuni prompt di esempio includono:
-
Ottenere le impostazioni dell'account:
- Ottieni le impostazioni dell'account per il mio HSM gestito 'myhsm'
- "Mostra le impostazioni dell'account per il modulo di protezione hardware gestito 'contoso-hsm'"
-
Eseguire una query su un'impostazione specifica: "Qual è il valore dell'impostazione 'purgeProtection' nell'HSM gestito chiamato 'myhsm'"
| Parametro |
Obbligatorio o facoltativo |
Description |
|
Vault |
Obbligatorio |
Nome del Key Vault. |
Suggerimenti per l'annotazione degli strumenti:
| Distruttivo |
Idempotente |
Open World |
Sola lettura |
Secret |
Locale obbligatorio |
| ❌ |
✅ |
❌ |
✅ |
❌ |
❌ |
Chiavi: Crea chiave
Comando CLI di esempio
azmcp keyvault key create \
--key <key> \
--key-type <key-type> \
--vault <vault>
| Parametro |
Type |
Obbligatorio |
Description |
key |
string |
Yes |
Il nome della chiave. |
key-type |
string |
Yes |
Tipo di chiave da creare. Valori validi: RSA, RSA-HSM, EC, EC-HSM. Nota: RSA-HSM e EC-HSM richiedono un insieme di credenziali Premium. |
vault |
string |
Yes |
Nome del Key Vault. |
Alcuni prompt di esempio includono:
-
Creare una chiave RSA: "Creare una nuova chiave RSA denominata 'app-encryption-key' nel mio Key Vault 'mykeyvault'"
-
Generare chiave EC: "Generare una nuova chiave EC chiamata 'signing-key' nel Key Vault 'security-kv'"
-
Aggiungere la chiave di crittografia: "Aggiungere una nuova chiave RSA a 2048 bit denominata 'data-key' all'insieme di credenziali delle chiavi 'mykeyvault'"
-
Configurare la chiave di firma: "Creare una chiave EC denominata 'signing-key' per la firma JWT nell'insieme di credenziali 'mykeyvault'"
-
Creare una nuova chiave: "Creare una chiave EC P-256 denominata 'jwt-signing' nella cassaforte di chiavi 'api-vault'"
| Parametro |
Obbligatorio o facoltativo |
Description |
|
Vault |
Obbligatorio |
Nome del Key Vault. |
|
Nome chiave |
Obbligatorio |
Nome della chiave da creare. |
|
Tipo di chiave |
Obbligatorio |
Tipo di chiave da creare. Valori validi: RSA, EC, RSA-HSM, EC-HSM. Nota: RSA-HSM e EC-HSM richiedono un insieme di credenziali SKU Premium. |
Suggerimenti per l'annotazione degli strumenti:
| Distruttivo |
Idempotente |
Open World |
Sola lettura |
Secret |
Locale obbligatorio |
| ✅ |
❌ |
❌ |
❌ |
❌ |
❌ |
Chiavi: Ottenere o elencare le chiavi
Comando CLI di esempio
azmcp keyvault key get \
--vault <vault> \
[--key <key>] \
[--include-managed <include-managed>]
| Parametro |
Type |
Obbligatorio |
Description |
vault |
string |
Yes |
Nome del Key Vault. |
key |
string |
No |
Nome del tasto. |
include-managed |
string |
No |
Se includere chiavi gestite nei risultati. |
Alcuni prompt di esempio includono:
-
Ottieni dettagli chiave: "Mostrami i dettagli della chiave 'app-encryption-key' nella 'mykeyvault' Key Vault."
-
Visualizzare le informazioni sulla chiave: "Ottenere informazioni sulla 'chiave di firma' in Key Vault 'security-kv'"
-
Elencare tutte le chiavi: "Mostra tutte le chiavi nell'insieme di credenziali delle chiavi "mykeyvault".
-
Visualizzare le chiavi: "Quali chiavi si hanno in Key Vault 'security-kv'?"
-
Recupera chiavi: "Mostra tutte le chiavi gestite incluse nella mia Key Vault 'mykeyvault'"
| Parametro |
Obbligatorio o facoltativo |
Description |
|
Vault |
Obbligatorio |
Nome del Key Vault. |
|
Nome chiave |
Opzionale |
Nome della chiave da recuperare. Ometti di elencare tutte le chiavi. |
|
Includi gestito |
Opzionale |
Indica se includere o meno chiavi gestite durante l'elenco. |
Suggerimenti per l'annotazione degli strumenti:
| Distruttivo |
Idempotente |
Open World |
Sola lettura |
Secret |
Locale obbligatorio |
| ❌ |
✅ |
❌ |
✅ |
❌ |
❌ |
Segreti: Creare un segreto
Comando CLI di esempio
azmcp keyvault secret create \
--secret <secret> \
--value <value> \
--vault <vault>
| Parametro |
Type |
Obbligatorio |
Description |
secret |
string |
Yes |
Nome del segreto. |
value |
string |
Yes |
Valore da impostare per il secret. |
vault |
string |
Yes |
Nome del Key Vault. |
Alcuni prompt di esempio includono:
-
Creare un segreto API: "Crea un segreto chiamato 'api-key' con valore 'xyz123' nel mio key vault chiamato 'production-vault'."
-
Archiviare la password: "Aggiungere un segreto denominato 'database-password' con valore 'myP@ssw0rd' al Key Vault 'security-kv'"
-
Salvare stringa di connessione: "Creare un segreto 'db-connection' con valore 'Server=myserver;Database=mydb' nel key vault 'mykeyvault'"
-
Aggiungere credenziali: "Archiviare il segreto 'sp-secret' con valore 'abc123def456' nella cassaforte delle chiavi 'api-vault'"
| Parametro |
Obbligatorio o facoltativo |
Description |
|
Vault |
Obbligatorio |
Nome del Key Vault. |
|
Nome segreto |
Obbligatorio |
Nome del segreto da creare. |
|
Valore |
Obbligatorio |
Valore del segreto da archiviare. |
Suggerimenti per l'annotazione degli strumenti:
| Distruttivo |
Idempotente |
Open World |
Sola lettura |
Secret |
Locale obbligatorio |
| ✅ |
❌ |
❌ |
❌ |
✅ |
❌ |
Segreti: ottenere o elencare i segreti
Comando CLI di esempio
azmcp keyvault secret get \
--vault <vault> \
[--secret <secret>]
| Parametro |
Type |
Obbligatorio |
Description |
vault |
string |
Yes |
Nome del Key Vault. |
secret |
string |
No |
Il nome del segreto. |
Alcuni prompt di esempio includono:
-
Ottenere un segreto specifico: "Recuperare il segreto "database-connection-string" dall'insieme di credenziali delle chiavi "production-vault".
-
Chiave API di accesso: "Ottieni il segreto 'third-party-api-key' dall'archivio 'api-secrets'"
-
Elenca tutti i segreti: "Mostra tutti i segreti nel mio 'production-vault' Key Vault."
-
Visualizzare i segreti: "Quali segreti si hanno in Key Vault 'api-secrets'?"
-
Trovare segreti: "Elenca i segreti nel mio Key Vault 'configuration-kv'"
| Parametro |
Obbligatorio o facoltativo |
Description |
|
Vault |
Obbligatorio |
Nome del Key Vault. |
|
Nome segreto |
Opzionale |
Nome del segreto da recuperare. Ometti di elencare tutti i segreti. |
Suggerimenti per l'annotazione degli strumenti:
| Distruttivo |
Idempotente |
Open World |
Sola lettura |
Secret |
Locale obbligatorio |
| ❌ |
✅ |
❌ |
✅ |
✅ |
❌ |
Certificati: Creare un certificato
Comando CLI di esempio
azmcp keyvault certificate create \
--certificate <certificate> \
--vault <vault>
| Parametro |
Type |
Obbligatorio |
Description |
certificate |
string |
Yes |
Nome del certificato. |
vault |
string |
Yes |
Nome del Key Vault. |
Alcuni prompt di esempio includono:
-
Creare un certificato SSL: "Crea un certificato denominato 'web-ssl-cert' nell'insieme di credenziali 'production-vault'."
-
Genera il certificato: "Crea un nuovo certificato denominato 'api-tls-cert' nel Key Vault 'security-kv'"
-
Aggiungere il certificato: "Generare un certificato "webapp-cert" per l'applicazione Web nell'insieme di credenziali delle chiavi "mykeyvault"
-
Configurare il certificato TLS: "Creare un certificato denominato 'app-certificate' nel key vault 'mykeyvault'"
-
Creare un nuovo certificato: "Creare un certificato denominato "service-cert" nell'insieme di credenziali delle chiavi 'certificates-vault'"
| Parametro |
Obbligatorio o facoltativo |
Description |
|
Vault |
Obbligatorio |
Nome del Key Vault. |
|
Nome certificato |
Obbligatorio |
Nome del certificato da creare. |
Suggerimenti per l'annotazione degli strumenti:
| Distruttivo |
Idempotente |
Open World |
Sola lettura |
Secret |
Locale obbligatorio |
| ✅ |
❌ |
❌ |
❌ |
❌ |
❌ |
Certificati: ottenere o elencare i certificati
Comando CLI di esempio
azmcp keyvault certificate get \
--vault <vault> \
[--certificate <certificate>]
| Parametro |
Type |
Obbligatorio |
Description |
vault |
string |
Yes |
Nome del Key Vault. |
certificate |
string |
No |
Nome del certificato. |
Alcuni prompt di esempio includono:
-
Ottenere i dettagli del certificato: "Visualizza i dettagli del certificato 'web-ssl-cert' nel 'production-vault' Key Vault."
-
Visualizzare le informazioni sul certificato: "Ottenere informazioni sul certificato 'api-tls-cert' in Key Vault 'security-kv'"
-
Elencare tutti i certificati: "Mostrami tutti i certificati nel mio Key Vault 'production-vault'."
-
Visualizzare i certificati: "Quali certificati si hanno in Key Vault 'security-kv'?"
-
Controllare i certificati: "Quali certificati sono disponibili nel mio 'archivio SSL'?"
| Parametro |
Obbligatorio o facoltativo |
Description |
|
Vault |
Obbligatorio |
Nome del Key Vault. |
|
Nome certificato |
Opzionale |
Nome del certificato da recuperare. Omettere per elencare tutti i certificati. |
Suggerimenti per l'annotazione degli strumenti:
| Distruttivo |
Idempotente |
Open World |
Sola lettura |
Secret |
Locale obbligatorio |
| ❌ |
✅ |
❌ |
✅ |
❌ |
❌ |
Certificati: importare i certificati
Comando CLI di esempio
azmcp keyvault certificate import \
--certificate <certificate> \
--certificate-data <certificate-data> \
--vault <vault> \
[--password <password>]
| Parametro |
Type |
Obbligatorio |
Description |
certificate |
string |
Yes |
Nome del certificato. |
certificate-data |
string |
Yes |
Contenuto del certificato: percorso di un file PFX o PEM, un file PFX con codifica Base64 o un testo PEM non elaborato che inizia con -----BEGIN. |
vault |
string |
Yes |
Nome del Key Vault. |
password |
string |
No |
Password facoltativa per un file PFX protetto da importare. |
Alcuni prompt di esempio includono:
-
Importare il certificato dal file: "Importare il certificato dal file '/path/to/cert.pfx' nel Key Vault 'mykeyvault' come 'web-ssl-cert'".
-
Importare il certificato con nome: "Importare un certificato da '/path/to/cert.pfx' nell'insieme di credenziali delle chiavi 'security-kv' usando il nome 'web-ssl-cert'."
-
Aggiungere il certificato PFX: "Importare un certificato PFX da 'C:\certs\api.pfx' nel Key Vault 'api-vault' come 'api-cert'."
-
Importare il certificato PEM: "Importare un certificato PEM da '/path/to/cert.pem' nell'insieme di credenziali 'prod-vault' denominato 'prod-cert'".
-
Importare un certificato protetto da password: "Importare il certificato 'secure.pfx' nell'insieme di credenziali 'ssl-vault' come 'secure-cert' con password 'mypassword'".
| Parametro |
Obbligatorio o facoltativo |
Description |
|
Vault |
Obbligatorio |
Nome del Key Vault. |
|
Nome certificato |
Obbligatorio |
Nome del certificato visualizzato in Key Vault. |
|
Dati o percorso del certificato |
Obbligatorio |
Percorso di un file PFX o PEM, di un file PFX con codifica Base64 o di un testo PEM non elaborato che inizia con -----BEGIN. |
|
Parola d’ordine |
Opzionale |
Password per un PFX protetto da importare. |
Suggerimenti per l'annotazione degli strumenti:
| Distruttivo |
Idempotente |
Open World |
Sola lettura |
Secret |
Locale obbligatorio |
| ✅ |
❌ |
❌ |
❌ |
❌ |
✅ |
Contenuti correlati