Criar e editar mapas de chave-valor do ambiente

Você está lendo a documentação do Apigee Edge.
Acesse a documentação da Apigee X. info

Este tópico mostra como criar e editar mapas de chave-valor (KVMs) na interface. Os KVMs criados na interface têm escopo de ambiente. Para mais informações sobre KVMs e escopo, consulte Como trabalhar com mapas de chave-valor.

Como ativar KVMs criptografados na interface do Edge com o Edge para nuvem privada

Os KVMs criptografados são compatíveis com o Edge para nuvem privada versão 4.17.01 e mais recentes. No entanto, o suporte para KVMs criptografados na interface do Edge está desativado por padrão. Para ativar a interface do Edge para oferecer suporte a KVMs criptografados:

  1. No servidor da interface do Edge, abra o arquivo ui.properties em um editor. Se o arquivo não existir, crie-o:
    > vi /opt/apigee/customer/application/ui.properties
  2. Defina o token conf_apigee_apigee.feature.kvmencryption como verdadeiro:
    conf_apigee_apigee.feature.kvmencryption=true
  3. Salve as alterações.
  4. Mude o proprietário de ui.properties para "apigee":
    > chown apigee:apigee /opt/apigee/customer/application/ui.properties
  5. Reinicie a interface do Edge:
    > /<inst_root>/apigee/apigee-service/bin/apigee-service edge-ui restart

Como gerenciar mapas de chave-valor do ambiente

Gerencie seus KVMs, conforme descrito abaixo. Os KVMs são definidos no escopo do ambiente. Por exemplo, se você criar um KVM no ambiente de "teste", os proxies de API em execução no ambiente de "produção" não terão acesso ao KVM.

Edge

Para gerenciar KVMs usando a interface do Edge:

  1. Faça login em apigee.com/edge.
  2. Selecione Administrador > Ambientes > Mapas de chave-valor na barra de navegação à esquerda.
  3. Para criar um KVM:
    1. Clique em + Mapa de chave-valor.
    2. Insira valores de propriedade para o novo KVM. A tabela a seguir descreve as configurações.
      Nome da propriedade Descrição
      Nome Nome do KVM. Precisa ser exclusivo no ambiente. Refira-se a esse nome nas políticas que interagem com o KVM.
      CriptografadoFlag que especifica se o KVM está criptografado. Na interface, os valores criptografados aparecem como asteriscos (*****). A criptografia é definida em todo o mapa. Não é possível definir a criptografia entrada por entrada.
      Observação:só é possível criptografar KVMs ao criá-los. Não é possível criptografar ou descriptografar um mapa de chave valor depois que ele é criado.
    3. Clique em Adicionar.
  4. Para adicionar uma entrada a um KVM:
    1. Clique no nome do KMV na lista para mostrar as entradas atuais.
    2. Clique em +.
    3. Insira valores de propriedade para a nova entrada de KVM, conforme descrito abaixo.
      Nome da propriedade Descrição
      Chave

      Nome da chave que você usará para acessar o valor dos dados nos proxies de API.

      Com o Apigee Edge para nuvem pública, os nomes de chave não podem ser maiores que 2 KB.

      Na interface do Edge, os nomes não podem conter "/".
      Valor

      Valor da chave. Insira qualquer combinação de números, letras ou caracteres especiais.

      Observação:o tamanho total de um KVM não pode ser maior que 15 MB.
    4. Clique em Adicionar.
  5. Para gerenciar as entradas de chave em um KVM:
    1. Clique no nome do KVM na lista para mostrar as entradas atuais.
    2. Posicione o cursor sobre a entrada do KVM para mostrar o menu de ações e realizar uma das seguintes tarefas:
      • Para copiar o valor de uma entrada, clique em .
      • Para editar uma entrada, clique em . Em seguida, edite a entrada e clique em Atualizar.
      • Para excluir uma entrada, clique em . Em seguida, clique em Excluir para confirmar a operação.

Edge clássico (nuvem privada)

Para criar e editar KVMs usando a interface do Edge clássico:

  1. Faça login em http://ms-ip:9000, em que ms-ip é o endereço IP ou o nome DNS do nó do servidor de gerenciamento.
  2. Selecione APIs > Configuração do ambiente > Mapas de chave-valor.
  3. Selecione o ambiente para o qual você quer configurar caches, como test ou prod.
  4. Para criar um KVM:
    1. Clique em + Mapa de chave-valor.
    2. Insira valores de propriedade para o novo KVM, conforme descrito abaixo.
      Nome da propriedade Descrição
      Nome Nome do KVM. Precisa ser exclusivo no ambiente. Refira-se a esse nome nas políticas que interagem com o KVM.
      CriptografadoFlag que especifica se o KVM está criptografado. Na interface, os valores criptografados aparecem como asteriscos (*****). A criptografia é definida em todo o mapa. Não é possível definir a criptografia entrada por entrada.
      Observação:só é possível criptografar KVMs ao criá-los. Não é possível criptografar ou descriptografar um mapa de chave valor depois que ele é criado.
    3. Clique em Adicionar.
  5. Para adicionar uma entrada a um KVM:
    1. Clique no nome do KVM na lista para expandir a lista de entradas.
    2. Clique em + Entrada
    3. Insira valores de propriedade para a nova entrada de KVM, conforme descrito abaixo.
      Nome da propriedade Descrição
      Chave

      Nome da chave que você usará para acessar o valor dos dados nos proxies de API. Na interface do Edge, os nomes não podem conter "/".

      Observação: com o Edge para nuvem pública, os nomes de chave não podem ser maiores que 2 KB.
      Valor

      Valor da chave. Insira qualquer combinação de números, letras ou caracteres especiais.

      Observação:o tamanho total de um KVM não pode ser maior que 15 MB.
    4. Clique em Salvar.
  6. Para editar ou excluir as entradas de chave em um KVM:
    1. Clique no nome do KVM na lista para expandir a lista de entradas de chave.
    2. Realize uma das seguintes ações:
      • Para editar uma entrada, clique em Editar, edite a entrada e clique em Salvar.
      • Para excluir uma entrada, clique em Excluir.