Zugriff der neuen Edge-Benutzeroberfläche auf lokale IP-Adressen zulassen

Es gibt mehrere Stellen, an denen die neue Edge-UI möglicherweise versucht, auf eine lokale IP-Adresse zuzugreifen. Diese lokalen IP-Adressen können privaten oder anderweitig geschützten Ressourcen entsprechen, die nicht für externe Nutzer zugänglich sein sollten:

  • Mit dem Trace-Tool in der neuen Edge-UI können API-Anfragen an eine beliebige angegebene URL gesendet und von dieser empfangen werden. In bestimmten Bereitstellungsszenarien, in denen Edge-Komponenten gemeinsam mit anderen internen Diensten gehostet werden, kann ein böswilliger Nutzer das Trace-Tool missbrauchen, indem er Anfragen an private IP-Adressen sendet.
  • Beim Erstellen eines API-Proxys aus einer OpenAPI-Spezifikation werden in der Spezifikation API-Elemente wie Basispfad, Pfade und Verben, Header usw. beschrieben. Im Rahmen der Spezifikation kann ein böswilliger Nutzer einen Basispfad des Proxys angeben, der auf eine private IP Adresse verweist.
  • Beim Erstellen eines API-Proxys aus einer WSDL-Datei, die sich auf einer privaten IP-Adresse oder in einem lokalen Netzwerk befindet.

Aus Sicherheitsgründen kann die neue Edge-UI standardmäßig nicht auf private IP Adressen verweisen. Die Liste der privaten IP-Adressen umfasst:

  • Loopback-Adresse (127.0.0.1 oder localhost)
  • Site-Local-Adressen (für IPv4: 10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16)
  • Beliebige lokale Adresse (jede Adresse, die in localhost aufgelöst wird).

Wenn Sie der neuen Edge-UI Zugriff auf private IP-Adressen gewähren möchten, legen Sie die folgenden Token fest:

  • Für das Trace-Tool ist die conf_uebe_trace_for_internal_addresses Eigenschaft standardmäßig deaktiviert (false). Setzen Sie sie auf true, um dem Trace-Tool Zugriff auf private IP-Adressen zu gewähren.
  • Für OpenAPI-Spezifikationen ist die conf_uebe_openapi_for_internal_addresses Eigenschaft standardmäßig deaktiviert (false). Setzen Sie sie auf true, um OpenAPI-Zugriff auf private IP-Adressen zu gewähren.
  • Für WSDL-Dateien ist die conf_uebe_wsdl_for_internal_addresses Eigenschaft standardmäßig deaktiviert (false). Setzen Sie sie auf true, um das Abrufen einer WSDL-Datei von privaten IP-Adressen zu ermöglichen.

So setzen Sie diese Eigenschaften auf true:

  1. Öffnen Sie die Datei management-ui.properties in einem Editor. Wenn die Datei nicht vorhanden ist, erstellen Sie sie:
    vi /opt/apigee/customer/application/management-ui.properties
  2. Setzen Sie die folgenden Eigenschaften auf true:
    conf_uebe_trace_for_internal_addresses=true
    conf_uebe_openapi_for_internal_addresses=true
    conf_uebe_wsdl_for_internal_addresses=true
  3. Speichern Sie die Änderungen in management-ui.properties.
  4. Prüfen Sie, ob die Eigenschaftendatei dem Nutzer apigee gehört:
    chown apigee:apigee /opt/apigee/customer/application/management-ui.properties
  5. Starten Sie die neue Edge-UI neu:
    /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

Die neue Edge-UI kann jetzt auf lokale IP-Adressen zugreifen.