Creazione di una istanza Secrets Manager nella UI

Per creare un'istanza di Secrets Manager dalla console IBM Cloud, seguire la procedura riportata di seguito.

1. Nella console, vai al Secrets Manager offrendo la pagina dei dettagli.

2. Nella scheda Crea, selezionare la regione che rappresenta l'area geografica in cui si desidera predisposizione la propria istanza.

3. Rivedere e selezionare un piano di determinazione dei prezzi.

   È possibile creare una sola istanza di prova Secrets Manager per account. Prima di poter creare una nuova istanza di prova, è necessario eliminare l'istanza di prova esistente e il relativo recupero spazio.

4. Inserisci un nome per la tua istanza.

5. Seleziona un gruppo di risorse.

6. Opzionale: Aggiungi tag per aiutarti ad organizzare l'istanza nel tuo account.

7. Determinare un'opzione per l'abilitazione della crittografia gestita dal cliente per la tua istanza.

   Puoi potenziare la sicurezza dei tuoi segreti a riposo integrando con un servizio di gestione chiavi. Per ulteriori informazioni sulla crittografia gestita dal cliente, verificare Protezione dei tuoi dati sensibili in Secrets Manager.

   È inoltre possibile utilizzare il modulo Key Management Services All-Inclusive per una gestione semplificata delle chiavi. Per saperne di più, esplorate i moduli di Terraform IBM.

8. Determinare un'opzione per la connessione a Secrets Manager. Per impostazione predefinita, le istanze di Secrets Manager sono create solo con un endpoint privato.

   Selezionare private-only o public-and-private. Per ulteriori informazioni sulla configurazione dell'account per supportare l'opzione di connettività privata, vedere Abilitazione di VRF e endpoint di servizio.

9. Fare clic su Crea per creare un'istanza di Secrets Manager nell'account, nella regione e nel gruppo di risorse selezionato.

   Per aggiornare il tuo piano di servizio dopo aver creato un'istanza, consultare Aggiornamento del tuo piano di servizio.

Creazione di una istanza Secrets Manager dalla CLI

Per creare un'istanza di Secrets Manager utilizzando la CLI IBM Cloud, completa la seguente procedura.

1. Accedi a IBM Cloud tramite il IBM Cloud CLI.

   ibmcloud login
   

   Se l'accesso non riesce, esegui il comando ibmcloud login --sso e prova di nuovo. Il parametro --sso è obbligatorio quando accedi con un ID federato. Se viene utilizzata questa opzione, vai al link elencato nell'output della CLI per generare una passcode monouso.

2. Selezionare l'account, la regione e il gruppo di risorse in cui si desidera creare un'istanza del servizio " Secrets Manager ".

   ibmcloud target -r REGION_NAME -g RESOURCE_GROUP_NAME
   

3. Crea un'istanza di Secrets Manager all'interno di quell'account e di quel gruppo di risorse.

   ibmcloud resource service-instance-create INSTANCE_NAME secrets-manager PLAN REGION_NAME [OPTIONS]
   

   Descrizione delle informazioni necessarie per il provisioning del servizio Secrets Manager utilizzando la CLI

   Variabile	Descrizione
   Nome dell'istanza (instance_name)	Un alias univoco per l'istanza del servizio.
   Regione (region)	La regione in cui deve essere eseguito il provisioning dell'istanza. Regioni supportate.
   Piano tariffario (plan)	Il piano tariffario che si desidera utilizzare. Utilizza trial o standard.
   Punti finali (options)	Facoltativo. Per impostazione predefinita, le istanze di Secrets Manager vengono create solo con un endpoint privato (private-only). Se si desidera fornire un'istanza di Secrets Manager che utilizzi anche un endpoint pubblico, aggiungere l'opzione --service-endpoints public-and-private al comando.
   Crittografia (options)	Per fornire un'istanza di Secrets Manager che utilizza crittografia gestita dai clienti, accodare -p '{"kms_key": "<root_key_crn>"}'. Sostituire <root_key_crn> con il valore CRN per la chiave principale che si desidera integrare.

   È possibile creare una sola istanza di prova Secrets Manager per account. Prima di poter creare una nuova istanza di prova, è necessario eliminare l'istanza di prova esistente e il relativo recupero spazio.

   Per aggiornare il tuo piano di servizio dopo aver creato un'istanza, consultare Aggiornamento del tuo piano di servizio.

