環境 Key-Value マップの作成と編集

このトピックでは、UI で Key-Value マップ（KVM）を作成および編集する方法について説明します。UI で作成する KVM は環境をスコープとします。KVM とスコープの詳細については、Key-Value マップの使い方をご覧ください。

Edge for Private Cloud の Edge UI における暗号化された KVM の有効化

暗号化された KVM は、Edge for Private Cloud バージョン 4.17.01 以降でサポートされています。ただし、Edge UI での暗号化された KVM のサポートは、デフォルトでは無効になっています。暗号化された KVM を Edge UI でサポートできるようにするには、次の手順に従います。

  1. Edge UI サーバーで、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 UI を再起動します。
    >/<inst_root>/apigee/apigee-service/bin/apigee-service edge-ui restart

環境 Key-Value マップの管理

以下の手順で KVM を管理します。KVM は環境スコープで定義されます。たとえば、「test」環境で KVM を作成した場合、「prod」環境で実行されている API プロキシは KVM にアクセスできません。

Edge

Edge UI を使用して KVM を管理するには:

  1. apigee.com/edge にログインします。
  2. 左側のナビゲーション バーで [Admin] > [Environments] > [Key Value Maps] を選択します。
  3. KVM を作成するには:
    1. [+ Key value map] をクリックします。
    2. 新しい KVM のプロパティ値を入力します。次の表で設定について説明します。
      プロパティ名 説明
      Name KVM の名前。環境内で一意にする必要があります。KVM とデータを送受信するポリシーからこの名前を参照します。
      EncryptedKVM が暗号化されているかどうかを指定するフラグ。UI では、暗号化された値はアスタリスク（*****）として表示されます。暗号化はマップ全体に設定されます。エントリごとに暗号化を設定することはできません。
      注: KVM は作成時にのみ暗号化できます。作成後に Key-Value マップを暗号化または復号することはできません。
    3. [Add] をクリックします。
  4. KVM にエントリを追加するには:
    1. リスト内の KVM の名前をクリックして、現在のエントリを表示します。
    2. [+] をクリックします。
    3. 以下の説明に従って、新しい KVM エントリのプロパティ値を入力します。
      プロパティ名 説明
      Key

      API プロキシでデータ値にアクセスする際に使用するキー名。

      Apigee Edge for Public Cloud では、キー名を 2 KB 以下にする必要があります。

      Edge UI では、名前に「/」を含めることはできません。
      Value

      キーの値。数字、文字、特殊文字を任意の組み合わせで入力します。

      注: KVM の合計サイズは 15 MB 以下にする必要があります。
    4. [Add] をクリックします。
  5. KVM のキーエントリを管理するには:
    1. リスト内の KVM の名前をクリックして、現在のエントリを表示します。
    2. KVM エントリにカーソルを合わせて操作メニューを表示し、次のいずれかのタスクを実行します。
      • エントリの値をコピーするには、 をクリックします。
      • エントリを編集するには、 をクリックします。次に、エントリを編集して [Update] をクリックします。
      • エントリを削除するには、 をクリックします。次に、[Delete] をクリックして操作を確定します。

Classic Edge（Private Cloud）

Classic Edge UI を使用して KVM を作成および編集するには:

  1. http://ms-ip:9000 にログインします。ここで、ms-ip は、Management Server ノードの IP アドレスまたは DNS 名です。
  2. [APIs] > [Environment Configuration] > [Key Value Maps] を選択します。
  3. キャッシュを構成する環境を選択します（例: test、prod）。
  4. KVM を作成するには:
    1. [+ Key Value Map] をクリックします。
    2. 以下の説明に従って、新しい KVM のプロパティ値を入力します。
      プロパティ名 説明
      Name KVM の名前。環境内で一意にする必要があります。KVM とデータを送受信するポリシーからこの名前を参照します。
      EncryptedKVM が暗号化されているかどうかを指定するフラグ。UI では、暗号化された値はアスタリスク（*****）として表示されます。暗号化はマップ全体に設定されます。エントリごとに暗号化を設定することはできません。
      注: KVM は作成時にのみ暗号化できます。作成後に Key-Value マップを暗号化または復号することはできません。
    3. [Add] をクリックします。
  5. KVM にエントリを追加するには:
    1. リスト内の KVM の名前をクリックして、エントリのリストを展開します。
    2. [+ Entry] をクリックします。
    3. 以下の説明に従って、新しい KVM エントリのプロパティ値を入力します。
      プロパティ名 説明
      Key

      API プロキシでデータ値にアクセスする際に使用するキー名。Edge UI では、名前に「/」を含めることはできません。

      注: Edge for Public Cloud では、キー名を 2 KB 以下にする必要があります。
      Value

      キーの値。数字、文字、特殊文字を任意の組み合わせで入力します。

      注: KVM の合計サイズは 15 MB 以下にする必要があります。
    4. [Save] をクリックします。
  6. KVM のキーエントリを編集または削除するには:
    1. リスト内の KVM の名前をクリックして、キーエントリのリストを展開します。
    2. 次のいずれかの操作を行います。
      • エントリを編集するには、[Edit] をクリックしてエントリを編集し、[Save] をクリックします。
      • エントリを削除するには、[Delete] をクリックします。