Criar e editar mapas de chave-valor do ambiente

Você está vendo a documentação do Apigee Edge.
Acesse a documentação da Apigee X.
informações

Neste tópico, mostramos como criar e editar mapas de chave-valor (KVMs) na interface. As KVMs que você cria 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

As KVMs criptografadas são compatíveis com o Edge para a nuvem privada versão 4.17.01 e mais recentes. No entanto, o suporte para KVMs criptografadas na interface do usuário do Edge está desativado por padrão. Para permitir que a interface do usuário do Edge ofereça suporte a KVMs criptografadas:

  1. No servidor da IU de borda, 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 "true":
    conf_apigee_apigee.feature.kvmencryption=true
  3. Salve as mudanças.
  4. Mude o proprietário de ui.properties para "apigee":
    > chown apigee:apigee /opt/apigee/customer/application/ui.properties
  5. Reinicie a IU do Edge:
    > /<inst_root>/apigee/apigee-service/bin/apigee-service edge-ui restart

Como gerenciar mapas de chave-valor do ambiente

Gerencie suas KVMs, conforme descrito abaixo. As KVMs são definidas no escopo do ambiente. Por exemplo, se você criar uma KVM no ambiente "test", os proxies da API em execução no ambiente "prod" não terão acesso à KVM.

Edge

Para gerenciar KVMs usando a IU do Edge:

  1. Faça login em apigee.com/edge.
  2. Selecione Admin > Ambientes > Mapas de chave-valor na barra de navegação à esquerda.
  3. Para criar uma KVM:
    1. Clique em + Mapa de chave-valor.
    2. Insira valores de propriedade para a nova KVM. A tabela a seguir descreve as configurações.
      Nome da propriedade Descrição
      Nome Nome da KVM. Precisa ser exclusivo no ambiente. Faça referência a esse nome nas políticas que interagem com a KVM.
      CriptografadoSinalização que especifica se a KVM está criptografada. Na interface, os valores criptografados aparecem como asteriscos (*****). A criptografia é definida em todo o mapa. Não é possível definir a entrada de criptografia por entrada.
      Observação:só é possível criptografar KVMs ao criá-las. 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 uma KVM:
    1. Clique no nome do KMV na lista para exibir as entradas atuais.
    2. Clique em +.
    3. Insira valores de propriedade para a nova entrada da KVM, conforme descrito abaixo.
      Nome da propriedade Descrição
      Chave

      Nome da chave que você usará para acessar o valor de 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 uma KVM não pode ser maior que 15 MB.

    4. Clique em Adicionar.
  5. Para gerenciar as entradas de chave em uma KVM:
    1. Clique no nome da KVM na lista para exibir as entradas atuais.
    2. Posicione o cursor sobre a entrada 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.

Borda clássica (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 para o qual você quer configurar caches, como test ou prod.
  4. Para criar uma KVM:
    1. Clique em + Mapa de chave-valor.
    2. Insira valores de propriedade para a nova KVM, conforme descrito abaixo.
      Nome da propriedade Descrição
      Nome Nome da KVM. Precisa ser exclusivo no ambiente. Faça referência a esse nome nas políticas que interagem com a KVM.
      CriptografadoSinalização que especifica se a KVM está criptografada. Na interface, os valores criptografados aparecem como asteriscos (*****). A criptografia é definida em todo o mapa. Não é possível definir a entrada de criptografia por entrada.
      Observação:só é possível criptografar KVMs ao criá-las. 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 uma KVM:
    1. Clique no nome da KVM na lista para expandir a lista de entradas.
    2. Clique em + Entrada.
    3. Insira valores de propriedade para a nova entrada da KVM, conforme descrito abaixo.
      Nome da propriedade Descrição
      Chave

      Nome da chave que você usará para acessar o valor de 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 uma KVM não pode ser maior que 15 MB.

    4. Clique em Salvar.
  6. Para editar ou excluir as entradas de chave em uma KVM:
    1. Clique no nome da KVM na lista para expandir a lista de entradas de chave.
    2. Escolha uma destas opções:
      • Para editar uma entrada, clique em Editar, edite a entrada e clique em Salvar.
      • Para excluir uma entrada, clique em Excluir.