创建和修改环境键值对映射

您正在查看的是 Apigee Edge 文档。
转到 Apigee X 文档。 信息

本主题介绍了如何在界面中创建和修改键值对映射 (KVM)。您在界面中创建的 KVM 的范围是环境。如需详细了解 KVM 和范围，请参阅使用键值对映射。

使用适用于私有云的 Edge 在 Edge 界面中启用加密的 KVM

Edge for Private Cloud 4.17.01 及更高版本支持加密的 KVM。但是，在 Edge 界面中对加密 KVM 的支持默认处于停用状态。如需使 Edge 界面支持加密的 KVM，请执行以下操作：

  1. 在边缘界面服务器上，在编辑器中打开 ui.properties 文件。如果该文件不存在，请创建：
    > vi /opt/apigee/customer/application/ui.properties
  2. 将 conf_apigee_apigee.feature.kvmencryption 令牌设置为 true：
    conf_apigee_apigee.feature.kvmencryption=true
  3. 保存更改。
  4. 将 ui.properties 的所有者更改为“apigee”：
    > chown apigee:apigee /opt/apigee/customer/application/ui.properties
  5. 重启 Edge 界面：
    > /<inst_root>/apigee/apigee-service/bin/apigee-serviceedge-ui restart

管理环境键值对映射

管理您的 KVM，如下所述。KVM 在环境范围内定义。例如，如果您在“test”环境中创建了 KVM，则在“prod”环境中运行的 API 代理将无法访问 KVM。

Edge

如需使用 Edge 界面管理 KVM，请执行以下操作：

  1. 登录 apigee.com/edge。
  2. 在左侧导航栏中，依次选择管理 > 环境 > 键值对映射。
  3. 如需创建 KVM，请执行以下操作：
    1. 点击 + 键值对映射。
    2. 输入新 KVM 的属性值。下表介绍了这些设置。
      物业名称 说明
      名称 KVM 的名称。该名称在环境中必须是唯一的。从与 KVM 交互的政策中引用此名称。
      已加密用于指定是否加密 KVM 的标志。在界面中，加密的值将显示为星号 (*****)。加密值是对整个地图进行设置。您无法按条目设置加密条目。
      注意：您只能在创建 KVM 时对其进行加密。密钥值映射一经创建便无法加密或解密。
    3. 点击添加。
  4. 如需向 KVM 添加条目，请执行以下操作：
    1. 点击列表中 KMV 的名称，以显示当前条目。
    2. 点击 +。
    3. 输入新 KVM 条目的属性值，如下所述。
      物业名称 说明
      键

      用于访问 API 代理中的数据值的键名称。

      使用适用于公有云的 Apigee Edge 时，密钥名称不能超过 2 KB。

      在 Edge 界面中，名称不能包含“/”。
      值

      键的值。输入数字、字母或特殊字符的任意组合。

      注意：KVM 的总大小不能超过 15 MB。
    4. 点击添加。
  5. 如需管理 KVM 中的键条目，请执行以下操作：
    1. 点击列表中 KVM 的名称以显示当前条目。
    2. 将光标放在 KVM 条目上以显示操作菜单并执行以下任务之一：
      • 如需复制条目的值，请点击 。
      • 要修改条目，请点击 。然后，修改该条目并点击更新。
      • 要删除条目，请点击 。然后，点击删除以确认操作。

传统 Edge (Private Cloud)

如需使用传统版 Edge 界面创建和修改 KVM，请执行以下操作：

  1. 登录 http://ms-ip:9000，其中 ms-ip 是管理服务器节点的 IP 地址或 DNS 名称。
  2. 依次选择 API > 环境配置 > 键值对映射。
  3. 选择要配置缓存的环境，例如 test 或 prod。
  4. 如需创建 KVM，请执行以下操作：
    1. 点击 + 键值对映射。
    2. 输入新 KVM 的属性值，如下所述。
      物业名称 说明
      名称 KVM 的名称。该名称在环境中必须是唯一的。从与 KVM 交互的政策中引用此名称。
      已加密用于指定是否加密 KVM 的标志。在界面中，加密的值将显示为星号 (*****)。加密值是对整个地图进行设置。您无法按条目设置加密条目。
      注意：您只能在创建 KVM 时对其进行加密。密钥值映射一经创建便无法加密或解密。
    3. 点击添加。
  5. 如需向 KVM 添加条目，请执行以下操作：
    1. 点击列表中 KVM 的名称以展开其条目列表。
    2. 点击 + 条目
    3. 输入新 KVM 条目的属性值，如下所述。
      物业名称 说明
      键

      用于访问 API 代理中的数据值的键名称。在 Edge 界面中，名称不能包含“/”。

      注意：使用 Edge for Public Cloud 时，密钥名称不能超过 2 KB。
      值

      键的值。输入数字、字母或特殊字符的任意组合。

      注意：KVM 的总大小不能超过 15 MB。
    4. 点击保存。
  6. 如需修改或删除 KVM 中的键条目，请执行以下操作：
    1. 点击列表中 KVM 的名称以展开其键条目列表。
    2. 执行以下其中一项操作：
      • 如要修改条目，请点击修改，修改该条目，然后点击保存。
      • 要删除条目，请点击 Delete（删除）。