ADC

导入和导出文件

您可以使用 GUI 或命令行将 HTML 或 XML 错误对象、XML 架构、DTD 和 WSDL 导入 Web App Firewall。导入这些文件后,您可以在基于 Web 的文本区域中对其进行编辑,直接在 NetScaler 上进行小更改,而不必在计算机上进行然后重新导入。最后,您可以使用 GUI 将这些文件中的任何一个导出到您的计算机上,或者删除其中任何一个文件。

注意:

您无法使用命令行删除或导出导入的文件。

使用命令行界面导入文件

在命令提示符下,键入以下命令:

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

示例

以下示例从名为 error.html 的文件中导入一个 HTML 错误对象,并将其命名为 HTMLError。

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

使用 GUI 导入文件

在尝试从网络位置导入 XML 架构、DTD 或 WSDL 文件或 HTML 或 XML 错误对象之前,请验证 NetScaler 是否可以连接到文件所在的互联网或局域网计算机。否则,您将无法导入文件或对象。

  1. 导航到“安全”>“NetScaler Web App Firewall”>“导入”

  2. 导航到 应用程序防火墙 > 导入

  3. 在“应用程序防火墙导入”窗格中,选择要导入的文件类型的选项卡,然后单击“添加”。

    这些选项卡是 HTML 错误页面、XML 错误页面、XML 架构或 WSDL。从用户的角度来看,所有四个选项卡上的上载过程是相同的。

  4. 填写对话框字段。

    • 名称—导入对象的名称。

    • 导入自-在下拉列表中选择要导入的 HTML 文件、XML 文件、XML 架构或 WSDL 的位置:

      • URL: 设备可访问的网站上的 Web URL。
      • 文件: 本地或联网硬盘或其他存储设备上的文件。
      • 文本: 将自定义响应的文本直接键入或粘贴到 GUI 的文本字段中。

      第三个文本框更改为相应的值。下面提供了三个可能的值。

    • URL—在文本框中键入 URL。

    • 文件-直接键入 HTML 文件的路径和文件名,或单击“浏览”并浏览到 HTML 文件。

    • 文本—移除第三个字段,留下一个空白。

  5. 单击继续。将显示“文件内容”对话框。如果您选择 URL 或文件,则文件内容文本框包含您指定的 HTML 文件。如果您选择文本,则文件内容文本框为空。

  6. 如果您选择文本,请键入或复制并粘贴要导入的自定义响应 HTML。

  7. 单击 Done(完成)。

  8. 要删除对象,请选择该对象,然后单击“删除”。

使用 GUI 导出文件

在尝试导出 XML 架构、DTD 或 WSDL 文件或 HTML 或 XML 错误对象之前,请确认 Web App Firewall 设备可以访问要保存文件的计算机。否则,您将无法导出该文件。

  1. 导航到“安全”>“Web App Firewall”>“导入”。

  2. Web App Firewall 导 入窗格中,选择要导出的文件类型的选项卡。

    从用户的角度来看,所有四个选项卡上的导出过程是相同的。

  3. 选择要导出的文件。

  4. 展开“操作”下拉列表,然后选择“导出”。

  5. 在对话框中,选择“保存文件”,然后单击“确定”

  6. 在“浏览”对话框中,导航到要保存导出文件的本地文件系统和目录,然后单击“保存”。

在 GUI 中编辑 HTML 或 XML 错误对象

您可以在 GUI 中编辑 HTML 和 XML 错误对象的文本,而无需导出然后重新导入它们。

  1. 导航到“安全”>“NetScaler Web App Firewall”>“导入”,然后选择要修改的文件类型的选项卡。

  2. 导航到“应用程序防火墙”>“入”,然后选择要修改的文件类型的选项卡。

  3. 选择要修改的文件,然后单击“编辑”。

    HTML 或 XML 错误对象的文本显示在浏览器文本区域中。您可以使用基于浏览器的标准编辑工具和方法来修改文本。

    注意:编辑窗口旨在允许您对 HTML 或 XML 错误对象进行细微的更改。要进行大量更改,您可能更愿意将错误对象导出到本地计算机并使用标准的 HTML 或 XML 网页编辑工具。

  4. 单击“确定”,然后单击“关闭”。

使用 CLI 管理 API 规范文件

您可以根据导入的 API 规范验证传入的 API 流量,方法是将其分配给配置文件并设置屏蔽或允许流量的放松规则。您还可以在创建策略表达式时使用导入的 API 规范。导入 API 规范包括两个步骤:

  1. 导入 API 规范 - 通过 URL 或从系统将 API 规范导入到 NetScaler。
  2. 将 API 规范添加到 NetScaler-将 API 规范添加到 NetScaler 时,文件将经过验证,转换为内部格式,并创建 API 规范实体。创建的 API 规范实体将用于策略表达式和 Web App Firewall 配置文件。

CLI 命令中使用了以下参数:

  • 名称-上载的 API 规范文件的名称。
  • 来源 - 存储导入的规范文件位置的 URL(协议、主机、路径和名称)。
  • 规范名称 - 根据上载的 API 规范创建的实体的名称。
  • 类型 - API 规范的输入格式。 默认值:OAS

要导入 API 规范文件,请键入:

import api specFile <name> <src>

示例:
import apispec testapispec.json http://www.example.com/testapispec.json

要添加 API 规范文件,请键入:

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

示例:
add api spec testapispec -File testapispec.json -Type OAS

要更新 API 规范文件,请导入需要更新的新规范文件。

在命令提示符下,键入:

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

示例:
update api spec testapispec -File testapispec.json -Type OAS

注意:

如果未指定类型属性,则 OAS 是默认类型。

要查看所有端点,请键入:

show api spec <specName>

示例:

show api spec testapispec

要删除 API 规范,请键入:

rm api spec <specName>

示例:

rm api spec testapispec

注意:

在删除 API 规范之前,请确保任何配置文件或策略均未使用该规范。

使用 GUI 管理 API 规范文件

  1. 导航到“安全”>“NetScaler Web App Firewall”>“导入”
  2. 在“导入”页面上,选择“API 规范导入页面”选项卡,然后单击“添加”。
  3. API 规范导入对象 页面上,为“导入自”参数选择以下任一选项:
    1. URL: 设备可访问的网站上的 Web URL。
    2. 文件: 本地或联网硬盘或其他存储设备上的文件。
  4. 单击继续
  5. API 规范导入对象 页面上,输入以下详细信息:
    1. API 规范名称 — 根据上载的 API 规范创建的实体的名称。 注意:输入的 API 文件名和 API 规范名称应相同。
    2. API 规格类型-选择规范的类型。

      类型:REST (OpenAPI/Swagger) 和 gRPC(PROTO)。

      默认类型:REST (OpenAPI/Swagger)

    3. 单击 Done(完成)。

新添加的实体在 API 规范导入页面选项卡下的“导入”页面中列出。

导入和导出文件