Crea y edita mapas de pares clave-valor del entorno

Estás consultando la documentación de Apigee Edge.
Consulta la documentación de Apigee X.
Información

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

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

Los KVM encriptados son compatibles con Edge para nube privada 4.17.01 y versiones posteriores. Sin embargo, la compatibilidad con los KVM encriptados en la IU de Edge está inhabilitada de forma predeterminada. Para permitir que la IU de Edge admita KVMs encriptados, haz lo siguiente:

  1. En el servidor de 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. Configura 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 perimetral-ui restart

Administra los mapas de par clave-valor de tu entorno

Administra tus KVM, como se describe a continuación. Los KVM se definen en el permiso environment. Por ejemplo, si creas un KVM en el entorno “test”, los proxies de API que se ejecutan en el entorno “prod” no tendrán acceso al KVM.

Conexión de integración

Para administrar los KVM mediante la IU de Edge, sigue estos pasos:

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

      El nombre de la clave que usarás para acceder al valor de los datos en los proxies de API.

      Con Apigee Edge para la nube pública, los nombres de claves no pueden tener más de 2 KB.

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

      Valor

      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 clave en un KVM, sigue estos pasos:
    1. Haz clic en el nombre del 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 realizar 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.

Versión clásica de Edge (nube privada)

Para crear y editar KVM con la IU clásica de Edge, sigue estos pasos:

  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 pares clave-valor.
  3. Selecciona el entorno para el que deseas configurar las memorias caché, como test o prod.
  4. Para crear un KVM, sigue estos pasos:
    1. Haz clic en + Mapa de par clave-valor.
    2. Ingresa los valores de propiedad del KVM nuevo, como se describe a continuación.
      Nombre de propiedad Descripción
      Nombre Es el nombre del KVM. Debe ser único en el entorno. Haz referencia a este nombre a partir de las políticas que interactúan con KVM.
      EncriptadoMarca que especifica si el KVM está encriptado. En la IU, los valores encriptados aparecerán como asteriscos (*****). La encriptación se configura en todo el mapa. No puedes configurar entrada de encriptación por entrada.
      Nota: Solo puedes encriptar KVM cuando los creas. No puedes encriptar ni desencriptar un mapa de clave-valor 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 de la lista para expandir su lista de entradas.
    2. Haz clic en + Entrada.
    3. Ingresa los valores de propiedad de la nueva entrada de KVM, como se describe a continuación.
      Nombre de propiedad Descripción
      Clave

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

      Nota: Con Edge para la nube pública, los nombres de claves no pueden tener más de 2 KB.

      Valor

      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 clave en un KVM, sigue estos pasos:
    1. Haz clic en el nombre del KVM de la lista para expandir su lista de entradas de clave.
    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.