Autoriser l'accès de l'interface utilisateur périphérique aux adresses IP locales

Edge for Private Cloud v. 4.16.05

L'UI Edge tente d'accéder à une adresse IP locale à plusieurs endroits :

  • L'outil Trace de l'interface utilisateur Edge permet d'envoyer et de recevoir des requêtes API vers n'importe quelle URL spécifiée. Dans certains scénarios de déploiement où les composants Edge sont co-hébergés avec d'autres services internes, un utilisateur malveillant peut utiliser de manière abusive l'outil Trace en envoyant des requêtes à des adresses IP privées.
  • Lorsque vous créez un proxy d'API à partir d'une spécification OpenAPI, celle-ci décrit des éléments d'une API, tels que son chemin de base, ses chemins et verbes, ses en-têtes, etc. Dans la spécification, vous pouvez indiquer un chemin de base du proxy qui fait référence à une adresse IP privée.
  • Lorsque vous créez un proxy d'API à partir d'un fichier WSDL situé sur votre système de fichiers local.

Par défaut, l'UI Edge ne peut pas référencer d'adresses IP privées. La liste des adresses IP privées comprend les éléments suivants :

  • Adresse loopback (127.0.0.1 ou localhost)
  • Adresses locales de site (pour IPv4 : 10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16)
  • Toute adresse locale (toute adresse se résolvant en localhost).

Si vous souhaitez autoriser l'UI Edge à accéder aux adresses IP privées, définissez les jetons suivants :

  • Pour l'outil Trace, la propriété conf_apigee-base_apigee.feature.enabletraceforinternaladdresses est désactivée par défaut. Définissez-la sur "true" pour permettre à l'outil Trace d'accéder aux adresses IP privées.
  • Pour les spécifications OpenAPI, la propriété conf_apigee-base_apigee.feature.enableopenapiforinternaladdresses est désactivée par défaut. Définissez-le sur "true" pour activer l'accès OpenAPI aux adresses IP privées. Nécessite Edge 4.16.09.01. Pour en savoir plus, consultez les notes de version 4.16.05.05 d'Edge for Private Cloud.
  • Pour les fichiers WSDL, la propriété conf_apigee-base_apigee.feature.enablewsdlforinternaladdresses est désactivée par défaut. Définissez cette option sur "true" pour activer l'importation d'un fichier WSDL à partir d'adresses IP privées.

Pour définir ces propriétés sur "true" :

  1. Ouvrez le fichier ui.properties dans un éditeur. Si le fichier n'existe pas, créez-le.
    > vi /<inst_root>/apigee/customer/application/ui.properties
  2. Définissez les propriétés suivantes sur "true" :
    conf_apigee-base_apigee.feature.enabletraceforinternaladdresses="true"
    conf_apigee-base_apigee.feature.enableopenapiforinternaladdresses="true"
    conf_apigee-base_apigee.feature.enablewsdlforinternaladdresses="true"
  3. Enregistrez les modifications apportées à ui.properties.
  4. Redémarrez l'interface utilisateur Edge :
    > /<inst_root>/apigee/apigee-service/bin/apigee-service edge-ui restart

L'UI Edge peut désormais accéder aux adresses IP locales.