Crea y edita mapas de pares clave-valor del entorno

Estás viendo la documentación de Apigee Edge.
Ve a la documentación de Apigee X.
info

En este tema, se muestra cómo crear y editar mapas de clave-valor (KVM) en la IU. Las KVM que creas en la IU tienen el alcance del entorno. Para obtener más información sobre KVM y el alcance, consulta Trabaja con mapas de clave-valor.

Habilita KVM encriptados en la IU de Edge con Edge para la nube privada

Los KVM encriptados son compatibles con Edge para la nube privada versión 4.17.01 y posteriores. Sin embargo, la compatibilidad con KVM encriptadas en la IU de Edge está inhabilitada de forma predeterminada. Para habilitar la IU de Edge para que admita KVM encriptados, haz lo siguiente:

  1. En el servidor de la IU de Edge, abre el archivo ui.properties en un editor. Si el archivo no existe, créalo:
    > vi /opt/apigee/customer/application/ui.properties
  2. Establece el token conf_apigee_apigee.feature.kvmencryption en verdadero:
    conf_apigee_apigee.feature.kvmencryption=true
  3. Guarda los cambios.
  4. Cambia el propietario de ui.properties a "apigee":
    > chown apigee:apigee /opt/apigee/customer/application/ui.properties
  5. Reinicia la IU de Edge:
    > /<inst_root>/apigee/apigee-service/bin/apigee-service edge-ui restart

Administra los mapas de par clave-valor de tu entorno

Administra tus KVM como se describe a continuación. Las KVM se definen en el alcance del entorno. Por ejemplo, si creas una KVM en el entorno “test”, los proxies de API que se ejecutan en el entorno “prod” no tendrán acceso a la KVM.

Edge

Para administrar KVM con la IU de Edge, haz lo siguiente:

  1. Accede a apigee.com/edge.
  2. Selecciona Administrador > Entornos > Mapas de par clave-valor en la barra de navegación izquierda.
  3. Para crear un KVM, sigue estos pasos:
    1. Haz clic en + Mapa de par clave-valor.
    2. Ingresa los valores de propiedad para la nueva KVM. En la siguiente tabla, se describe la configuración.
      Nombre de la propiedad Descripción
      Nombre Es el nombre de la KVM. Debe ser único en el entorno. Haz referencia a este nombre desde las políticas que interactúan con el KVM.
      EncriptadoMarca que especifica si el KVM está encriptado. En la IU, los valores encriptados aparecerán como asteriscos (*****). La encriptación se establece en todo el mapa. No puedes configurar la entrada de encriptación por entrada.
      Nota: Solo puedes encriptar KVM cuando los creas. No puedes encriptar ni desencriptar un mapa de valores de clave después de crearlo.
    3. Haz clic en Agregar.
  4. Para agregar una entrada a un KVM, sigue estos pasos:
    1. Haz clic en el nombre del KMV en la lista para mostrar las entradas actuales.
    2. Haz clic en +.
    3. Ingresa los valores de propiedad para la nueva entrada de KVM, como se describe a continuación.
      Nombre de la propiedad Descripción
      Clave

      Es el nombre de clave que usarás para acceder al valor de los datos en tus proxies de API.

      Con Apigee Edge para la nube pública, los nombres de las claves no pueden ser mayores que 2 KB.

      En la IU de Edge, los nombres no pueden contener “/”.

      Valor

      Es el valor de la clave. Ingresa cualquier combinación de números, letras o caracteres especiales.

      Nota: El tamaño total de un KVM no puede ser superior a 15 MB.

    4. Haz clic en Agregar.
  5. Para administrar las entradas de claves en un KVM, haz lo siguiente:
    1. Haz clic en el nombre de la KVM en la lista para mostrar las entradas actuales.
    2. Coloca el cursor sobre la entrada de KVM para mostrar el menú de acciones y realiza una de las siguientes tareas:
      • Para copiar el valor de una entrada, haz clic en .
      • Para editar una entrada, haz clic en . Luego, edita la entrada y haz clic en Actualizar.
      • Para borrar una entrada, haz clic en . Luego, haz clic en Borrar para confirmar la operación.

Edge clásico (nube privada)

Para crear y editar KVM con la IU clásica de Edge, haz lo siguiente:

  1. Accede a http://ms-ip:9000, donde ms-ip es la dirección IP o el nombre de DNS del nodo del servidor de administración.
  2. Selecciona APIs > Configuración del entorno > Mapas de par clave-valor.
  3. Selecciona el entorno para el que deseas configurar las cachés, como test o prod.
  4. Para crear un KVM, sigue estos pasos:
    1. Haz clic en + Mapa de plan clave-valor.
    2. Ingresa los valores de propiedad para el nuevo KVM, como se describe a continuación.
      Nombre de la propiedad Descripción
      Nombre Es el nombre de la KVM. Debe ser único en el entorno. Haz referencia a este nombre desde las políticas que interactúan con el KVM.
      EncriptadoMarca que especifica si el KVM está encriptado. En la IU, los valores encriptados aparecerán como asteriscos (*****). La encriptación se establece en todo el mapa. No puedes configurar la entrada de encriptación por entrada.
      Nota: Solo puedes encriptar KVM cuando los creas. No puedes encriptar ni desencriptar un mapa de valores de clave después de crearlo.
    3. Haz clic en Agregar.
  5. Para agregar una entrada a un KVM, sigue estos pasos:
    1. Haz clic en el nombre del KVM en la lista para expandir su lista de entradas.
    2. Haz clic en + Entrada.
    3. Ingresa los valores de propiedad para la nueva entrada de KVM, como se describe a continuación.
      Nombre de la propiedad Descripción
      Clave

      Es el nombre de clave que usarás para acceder al valor de los datos en tus proxies de API. En la IU de Edge, los nombres no pueden contener “/”.

      Nota: Con Edge para la nube pública, los nombres de las claves no pueden ser superiores a 2 KB.

      Valor

      Es el valor de la clave. Ingresa cualquier combinación de números, letras o caracteres especiales.

      Nota: El tamaño total de un KVM no puede ser superior a 15 MB.

    4. Haz clic en Guardar.
  6. Para editar o borrar las entradas de claves en un KVM, haz lo siguiente:
    1. Haz clic en el nombre del KVM en la lista para expandir su lista de entradas de claves.
    2. Realiza una de las siguientes acciones:
      • Para editar una entrada, haz clic en Editar, edítala y haz clic en Guardar.
      • Para borrar una entrada, haz clic en Borrar.