Creazione e modifica delle mappe chiave-valore dell'ambiente

Stai visualizzando la documentazione di Apigee Edge.
Vai alla documentazione di Apigee X.
informazioni

Questo argomento illustra come creare e modificare mappe chiave-valore (KVM) nell'interfaccia utente. I KVM creati nell'interfaccia utente sono basati sull'ambiente. Per maggiori informazioni su KVM e ambito, consulta Utilizzo delle mappe chiave-valore.

Abilitazione di KVM criptati nella UI perimetrale con Edge per il cloud privato

I KVM criptati sono supportati in Edge per il cloud privato versione 4.17.01 e successive. Tuttavia, il supporto per i KVM criptati nell'UI perimetrale è disabilitato per impostazione predefinita. Per abilitare l'interfaccia utente Edge in modo che supporti i KVM criptati:

  1. Sul server UI perimetrale, apri il file ui.properties in un editor. Se il file non esiste, crealo:
    > vi /opt/apigee/customer/application/ui.properties
  2. Imposta il token conf_apigee_apigee.feature.kvmencryption su true:
    conf_apigee_apigee.feature.kvmencryption=true
  3. Salva le modifiche.
  4. Modifica il proprietario di ui.properties in "apigee":
    > chown apigee:apigee /opt/apigee/customer/application/ui.properties
  5. Riavvia la UI Edge:
    > /<inst_root>/apigee/apigee-service/bin/apigee-service edge-ui restart

Gestione delle mappe chiave-valore di ambiente

Gestisci i tuoi KVM come descritto di seguito. I KVM vengono definiti nell'ambito dell'ambiente. Ad esempio, se crei un KVM nell'ambiente di test, i proxy API in esecuzione nell'ambiente di produzione non avranno accesso al KVM.

Perimetrale

Per gestire i KVM utilizzando l'UI Edge:

  1. Accedi ad apigee.com/edge.
  2. Seleziona Amministrazione > Ambienti > Mappe chiave-valore nella barra di navigazione a sinistra.
  3. Per creare un KVM:
    1. Fai clic su + Mappa coppia chiave-valore.
    2. Inserisci i valori delle proprietà per il nuovo KVM. La tabella seguente descrive le impostazioni.
      Nome proprietà Descrizione
      Nome Nome del KVM. Deve essere univoco nell'ambiente. Fai riferimento a questo nome dai criteri che interagiscono con il KVM.
      CriptatoFlag che specifica se il KVM è criptato. Nella UI, i valori criptati vengono visualizzati come asterischi (*****). La crittografia è impostata sull'intera mappa. Non puoi impostare la crittografia voce per voce.
      Nota: puoi criptare i KVM solo quando li crei. Non puoi criptare o decriptare una mappa chiave-valore dopo averla creata.
    3. Fai clic su Aggiungi.
  4. Per aggiungere una voce a un KVM:
    1. Fai clic sul nome del KMV nell'elenco per visualizzare le voci correnti.
    2. Fai clic su +.
    3. Inserisci i valori delle proprietà per la nuova voce KVM, come descritto di seguito.
      Nome proprietà Descrizione
      Chiave

      Nome della chiave che utilizzerai per accedere al valore dei dati nei proxy API.

      Con Apigee Edge per il cloud pubblico, i nomi delle chiavi non possono superare i 2 kB.

      Nella UI perimetrale, i nomi non possono contenere "/".

      Valore

      Valore della chiave. Inserisci qualsiasi combinazione di numeri, lettere o caratteri speciali.

      Nota: le dimensioni totali di un KVM non possono essere superiori a 15 MB.

    4. Fai clic su Aggiungi.
  5. Per gestire le voci chiave in un KVM:
    1. Fare clic sul nome del KVM nell'elenco per visualizzare le voci correnti.
    2. Posiziona il cursore sulla voce KVM per visualizzare il menu Azioni ed eseguire una delle seguenti attività:
      • Per copiare il valore di una voce, fai clic su .
      • Per modificare una voce, fai clic su . Poi, modifica la voce e fai clic su Aggiorna.
      • Per eliminare una voce, fai clic su . Quindi, fai clic su Elimina per confermare l'operazione.

Classic Edge (private cloud)

Per creare e modificare i KVM utilizzando l'interfaccia utente Classic Edge:

  1. Accedi a http://ms-ip:9000, dove ms-ip è l'indirizzo IP o il nome DNS del nodo del server di gestione.
  2. Seleziona API > Configurazione ambiente > Mappe chiave-valore.
  3. Seleziona l'ambiente per il quale vuoi configurare le cache, ad esempio test o prod.
  4. Per creare un KVM:
    1. Fai clic su + Mappa valore-chiave.
    2. Inserisci i valori delle proprietà per il nuovo KVM, come descritto di seguito.
      Nome proprietà Descrizione
      Nome Nome del KVM. Deve essere univoco nell'ambiente. Fai riferimento a questo nome dai criteri che interagiscono con il KVM.
      CriptatoFlag che specifica se il KVM è criptato. Nella UI, i valori criptati vengono visualizzati come asterischi (*****). La crittografia è impostata sull'intera mappa. Non puoi impostare la crittografia voce per voce.
      Nota: puoi criptare i KVM solo quando li crei. Non puoi criptare o decriptare una mappa chiave-valore dopo averla creata.
    3. Fai clic su Aggiungi.
  5. Per aggiungere una voce a un KVM:
    1. Fai clic sul nome del KVM nell'elenco per espandere l'elenco di voci.
    2. Fai clic su + Voce
    3. Inserisci i valori delle proprietà per la nuova voce KVM, come descritto di seguito.
      Nome proprietà Descrizione
      Chiave

      Nome della chiave che utilizzerai per accedere al valore dei dati nei proxy API. Nella UI perimetrale, i nomi non possono contenere "/".

      Nota: con Edge per cloud pubblico, i nomi delle chiavi non possono superare i 2 kB.

      Valore

      Valore della chiave. Inserisci qualsiasi combinazione di numeri, lettere o caratteri speciali.

      Nota: le dimensioni totali di un KVM non possono essere superiori a 15 MB.

    4. Fai clic su Salva.
  6. Per modificare o eliminare le voci chiave in un KVM:
    1. Fai clic sul nome del KVM nell'elenco per espandere l'elenco delle voci chiave.
    2. Esegui una delle seguenti azioni:
      • Per modificare una voce, fai clic su Modifica, modifica la voce e fai clic su Salva.
      • Per eliminare una voce, fai clic su Elimina.