Configurazione dell'istanza di Vault Dedicated
In questo tutorial imparerai come configurare un'istanza del piano " Vault Dedicated " di IBM Cloud® Secrets Manager, effettuando il provisioning dell'istanza, recuperando i relativi endpoint, generando un token di amministrazione
e accedendo all'interfaccia utente di Vault per la configurazione iniziale.
Il piano " Vault Dedicated " offre Vault Enterprise come servizio gestito su IBM Cloud. Una volta che l'istanza è stata configurata, è possibile utilizzare la dashboard dell'istanza per trovare i dettagli di connessione
e aprire l'interfaccia utente di Vault per iniziare a configurare l'ambiente Vault.
Il piano Vault Dedicated è attualmente disponibile in versione beta pubblica. Le funzionalità beta sono fornite a scopo di valutazione e test e presentano alcune limitazioni rispetto alle funzionalità disponibili al pubblico.
Limiti della versione beta pubblica dedicata di Vault
Durante il periodo di beta pubblica, il piano " [Vault Dedicated] "{: tag-green} presenta le seguenti restrizioni temporanee:
- Limite per le istanze: durante la fase beta è consentita una sola istanza di Vault Dedicated per account.
- Nessun percorso di aggiornamento: non è possibile passare dalla versione beta alla versione GA. Tutte le istanze beta verranno eliminate prima del lancio ufficiale.
- Disponibilità a livello regionale: disponibile a Dallas e Francoforte.
- Gratuito durante la fase beta: non sono previsti costi durante il periodo di beta.
- Migrazione dalla versione beta alla versione GA: la migrazione dei dati dalle istanze beta alle istanze GA non è supportata.
Queste limitazioni sono temporanee e valgono solo durante il periodo della beta pubblica. Verrà rimosso o modificato quando il piano " Vault Dedicated " sarà disponibile al pubblico.
Prima di iniziare
Prima di iniziare, assicurati di disporre di un account IBM Cloud e dei permessi IAM necessari per utilizzare il servizio.
Sono necessari i seguenti ruoli:
- Il ruolo di servizio “Manager ” per configurare un’istanza e generare un token di amministratore.
- Il ruolo di servizio “Autore”, “Lettore” o “Spettatore” per visualizzare i dettagli dell’istanza.
Configurare un'istanza del piano Vault Dedicated
Creare un'istanza del piano " Vault Dedicated " dal catalogo " IBM Cloud ".
-
Nella console di IBM Cloud, accedi al Catalogo.
-
Seleziona Secrets Manager.
-
Scegli il piano Vault Dedicated.
-
Configurare l'istanza:
- Seleziona una regione di distribuzione.
- Inserisci un nome univoco per l'istanza.
- Seleziona un gruppo di risorse.
- Scegliere tra la crittografia gestita dal servizio e quella gestita dal cliente utilizzando Key Protect.
- Selezionare endpoint esclusivamente privati oppure, se necessario, abilitare un endpoint pubblico.
Se si selezionano endpoint esclusivamente privati, tenere presente i seguenti requisiti prima di tentare la connessione:
- Accesso tramite API: è necessario creare un gateway VPE (Virtual Private Endpoint) indirizzato all'istanza di Vault Dedicated. Gli endpoint dei servizi cloud (CSE) non sono supportati per questo piano. Vedi " Utilizzo degli endpoint di servizio per connettersi in modo privato a Secrets Manager ".
- Accesso all'interfaccia utente di Vault: è necessario utilizzare una VPN client-to-site che instradi il traffico attraverso il VPE. L'interfaccia utente di Vault URL non è accessibile da un browser al di fuori della rete privata IBM Cloud senza una VPN. Vedere la sezione " Utilizzo di una VPN client-to-site per connettersi in modo privato a Secrets Manager ".
Se prevedi di utilizzare sia istanze del piano "
Standard" che del piano "Vault Dedicated", adotta una convenzione di denominazione che consenta di identificare facilmente il tipo di istanza, ad esempio includendo "-standard" o "-vault dedicated" nel nome dell'istanza. -
Fai clic su Crea.
Il processo di provisioning si conclude in genere nel giro di pochi minuti, ma può richiedere fino a 15 minuti.
Per ulteriori informazioni sulla configurazione di un'istanza, consultare la sezione " Creazione di un'istanza ".
Genera un token di amministratore
Per accedere all'interfaccia utente di Vault e procedere alla configurazione iniziale, generare un token di amministratore.
I token di amministrazione sono destinati esclusivamente alla configurazione iniziale e all'accesso di emergenza. Revoca tali autorizzazioni non appena avrai completato le operazioni di configurazione.
Generazione di un token di amministratore nell'interfaccia utente
- Nella dashboard della tua istanza di Secrets Manager, fai clic su "Crea token " nella sezione " Crea nuovo token di amministratore ".
- Copia il token di amministratore generato e conservalo in un luogo sicuro. Ti servirà questo token per accedere all'interfaccia utente di Vault.
Generazione di un token di amministratore dalla CLI
Per generare un nuovo token di amministratore di Vault utilizzando la CLI di IBM Cloud, eseguire il seguente comando.
ibmcloud secrets-manager-instance-management admin-token-create --id {instance_id}
Il comando restituisce il token di amministratore di Vault. Conservalo in un luogo sicuro: ti servirà questo token per accedere all'interfaccia utente di Vault.
Generazione di un token di amministratore tramite l'API
curl -X POST \
-H "Authorization: Bearer {iam_token}" \
-H "Accept: application/json" \
"https://{region}.secrets-manager.cloud.ibm.com/v2/instances/{id}/admintokens"
Una richiesta andata a buon fine restituisce il messaggio “ HTTP ” ( 201 Created). La risposta contiene un unico campo " token ": conservalo in modo sicuro e utilizzalo per accedere all'interfaccia utente
di Vault. Il buono è valido per 1 ora.
Generazione di un token di amministratore con Terraform
Per generare un token di amministratore di Vault con Terraform, utilizzare la risorsa ibm_sm_admin_token. Il token è valido per 1 ora e viene aggiornato automaticamente quando sta per scadere.
resource "ibm_sm_admin_token" "sm_admin_token" {
instance_id = "bfc50c2e-d66d-4f37-9ccf-9713f8325b39"
}
Una volta creata la risorsa, il token di amministratore di Vault è disponibile nell'attributo token.
Apri l'interfaccia utente di Vault
Utilizza l'endpoint dell'API di Vault per aprire l'interfaccia utente di Vault e accedi con il token di amministratore.
- Nella dashboard dell'istanza di Secrets Manager, fare clic su " Avvia interfaccia utente web " per accedere all'interfaccia utente nativa di Vault.
- Nella pagina di accesso a Vault, utilizza il token di amministratore che hai creato e completa la configurazione iniziale di Vault.
Revoca il token di amministratore
Una volta completata la configurazione iniziale, revoca tutti i token di amministratore attivi per ridurre il rischio di accessi non autorizzati.
Revoca dei token amministrativi nell'interfaccia utente
- Nella dashboard della tua istanza di Secrets Manager, fai clic su “Revoca” nella sezione “Revoca tutti i token amministrativi ”.
- Confermare la revoca quando richiesto.
La revoca del token ne comporta l'immediata invalidazione e contribuisce a ridurre il rischio di accessi non autorizzati.
Revoca dei token di amministratore dalla CLI
Per revocare tutti i token di amministratore di Vault attivi utilizzando la CLI di IBM Cloud, eseguire il comando seguente.
ibmcloud secrets-manager-instance-management admin-tokens-delete --id {instance_id}
Questa operazione invalida immediatamente tutti i token amministrativi, rendendo necessaria la generazione di nuovi token per i futuri accessi amministrativi.
Revoca dei token di amministratore tramite l'API
curl -X DELETE \
-H "Authorization: Bearer {iam_token}" \
"https://{region}.secrets-manager.cloud.ibm.com/v2/instances/{id}/admintokens"
Una revoca riuscita restituisce un codice di stato 204 No Content.
Passi successivi
Dopo aver effettuato l'accesso a Vault, puoi procedere con la configurazione iniziale della tua istanza.
- Per configurare i metodi di autenticazione per i tuoi team e le tue applicazioni, consulta la sezione " Configurazione dei metodi di autenticazione ".
- Per integrare le tue app utilizzando l'API di Vault, la CLI o gli SDK, consulta la sezione " Integrazione con le tue app ".
- Per esaminare le funzionalità dell'API e della CLI di Vault, consultare la panoramica di riferimento sull'API e sulla CLI.