Produktdokumentation
ADC
14.1 - Current Release 13.1 13.0 12.1
PDF anzeigen

Dateien importieren und exportieren

December 12, 2023
Beitrag von: 
C

Sie können HTML- oder XML-Fehlerobjekte, XML-Schemas, DTDs und WSDLs mithilfe der GUI oder der Befehlszeile in die Web App Firewall importieren. Sie können jede dieser Dateien nach dem Import in einem webbasierten Textbereich bearbeiten, um kleine Änderungen direkt auf dem NetScaler vorzunehmen, anstatt sie auf Ihrem Computer vornehmen und dann erneut importieren zu müssen. Schließlich können Sie mithilfe der GUI jede dieser Dateien auf Ihren Computer exportieren oder diese Dateien löschen.

Hinweis:

Sie können eine importierte Datei nicht mithilfe der Befehlszeile löschen oder exportieren.

So importieren Sie eine Datei mithilfe der Befehlszeilenschnittstelle

Geben Sie an der Eingabeaufforderung die folgenden Befehle ein:

  • import appfw htmlerrorpage <src> <name>
  • <save> ns config

Beispiel

Im folgenden Beispiel wird ein HTML-Fehlerobjekt aus einer Datei namens error.html importiert und ihm der Name HtmlError zugewiesen.

import htmlerrorpage error.html HTMLError
save ns config
<!--NeedCopy-->

Um eine Datei mit der GUI zu importieren

Bevor Sie versuchen, ein XML-Schema, eine DTD- oder WSDL-Datei oder ein HTML- oder XML-Fehlerobjekt von einem Netzwerkspeicherort zu importieren, stellen Sie sicher, dass der NetScaler eine Verbindung zum Internet- oder LAN-Computer herstellen kann, auf dem sich die Datei befindet. Andernfalls können Sie die Datei oder das Objekt nicht importieren.

  1. Navigieren Sie zu Sicherheit > NetScaler Web App Firewall > Importe.

  2. Navigieren Sie zu Application Firewall > Importe.

  3. Wählen Sie im Bereich Application Firewall-Importe die Registerkarte für den Dateityp aus, den Sie importieren möchten, und klicken Sie dann auf Hinzufügen.

    Die Registerkarten lauten HTML-Fehlerseite, XML-Fehlerseite, XML-Schema oder WSDL. Der Upload-Vorgang ist aus Benutzersicht auf allen vier Tabs identisch.

  4. Füllen Sie die Dialogfelder aus.

    • Name— Ein Name für das importierte Objekt.

    • Importieren von— Wählen Sie in der Dropdownliste den Speicherort der HTML-Datei, der XML-Datei, des XML-Schemas oder der WSDL aus, die Sie importieren möchten:

      • URL: Eine Web-URL auf einer Website, auf die die Appliance zugreifen kann.
      • Datei: Eine Datei auf einer lokalen oder Netzwerkfestplatte oder einem anderen Speichergerät.
      • Text: Geben Sie den Text der benutzerdefinierten Antwort direkt in ein Textfeld in der GUI ein oder fügen Sie ihn ein.

      Das dritte Textfeld ändert sich in den entsprechenden Wert. Die drei möglichen Werte sind unten angegeben.

    • URL— Geben Sie die URL in das Textfeld ein.

    • Datei— Geben Sie den Pfad und den Dateinamen der HTML-Datei direkt ein, oder klicken Sie auf Durchsuchen und suchen Sie nach der HTML-Datei.

    • Text— Das dritte Feld wird entfernt, sodass ein Leerzeichen übrig bleibt.

  5. Klicken Sie auf Weiter. Das Dialogfeld „Dateiinhalt“ wird angezeigt. Wenn Sie URL oder Datei ausgewählt haben, enthält das Textfeld Dateiinhalt die von Ihnen angegebene HTML-Datei. Wenn Sie Text ausgewählt haben, ist das Textfeld Dateiinhalt leer.

  6. Wenn Sie Text ausgewählt haben, geben Sie den benutzerdefinierten Antwort-HTML-Code ein, den Sie importieren möchten, oder kopieren Sie ihn und fügen Sie ihn ein.

  7. Klicken Sie auf Fertig.

  8. Um ein Objekt zu löschen, wählen Sie das Objekt aus, und klicken Sie dann auf Löschen.

Um eine Datei mit der GUI zu exportieren

Bevor Sie versuchen, ein XML-Schema, eine DTD- oder WSDL-Datei oder ein HTML- oder XML-Fehlerobjekt zu exportieren, stellen Sie sicher, dass die Web App Firewall Appliance auf den Computer zugreifen kann, auf dem die Datei gespeichert werden soll. Andernfalls können Sie die Datei nicht exportieren.

  1. Navigieren Sie zu Sicherheit > Web App Firewall > Importe.

  2. Wählen Sie im Bereich Web App Firewall-Importe die Registerkarte für den Dateityp aus, den Sie exportieren möchten.

    Der Exportvorgang ist aus Benutzersicht auf allen vier Tabs identisch.

  3. Wählen Sie die Datei aus, die Sie exportieren möchten.

  4. Erweitern Sie die Dropdownliste Aktion und wählen Sie Exportierenaus.

  5. Wählen Sie im Dialogfeld Datei speichern und klicken Sie auf OK.

  6. Navigieren Sie im Dialogfeld Durchsuchen zu dem lokalen Dateisystem und Verzeichnis, in dem Sie die exportierte Datei speichern möchten, und klicken Sie auf Speichern.

So bearbeiten Sie ein HTML- oder XML-Fehlerobjekt in der GUI

