Vous consultez la documentation d'Apigee Edge.
Accédez à la documentation sur Apigee X. info
Cette section explique comment créer et modifier des mappages clé-valeur (KVM) dans l'interface utilisateur. Les mappages clé-valeur que vous créez dans l'UI sont limités à un environnement. Pour en savoir plus sur les KVM et la portée, consultez la section Utiliser des mappages clé-valeur.
Activer les KVM chiffrés dans l'interface utilisateur Edge avec Edge pour le cloud privé
Les KVM chiffrés sont compatibles avec Edge pour Private Cloud version 4.17.01 et ultérieure. Toutefois, la prise en charge des KVM chiffrés dans l'interface utilisateur d'Edge est désactivée par défaut. Pour permettre à l'interface utilisateur Edge d'accepter les KVM chiffrés:
- Sur le serveur de l'UI 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 - Définissez le jeton conf_apigee_apigee.feature.kvmencryption sur "true" :
conf_apigee_apigee.feature.kvmencryption=true - Enregistrez les modifications.
- Définissez le propriétaire de ui.properties sur "apigee":
> chown apigee:apigee /opt/apigee/customer/application/ui.properties - Redémarrez l'UI Edge:
> /<inst_root>/apigee/apigee-service/bin/apigee-service edge-ui restart
Gérer les mappages clés-valeurs de votre environnement
Gérez vos KVM, comme décrit ci-dessous. Les KVM sont définis au niveau du champ d'application de l'environnement. Par exemple, si vous créez un KVM dans l'environnement de test, les proxys d'API exécutés dans l'environnement de production n'auront pas accès au KVM.
Edge
Pour gérer les KVM à l'aide de l'interface utilisateur Edge:
- Connectez-vous à apigee.com/edge.
- Sélectionnez Admin > Environnements > Mappages clé-valeur dans la barre de navigation de gauche.
- Pour créer une KVM :
- Cliquez sur + Mappage clé-valeur.
- Saisissez les valeurs de propriété du nouveau KVM. Le tableau suivant décrit les paramètres.
Nom de la propriété Description Nom Nom de la KVM. Doit être unique dans l'environnement. Référencez ce nom à partir des règles qui interagissent avec le KVM. Chiffré Indicateur indiquant si le KVM est chiffré. Dans l'interface utilisateur, les valeurs chiffrées s'affichent sous forme d'astérisques (*****). Le chiffrement est défini pour l'ensemble de la carte. Vous ne pouvez pas définir le chiffrement par entrée.
Remarque:Vous ne pouvez chiffrer les mappages clé-valeur que lorsque vous les créez. Vous ne pouvez pas chiffrer ni déchiffrer un mappage clé-valeur une fois qu'il a été créé. - Cliquez sur Ajouter.
- Pour ajouter une entrée à une KVM :
- Cliquez sur le nom du KMV dans la liste pour afficher les entrées actuelles.
- Cliquez sur le signe +.
- Saisissez les valeurs de propriété de la nouvelle entrée KVM, comme décrit ci-dessous.
Nom de la propriété Description Clé Nom de la clé que vous utiliserez pour accéder à la valeur des données dans vos proxys d'API.
Avec Apigee Edge for Public Cloud, les noms de clés ne peuvent pas dépasser 2 Ko.
Dans l'interface utilisateur d'Edge, les noms ne peuvent pas contenir de "/".
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 doit pas dépasser 15 Mo.
- Cliquez sur Ajouter.
- Pour gérer les entrées de clé dans un KVM :
- Cliquez sur le nom du KVM dans la liste pour afficher les entrées actuelles.
- Placez le curseur sur l'entrée KVM pour afficher le menu d'actions, puis effectuez l'une des tâches suivantes :
- Pour copier la valeur d'une entrée, cliquez sur
. - Pour modifier une entrée, cliquez sur
. Modifiez ensuite l'entrée, puis cliquez sur Mettre à jour. - Pour supprimer une entrée, cliquez sur
. Cliquez ensuite sur Supprimer pour confirmer l'opération.
- Pour copier la valeur d'une entrée, cliquez sur
Edge classique (cloud privé)
Pour créer et modifier des KVM à l'aide de l'interface utilisateur Classic Edge:
- Connectez-vous à
http://ms-ip:9000, où ms-ip est l'adresse IP ou le nom DNS du nœud de serveur de gestion. - Sélectionnez API > Configuration de l'environnement > Mappages clé-valeur.
- Sélectionnez l'environnement pour lequel vous souhaitez configurer des caches, par exemple test ou prod.
- Pour créer une KVM :
- Cliquez sur + Mappage clé-valeur.
- Saisissez les valeurs de propriété du nouveau KVM, comme décrit ci-dessous.
Nom de la propriété Description Nom Nom de la KVM. Doit être unique dans l'environnement. Référencez ce nom à partir des règles qui interagissent avec le KVM. Chiffré Indicateur indiquant si le KVM est chiffré. Dans l'interface utilisateur, les valeurs chiffrées s'affichent sous forme d'astérisques (*****). Le chiffrement est défini pour l'ensemble de la carte. Vous ne pouvez pas définir le chiffrement par entrée.
Remarque:Vous ne pouvez chiffrer les mappages clé-valeur que lorsque vous les créez. Vous ne pouvez pas chiffrer ni déchiffrer un mappage clé-valeur une fois qu'il a été créé. - Cliquez sur Ajouter.
- Pour ajouter une entrée à une KVM :
- Cliquez sur le nom du KVM dans la liste pour développer sa liste d'entrées.
- Cliquez sur + Entrée.
- Saisissez les valeurs de propriété de la nouvelle entrée KVM, comme décrit ci-dessous.
Nom de la propriété Description Clé Nom de la clé que vous utiliserez pour accéder à la valeur des données dans vos proxys d'API. Dans l'interface utilisateur d'Edge, les noms ne peuvent pas contenir de "/".
Remarque:Avec Edge pour le cloud public, les noms de clé ne doivent 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 doit pas dépasser 15 Mo.
- Cliquez sur Enregistrer.
- Pour modifier ou supprimer les entrées de clé dans un KVM :
- Cliquez sur le nom de la KVM dans la liste pour développer sa liste d'entrées de clé.
- Effectuez l'une des actions suivantes :
- Pour modifier une entrée, cliquez sur Modifier, modifiez-la, puis cliquez sur Enregistrer.
- Pour supprimer une entrée, cliquez sur Supprimer.