Vous consultez la documentation Apigee Edge.
Accédez à la
documentation Apigee X. info
Cette rubrique explique comment créer et modifier des mappages clé-valeur dans l'interface utilisateur. Les mappages clé-valeur que vous créez dans l'interface utilisateur sont limités à l'environnement. Pour en savoir plus sur les mappages clé-valeur et leur champ d'application, consultez la section Utiliser des mappages clé-valeur.
Activer les mappages clé-valeur chiffrés dans l' interface utilisateur Edge avec Edge pour le cloud privé
Les mappages clé-valeur chiffrés sont compatibles avec Edge pour le cloud privé version 4.17.01 et ultérieures. Toutefois, la prise en charge des mappages clé-valeur chiffrés dans l'interface utilisateur Edge est désactivée par défaut. Pour activer la prise en charge des mappages clé-valeur chiffrés dans l'interface utilisateur Edge :
- Sur le serveur de l'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 - Définissez le jeton conf_apigee_apigee.feature.kvmencryption
sur "true" :
conf_apigee_apigee.feature.kvmencryption=true - Enregistrez les modifications.
- Remplacez le propriétaire de ui.properties par "apigee" :
> chown apigee:apigee /opt/apigee/customer/application/ui.properties - Redémarrez l'interface utilisateur Edge :
> /<inst_root>/apigee/apigee-service/bin/apigee-service edge-ui restart
Gérer les mappages clé-valeur de votre environnement
Gérez vos mappages clé-valeur comme décrit ci-dessous. Les mappages clé-valeur sont définis au niveau de l'environnement. Par exemple, si vous créez un mappage clé-valeur dans l'environnement de test, les proxys d'API exécutés dans l'environnement de production n'y auront pas accès.
Edge
Pour gérer les mappages clé-valeur à 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 un mappage clé-valeur :
- Cliquez sur + Mappage clé-valeur.
- Saisissez les valeurs de propriété pour le nouveau mappage clé-valeur. Le tableau suivant décrit les paramètres.
Nom de la propriété Description Nom Nom du mappage clé-valeur. Doit être unique dans l'environnement. Faites référence à ce nom à partir de stratégies qui interagissent avec le mappage clé-valeur. Chiffré Indicateur spécifiant si le mappage clé-valeur est chiffré. Dans l'interface utilisateur, les valeurs chiffrées apparaissent sous forme d'astérisques (*****). Le chiffrement est défini sur l'ensemble du mappage. Vous ne pouvez pas définir le chiffrement entrée 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 à un mappage clé-valeur :
- Cliquez sur le nom du mappage clé-valeur dans la liste pour afficher les entrées actuelles.
- Cliquez sur +.
- Saisissez les valeurs de propriété pour la nouvelle entrée de mappage clé-valeur, 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 pour le 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 n'importe quelle combinaison de chiffres, de lettres ou de caractères spéciaux.
Remarque : La taille totale d'un mappage clé-valeur ne peut pas dépasser 15 Mo.
- Cliquez sur Ajouter.
- Pour gérer les entrées de clé dans un mappage clé-valeur :
- Cliquez sur le nom du mappage clé-valeur dans la liste pour afficher les entrées actuelles.
- Placez le curseur sur l'entrée du mappage clé-valeur pour afficher le menu des actions et 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 et 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 mappages clé-valeur à l'aide de l'interface utilisateur Edge classique :
- Connectez-vous à
http://ms-ip:9000, où ms-ip correspond à l' adresse IP ou au 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 un mappage clé-valeur :
- Cliquez sur + Mappage clé-valeur.
- Saisissez les valeurs de propriété pour le nouveau mappage clé-valeur, comme décrit ci-dessous.
Nom de la propriété Description Nom Nom du mappage clé-valeur. Doit être unique dans l'environnement. Faites référence à ce nom à partir de stratégies qui interagissent avec le mappage clé-valeur. Chiffré Indicateur spécifiant si le mappage clé-valeur est chiffré. Dans l'interface utilisateur, les valeurs chiffrées apparaissent sous forme d'astérisques (*****). Le chiffrement est défini sur l'ensemble du mappage. Vous ne pouvez pas définir le chiffrement entrée 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 à un mappage clé-valeur :
- Cliquez sur le nom du mappage clé-valeur dans la liste pour développer la liste de ses entrées.
- Cliquez sur + Entrée.
- Saisissez les valeurs de propriété pour la nouvelle entrée de mappage clé-valeur, 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 Edge, les noms ne peuvent pas contenir "/"
Remarque : Avec Edge pour le cloud public, les noms de clés ne peuvent pas dépasser 2 Ko.
Valeur Valeur de la clé. Saisissez n'importe quelle combinaison de chiffres, de lettres ou de caractères spéciaux.
Remarque : La taille totale d'un mappage clé-valeur ne peut pas dépasser 15 Mo.
- Cliquez sur Enregistrer.
- Pour modifier ou supprimer les entrées de clé dans un mappage clé-valeur :
- Cliquez sur le nom du mappage clé-valeur dans la liste pour développer la liste de ses entrées de clé.
- 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.