ADC

Importación y exportación de archivos

Puede importar objetos de error HTML o XML, esquemas XML, DTD y WSDL al Web App Firewall mediante la interfaz gráfica de usuario o la línea de comandos. Puede modificar cualquiera de estos archivos en un área de texto basada en la web después de importarlos, para realizar pequeños cambios directamente en NetScaler en lugar de tener que hacerlos en su equipo y, a continuación, volver a importarlos. Por último, puede exportar cualquiera de estos archivos a su equipo o eliminar cualquiera de estos archivos mediante la interfaz gráfica de usuario.

Nota:

No puede eliminar ni exportar un archivo importado mediante la línea de comandos.

Para importar un archivo mediante la interfaz de línea de comandos

En el símbolo del sistema, escriba los comandos siguientes:

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

Ejemplo

En el ejemplo siguiente se importa un objeto de error HTML de un archivo denominado error.html y se le asigna el nombre HTMLError.

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

Para importar un archivo mediante la interfaz gráfica de usuario

Antes de intentar importar un esquema XML, un archivo DTD o WSDL, o un objeto de error HTML o XML desde una ubicación de red, compruebe que NetScaler pueda conectarse a Internet o al equipo LAN en el que se encuentra el archivo. De lo contrario, no podrá importar el archivo o el objeto.

  1. Vaya a Seguridad > NetScaler Web App Firewall > Importaciones.

  2. Vaya a Application Firewall > Importaciones.

  3. En el panel Importaciones de Application Firewall, seleccione la ficha correspondiente al tipo de archivo que desea importar y, a continuación, haga clic en Agregar.

    Las fichas son Página de error HTML, Página de error XML, Esquema XML o WSDL. El proceso de subida es idéntico en las cuatro fichas desde el punto de vista del usuario.

  4. Rellene los campos de diálogo.

    • Nombre: un nombre para el objeto importado.

    • Importar desde: elija la ubicación del archivo HTML, el archivo XML, el esquema XML o el WSDL que desea importar en la lista desplegable:

      • URL: URL web de un sitio web al que puede acceder el dispositivo.
      • Archivo: archivo en un disco duro local o en red u otro dispositivo de almacenamiento.
      • Texto: escriba o pegue el texto de la respuesta personalizada directamente en un campo de texto de la GUI.

      El tercer cuadro de texto cambia al valor correspondiente. Los tres valores posibles se indican a continuación.

    • URL: escriba la URL en el cuadro de texto.

    • Archivo: escriba directamente la ruta y el nombre del archivo HTML o haga clic en Examinar para buscar el archivo HTML.

    • Texto: se elimina el tercer campo, dejando un espacio en blanco.

  5. Haga clic en Continuar. Aparece el cuadro de diálogo Contenido del archivo. Si elige URL o Archivo, el cuadro de texto Contenido del archivo contiene el archivo HTML que especificó. Si elige Texto, el cuadro de texto Contenido del archivo está vacío.

  6. Si eliges Texto, escribe o copia y pega el HTML de respuesta personalizado que deseas importar.

  7. Haga clic en Listo.

  8. Para eliminar un objeto, selecciónelo y, a continuación, haga clic en Eliminar.

Para exportar un archivo mediante la interfaz gráfica

Antes de intentar exportar un esquema XML, un archivo DTD o WSDL o un objeto de error HTML o XML, compruebe que el dispositivo Web App Firewall pueda acceder al equipo en el que se va a guardar el archivo. De lo contrario, no podrá exportar el archivo.

  1. Vaya a Seguridad > Web App Firewall > Importaciones.

  2. En el panel Importaciones de Web App Firewall, seleccione la ficha correspondiente al tipo de archivo que desea exportar.

    El proceso de exportación es idéntico en las cuatro fichas desde el punto de vista del usuario.

  3. Seleccione el archivo que quiera exportar.

  4. Amplíe la lista desplegable Acción y seleccione Exportar.

  5. En el cuadro de diálogo, seleccione Guardar archivo y haga clic en Aceptar.

  6. En el cuadro de diálogo Examinar, navegue hasta el sistema de archivos local y el directorio donde quiera guardar el archivo exportado y haga clic en Guardar.

Para modificar un objeto de error HTML o XML en la GUI