Creazione di un'istanza Secrets Manager dall'API

Per creare un'istanza di Secrets Manager dall'API, completa la seguente procedura.

Per il supporto dei linguaggi di programmazione aggiuntivi, vedi la Resource Controller API Docs.

1. Ottieni un token di accesso IAM IBM Cloud.

2. Esegui un comando curl per eseguire il provisioning di un'istanza di Secrets Manager.

   curl -X POST https://resource-controller.cloud.ibm.com/v2/resource_instances -H "Authorization: Bearer <IAM token>" -H 'Content-Type: application/json' -d '{
      "name": "<instance_name>",
      "target": "<region>",
      "resource_group": "<resource_group_id>",
      "resource_plan_id": "<plan>",
      "parameters": {"service-endpoints": "public-and-private","kms_key": "<root_key_crn>"}
   }'
   

   Descrizione delle informazioni necessarie per il provisioning del servizio Secrets Manager tramite API

   Variabile	Descrizione
   Nome dell'istanza (name)	Un alias univoco per l'istanza del servizio.
   Target (region)	La regione in cui deve essere eseguito il provisioning dell'istanza. Regioni supportate.
   Piano tariffario (plan)	Il piano di determinazione dei prezzi che si desidera utilizzare, fornito come ID piano. Utilizzare 869c191a-3c2a-4faf-98be-18d48f95ba1f per trial o 7713c3a8-3be8-4a9a-81bb-ee822fcaac3d per standard.
   Endpoint	Per impostazione predefinita, le istanze di Secrets Manager vengono create solo con un endpoint privato. Se è necessario fornire un'istanza che Secrets Manager utilizza anche un endpoint pubblico, aggiungere "service-endpoints":"public-and-private" a parameters.
   Crittografia	Per eseguire il provisioning di un'istanza di Secrets Manager che utilizza la crittografia gestita dal cliente, conserva il parametro kms_key e sostituisci <root_key_crn> con il valore CRN per la chiave root che vuoi integrare.

   È possibile creare una sola istanza di prova Secrets Manager per account. Prima di poter creare una nuova istanza di prova, è necessario eliminare l'istanza di prova esistente e il relativo recupero spazio.

   Per aggiornare il tuo piano di servizio dopo aver creato un'istanza, consultare Aggiornamento del tuo piano di servizio.

Creare un'istanza di Secrets Manager usando Terraform

Per creare un'istanza di Secrets Manager usando Terraform, includere i seguenti parametri nella risorsa ibm_resource_instance per Secrets Manager.

• service: secrets-manager
• plan: Standard o Trial. Per saperne di più sui piani di servizio
• service_endpoints: private o public-and-private. Se non specificato, il valore predefinito è private Per ulteriori personalizzazioni, inserisci quanto segue nel file parameters .
• kms_key: Chiave radice CRN da Key Protect. Se non è inclusa, la chiave predefinita è quella principale, gestita da Secrets Manager

Un esempio di risorsa è il seguente.

resource "ibm_resource_instance" "sm_instance" {
  name              = "demo-sm-instance"
  service           = "secrets-manager"
  plan              = "standard"
  location          = "us-south"
  service_endpoints = "public-and-private"
}

È inoltre possibile utilizzare il comando IBM Cloud® Secrets Manager per effettuare il provisioning e configurare le istanze di Secrets Manager come codice. Per ulteriori informazioni sui moduli Terraform IBM, vedere Informazioni sui moduli Terraform IBM.