Como criar e editar mapas de chave-valor do ambiente

Você está vendo a documentação do Apigee Edge.
Consulte a documentação do Apigee X.

Este tópico mostra como criar e editar mapas de chave-valor (KVMs) na IU. As KVMs que você cria na IU têm escopo definido no ambiente. Para mais informações sobre KVMs e escopo, consulte Como trabalhar com mapas de chave-valor.

Como ativar KVMs criptografadas na IU do Edge com o Edge para nuvem privada

As KVMs criptografadas são compatíveis com o Edge para nuvem privada nas versões 4.17.01 e posteriores. No entanto, o suporte a KVMs criptografadas na IU do Edge é desativado por padrão. Para permitir que a IU do Edge seja compatível com KVMs criptografadas:

  1. No servidor de 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 mudanças.
  4. Altere 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 reiniciação de IU

Como gerenciar mapas de chave-valor do ambiente

Gerencie suas KVMs, conforme descrito abaixo. As KVMs são definidas no escopo environment. Por exemplo, se você criar uma KVM no ambiente de "teste", os proxies de API executados no ambiente de "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 Administrador > Ambientes > Mapas de valor-chave na barra de navegação à esquerda.
  3. Para criar uma KVM:
    1. Clique em + Mapa de chave-valor.
    2. Digite 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. Consulte esse nome nas políticas que interagem com a KVM.
      CriptografadoSinalização que especifica se a KVM é criptografada. Na IU, os valores criptografados aparecem como asteriscos (******). A criptografia é definida em todo o mapa. Não é possível definir a criptografia de entrada 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. Digite valores de propriedade para a nova entrada KVM, conforme descrito abaixo.
      Nome da propriedade Descrição
      Chave

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

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

      Na IU 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 principais entradas 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 exibir o menu de ações e execute 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.

Versão clássica do Cloud Edge (nuvem privada)

Para criar e editar KVMs usando a IU 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 valor-chave.
  3. Selecione o ambiente em que você quer configurar os caches, como test ou prod.
  4. Para criar uma KVM:
    1. Clique em + Mapa de chave-valor.
    2. Digite valores de propriedade para a nova KVM, conforme descrito abaixo.
      Nome da propriedade Descrição
      Nome Nome da KVM. Precisa ser exclusivo no ambiente. Consulte esse nome nas políticas que interagem com a KVM.
      CriptografadoSinalização que especifica se a KVM é criptografada. Na IU, os valores criptografados aparecem como asteriscos (******). A criptografia é definida em todo o mapa. Não é possível definir a criptografia de entrada 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 + Entry.
    3. Digite valores de propriedade para a nova entrada KVM, conforme descrito abaixo.
      Nome da propriedade Descrição
      Chave

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

      Observação: com o Edge para nuvem pública, 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 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. 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.