Criar e editar mapas de chave-valor do ambiente

Você está visualizando 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 criptografadas 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 criptografadas na interface do Edge fica desativado por padrão. Para permitir que a interface do Edge ofereça suporte a KVMs criptografadas:

  1. No servidor da IU 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

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 "teste", os proxies de API em execução no ambiente "prod" 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 os valores de propriedade do 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 quando você as cria. 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 os valores de propriedade para a nova entrada da KVM, conforme descrito abaixo.
      Nome da propriedade Descrição
      Chave

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

      Com o Apigee Edge para nuvem pública, os nomes das chaves 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 chaves em uma KVM:
    1. Clique no nome do KVM na lista para mostrar as entradas atuais.
    2. Posicione o cursor sobre a entrada do KVM para abrir 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 clássica do Edge:

  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 em que você quer configurar os caches, como test ou prod.
  4. Para criar um KVM:
    1. Clique em + Mapa de chave-valor.
    2. Insira os valores de propriedade para a nova 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 quando você as cria. 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 os valores de propriedade para a nova entrada da KVM, conforme descrito abaixo.
      Nome da propriedade Descrição
      Chave

      Nome da chave que você vai 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 Public Cloud, os nomes das chaves 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 chaves.
    2. Realize uma das seguintes ações:
      • Para editar uma entrada, clique em Editar, faça as mudanças e clique em Salvar.
      • Para excluir uma entrada, clique em Excluir.