Edita el texto de los objetos de error HTML y XML en la GUI sin exportarlos y, a continuación, volver a importarlos.

  1. Vaya a Seguridad > NetScaler Web App Firewall > Importacionesy, a continuación, seleccione la ficha correspondiente al tipo de archivo que desea modificar.

  2. Vaya a Application Firewall > Importacionesy, a continuación, seleccione la ficha correspondiente al tipo de archivo que desea modificar.

  3. Seleccione el archivo que quiera modificar y, a continuación, haga clic en Modificar.

    El texto del objeto de error HTML o XML se muestra en un área de texto del navegador. Puede modificar el texto mediante las herramientas y métodos de edición estándar de su navegador.

    Nota: La ventana de edición está diseñada para permitirle realizar cambios menores en el objeto de error HTML o XML. Para realizar cambios exhaustivos, puede preferir exportar el objeto de error a su equipo local y utilizar las herramientas estándar de edición de páginas web HTML o XML.

  4. Haga clic en Aceptar y, a continuación, en Cerrar.

Gestione los archivos de especificación de API mediante la CLI

Puede validar el tráfico de la API entrante comparándolo con la especificación de la API importada asignándolo a un perfil y configurando una regla de relajación para bloquear o permitir el tráfico. También puede utilizar la especificación de API importada para crear expresiones de directivas. La importación de una especificación de API consta de dos pasos:

  1. Importar la especificación de la API: importe una especificación de la API a NetScaler a través de una URL o desde el sistema.
  2. Agregue la especificación de API a NetScaler: al agregar una especificación de API a NetScaler, el archivo se valida, se convierte a un formato interno y se crea una entidad de especificación de API. La entidad de especificación de API creada se utilizará en las expresiones de directivas y en los perfiles de Web App Firewall.

Los siguientes parámetros se utilizan en los comandos de la CLI:

  • Nombre: nombre del archivo de especificación de API que se carga.
  • Origen: URL (protocolo, host, ruta y nombre) de la ubicación en la que se almacena el archivo de especificaciones importado.
  • Nombre de especificación: E l nombre de la entidad que se crea a partir de la especificación de API cargada.
  • Tipo: formato de entrada de la especificación de la API. Valor predeterminado: OAS

Para importar un archivo de especificación de API, escriba:

import api specFile <name> <src>

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

Para agregar un archivo de especificación de API, escriba:

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

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

Para actualizar un archivo de especificaciones de API, importe un nuevo archivo de especificaciones que deba actualizarse.

En la línea de comandos, escriba:

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

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

Nota:

Si no se especifica el atributo type, OAS es el tipo predeterminado.

Para ver todos los puntos finales, escriba:

show api spec <specName>

Ejemplo:

show api spec testapispec

Para eliminar la especificación de la API, escriba:

rm api spec <specName>

Ejemplo:

rm api spec testapispec

Nota:

Antes de eliminar la especificación de la API, asegúrese de que ningún perfil o directiva la utilice.

Gestione los archivos de especificación de API mediante la GUI

  1. Vaya a Seguridad > NetScaler Web App Firewall > Importaciones.
  2. En la página Importaciones, seleccione la ficha Página de importación de especificaciones de API y, a continuación, haga clic en Agregar.
  3. En la página Importar objetos de especificación de API, seleccione una de las siguientes opciones para el parámetro Importar desde :
    1. URL: URL web de un sitio web al que puede acceder el dispositivo.
    2. Archivo: archivo en un disco duro local o en red u otro dispositivo de almacenamiento.
  4. Haga clic en Continuar.
  5. En la página de objetos de importación de especificaciones de API, introduzca los siguientes detalles:
    1. Nombre de especificación de API: el nombre de la entidad que se crea a partir de la especificación de API cargada. Nota: Tanto el nombre del archivo de la API como el nombre de la especificación de la API introducidos deben ser iguales.
    2. Tipo de especificación de API: seleccione el tipo de especificación.

      Tipos: REST (OpenAPI/Swagger) y gRPC (PROTO).

      Tipo predeterminado: REST (OpenAPI/Swagger)

    3. Haga clic en Listo.

La entidad recién agregada aparece en la página Importaciones, en la ficha Página de importación de especificaciones de API.