Sie bearbeiten den Text von HTML- und XML-Fehlerobjekten in der GUI, ohne sie zu exportieren und dann erneut zu importieren.

  1. Navigieren Sie zu Sicherheit > NetScaler Web App Firewall > Importeund wählen Sie dann die Registerkarte für den Dateityp aus, den Sie ändern möchten.

  2. Navigieren Sie zu Application Firewall > Importeund wählen Sie dann die Registerkarte für den Dateityp aus, den Sie ändern möchten.

  3. Wählen Sie die Datei aus, die Sie ändern möchten, und klicken Sie dann auf Bearbeiten.

    Der Text des HTML- oder XML-Fehlerobjekts wird in einem Browser-Textbereich angezeigt. Sie können den Text ändern, indem Sie die standardmäßigen browserbasierten Bearbeitungstools und -methoden für Ihren Browser verwenden.

    Hinweis: Das Bearbeitungsfenster ist so konzipiert, dass Sie kleinere Änderungen an Ihrem HTML- oder XML-Fehlerobjekt vornehmen können. Um umfangreiche Änderungen vorzunehmen, ziehen Sie es möglicherweise vor, das Fehlerobjekt auf Ihren lokalen Computer zu exportieren und Standardtools zur Bearbeitung von HTML- oder XML-Webseiten zu verwenden.

  4. Klicken Sie auf OKund dann auf Schließen.

API-Spezifikationsdateien mit CLI verwalten

Sie können eingehenden API-Verkehr anhand der importierten API-Spezifikation validieren, indem Sie ihn einem Profil zuweisen und eine Entspannungsregel festlegen, um den Datenverkehr entweder zu blockieren oder zuzulassen. Sie können die importierte API-Spezifikation auch beim Erstellen von Richtlinienausdrücken verwenden. Das Importieren einer API-Spezifikation besteht aus zwei Schritten:

  1. API-Spezifikation importieren — Importiert eine API-Spezifikation über eine URL oder aus dem System in NetScaler.
  2. Fügen Sie die API-Spezifikation zu NetScaler hinzu — Wenn Sie eine API-Spezifikation zu NetScaler hinzufügen, wird die Datei validiert, in ein internes Format konvertiert und eine API-Spezifikationsentität wird erstellt. Die erstellte API-Spezifikationsentität wird in Richtlinienausdrücken und Web App Firewall-Profilen verwendet.

Die folgenden Parameter werden in den CLI-Befehlen verwendet:

  • Name — Name der API-Spezifikationsdatei, die hochgeladen wird.
  • Quelle — URL (Protokoll, Host, Pfad und Name) für den Speicherort der importierten Spezifikationsdatei.
  • Spezifikationsname — Der Name der Entität, die aus der hochgeladenen API-Spezifikation erstellt wurde.
  • Typ — Eingabeformat der API-Spezifikation. Standardwert: OAS

Um eine API-Spezifikationsdatei zu importieren, geben Sie Folgendes ein:

import api specFile <name> <src>

Beispiel:
import apispec testapispec.json http://www.example.com/testapispec.json

Um eine API-Spezifikationsdatei hinzuzufügen, geben Sie Folgendes ein:

add api spec <Name> -File <string> -Type <string>

Beispiel:
add api spec testapispec -File testapispec.json -Type OAS

Um eine API-Spezifikationsdatei zu aktualisieren, importieren Sie eine neue Spezifikationsdatei, die aktualisiert werden muss.

Geben Sie in der Befehlszeile Folgendes ein:

update api spec <specName> -File <string> -Type <string>

Beispiel:
update api spec testapispec -File testapispec.json -Type OAS

Hinweis:

Wenn das Typattribut nicht angegeben ist, ist OAS der Standardtyp.

Um alle Endpoints anzuzeigen, geben Sie Folgendes ein:

show api spec <specName>

Beispiel:

show api spec testapispec

Um die API-Spezifikation zu löschen, geben Sie Folgendes ein:

rm api spec <specName>

Beispiel:

rm api spec testapispec

Hinweis:

Bevor Sie die API-Spezifikation entfernen, stellen Sie sicher, dass sie von keinem Profil oder keiner Richtlinie verwendet wird.

API-Spezifikationsdateien mit der GUI verwalten

  1. Navigieren Sie zu Sicherheit > NetScaler Web App Firewall > Importe.
  2. Wählen Sie auf der Seite Importe die Registerkarte API-Spezifikations-Importseite aus, und klicken Sie dann auf Hinzufügen.
  3. Wählen Sie auf der Seite „ API-Spezifikations-Objekt importieren “ eine der folgenden Optionen für den Parameter Import From aus :
    1. URL: Eine Web-URL auf einer Website, auf die die Appliance zugreifen kann.
    2. Datei: Eine Datei auf einer lokalen oder Netzwerkfestplatte oder einem anderen Speichergerät.
  4. Klicken Sie auf Weiter.
  5. Geben Sie auf der Seite „ API-Spezifikationsimport-Objekt “ die folgenden Details ein:
    1. API-Spezifikationsname — Der Name der Entität, die aus der hochgeladenen API-Spezifikation erstellt wird. Hinweis: Sowohl der API-Dateiname als auch der eingegebene API-Spezifikationsname sollten identisch sein.

    2. API-Spezifikationstyp — Wählen Sie den Spezifikationstyp aus.

      Typen: REST (OpenAPI/Swagger) und gRPC (PROTO).

      Standardtyp: REST (OpenAPI/Swagger)

    3. Klicken Sie auf Fertig.

Die neu hinzugefügte Entität wird auf der Seite Importe auf der Registerkarte API-Spezifikations-Importseiteaufgeführt.

Dateien importieren und exportieren
December 12, 2023
Beitrag von: 
C
December 12, 2023
Beitrag von: 
C

In diesem Artikel

Feedback zur Site | Datenschutz und rechtliche Bestimmungen | Cookie-Einstellungen | Einstellungen für die Zustimmung | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.