Créer et modifier des cartes de clés-valeurs d'environnement

Vous consultez la documentation d'Apigee Edge.
Consultez la documentation Apigee X.
en savoir plus

Cet article explique comment créer et modifier des mappages de clés-valeurs (KVM) dans l'interface utilisateur. Les KVM que vous créez dans l'UI sont à l'échelle de l'environnement. Pour en savoir plus sur les KVM et le champ d'application, consultez la section Utiliser des mappages de clés-valeurs.

Activation des KVM chiffrées dans l'interface utilisateur Edge avec Edge for Private Cloud

Les KVM chiffrées sont prises en charge dans Edge for Private Cloud version 4.17.01 et ultérieures. Cependant, la prise en charge des KVM chiffrées dans l'interface utilisateur Edge est désactivée par défaut. Pour activer l'interface utilisateur Edge afin qu'elle prenne en charge les KVM chiffrées:

  1. Sur le serveur d'interface utilisateur Edge, ouvrez le fichier ui.properties dans un éditeur. Si le fichier n'existe pas, créez-le:
    > vi /opt/apigee/customer/application/ui.properties
  2. Définissez le jeton conf_apigee_apigee.feature.kvmencryption sur "true" :
    conf_apigee_apigee.feature.kvmencryption=true
  3. Enregistrez les modifications.
  4. Changez le propriétaire de ui.properties par "apigee":
    > chown apigee:apigee /opt/apigee/customer/application/ui.properties
  5. Redémarrez l'interface utilisateur Edge:
    > /<inst_root>/apigee/apigee-service/bin/apigee-service Edge-ui restart

Gérer les mappages de clés-valeurs de votre environnement

Gérez vos KVM comme décrit ci-dessous. Les KVM sont définis au niveau de l'environnement environment. Par exemple, si vous créez un KVM dans l'environnement "test", les proxys d'API exécutés dans l'environnement "prod" n'auront pas accès au KVM.

Périphérie

Pour gérer les KVM à l'aide de l'interface utilisateur Edge:

  1. Connectez-vous à apigee.com/edge.
  2. Sélectionnez Admin > Environnements > Cartes des clés-valeurs dans la barre de navigation de gauche.
  3. Pour créer un KVM :
    1. Cliquez sur + Mappage de clés-valeurs.
    2. Saisissez les valeurs des propriétés du nouveau KVM. Le tableau suivant décrit les paramètres.
      Nom de propriété Description
      Nom Nom du KVM. Doit être unique dans l'environnement. Faites référence à ce nom à partir des stratégies qui interagissent avec le KVM.
      ChiffréIndicateur spécifiant si le KVM est chiffré. Dans l'UI, les valeurs chiffrées s'affichent sous forme d'astérisques (*****). Le chiffrement est défini sur l'ensemble de la carte. Vous ne pouvez pas définir le chiffrement entrée par entrée.
      Remarque:Vous ne pouvez chiffrer les KVM que lorsque vous les créez. Vous ne pouvez ni chiffrer, ni déchiffrer un mappage clé-valeur après sa création.
    3. Cliquez sur Add (Ajouter).
  4. Pour ajouter une entrée à un KVM :
    1. Cliquez sur le nom du KMV dans la liste pour afficher les entrées actuelles.
    2. Cliquez sur le signe +.
    3. Saisissez les valeurs de propriété pour la nouvelle entrée KVM, comme décrit ci-dessous.
      Nom de propriété Description
      Clé

      Nom de clé que vous utiliserez pour accéder à la valeur de données dans vos proxys d'API.

      Avec Apigee Edge pour Cloud public, les noms de clés ne peuvent pas dépasser 2 Ko.

      Dans l'interface utilisateur Edge, les noms ne peuvent pas contenir "/".

      Valeur

      Valeur de la clé. Saisissez une combinaison de chiffres, de lettres ou de caractères spéciaux.

      Remarque:La taille totale d'un KVM ne peut pas dépasser 15 Mo.

    4. Cliquez sur Add (Ajouter).
  5. Pour gérer les entrées de clé dans un KVM :
    1. Cliquez sur le nom du KVM dans la liste pour afficher les entrées actuelles.
    2. Placez votre curseur sur l'entrée KVM pour afficher le menu d'actions et effectuer l'une des tâches suivantes :
      • Pour copier la valeur d'une entrée, cliquez sur .
      • Pour modifier une entrée, cliquez sur . Ensuite, modifiez l'entrée, puis cliquez sur Update (Mettre à jour).
      • Pour supprimer une entrée, cliquez sur . Cliquez ensuite sur Supprimer pour confirmer l'opération.

Classic Edge (cloud privé)

Pour créer et modifier des KVM à l'aide de l'interface utilisateur Classic Edge:

  1. Connectez-vous à http://ms-ip:9000, où ms-ip correspond à l'adresse IP ou au nom DNS du nœud du serveur de gestion.
  2. Sélectionnez API > Environment Configuration > Key Value Maps (API > Configuration de l'environnement > Cartes de clés-valeurs).
  3. Sélectionnez l'environnement pour lequel vous souhaitez configurer des caches, tel que test ou prod.
  4. Pour créer un KVM :
    1. Cliquez sur + Mappage de clés-valeurs.
    2. Saisissez les valeurs des propriétés pour le nouveau KVM, comme décrit ci-dessous.
      Nom de propriété Description
      Nom Nom du KVM. Doit être unique dans l'environnement. Faites référence à ce nom à partir des stratégies qui interagissent avec le KVM.
      ChiffréIndicateur spécifiant si le KVM est chiffré. Dans l'UI, les valeurs chiffrées s'affichent sous forme d'astérisques (*****). Le chiffrement est défini sur l'ensemble de la carte. Vous ne pouvez pas définir le chiffrement entrée par entrée.
      Remarque:Vous ne pouvez chiffrer les KVM que lorsque vous les créez. Vous ne pouvez ni chiffrer, ni déchiffrer un mappage clé-valeur après sa création.
    3. Cliquez sur Add (Ajouter).
  5. Pour ajouter une entrée à un KVM :
    1. Cliquez sur le nom du KVM dans la liste pour développer la liste des entrées.
    2. Cliquez sur + Entrée.
    3. Saisissez les valeurs de propriété pour la nouvelle entrée KVM, comme décrit ci-dessous.
      Nom de propriété Description
      Clé

      Nom de clé que vous utiliserez pour accéder à la valeur de données dans vos proxys d'API. Dans l'interface utilisateur Edge, les noms ne peuvent pas contenir "/".

      Remarque:Avec Edge pour Cloud public, les noms de clés ne peuvent pas dépasser 2 Ko.

      Valeur

      Valeur de la clé. Saisissez une combinaison de chiffres, de lettres ou de caractères spéciaux.

      Remarque:La taille totale d'un KVM ne peut pas dépasser 15 Mo.

    4. Cliquez sur Enregistrer.
  6. Pour modifier ou supprimer les entrées de clé dans un KVM :
    1. Cliquez sur le nom du KVM dans la liste pour développer sa liste d'entrées de clé.
    2. Effectuez l'une des actions suivantes :
      • Pour modifier une entrée, cliquez sur Modifier, modifiez l'entrée, puis cliquez sur Enregistrer.
      • Pour supprimer une entrée, cliquez sur Supprimer.