Descubra los puntos finales de API

Puede ver los dispositivos de punto final de API detectados que se encuentran en su organización mediante API Security. NetScaler Console descubre los puntos finales de la API en función del tráfico de API recibido en las instancias y despliegues de API de NetScaler.

En NetScaler Console, la página Seguridad > Seguridad de API > Detección de API muestra los puntos finales de API descubiertos.

• Servidoresvirtuales : la pestaña vServer muestra los servidores virtuales de las instancias de NetScaler. Los servidores virtuales aparecen en esta ficha cuando reciben las solicitudes de API durante el período especificado.

• Implementacionesde API : en esta pestaña se muestran las implementaciones de API que se implementan desde NetScaler Console mediante una definición de API. Esta ficha descubre los extremos de la API cuando las implementaciones de API reciben las solicitudes de API durante el período especificado. Para agregar e implementar una definición de API, consulte Agregar una definición de API e Implementar definiciones de API.

Nota:

• Asegúrese de configurar el análisis y habilitar Web Insights en servidores virtuales. Consulte Habilitar Web Insight en las instancias de API.

• Solo puede agregar directivas a los extremos de API que se descubren en la ficha Implementaciones de API.

Ver puntos finales de API

En API Discovery , al seleccionar un servidor virtual o una implementación de API, la GUI de NetScaler Console muestra los puntos finales de la API y sus detalles, como:

• Método - Muestra el método utilizado en un extremo API. Por ejemplo, los métodos GET y POST.

• Total de solicitudes - Muestra el recuento de solicitudes API en el extremo de la API.

• Estados de respuesta: muestra el recuento de cada estado de respuesta. Por ejemplo, 2xx, 3xx, 4xx, y 5xx.

• Encontrado en la especificación: esta columna aparece solo para implementaciones de API. A veces, las API internas que no forman parte de la definición de la API pueden recibir tráfico del exterior. Esta columna le ayuda a identificar si el extremo de API y el método observado forman parte de la definición de API.

Los puntos finales de la API de un servidor virtual están disponibles de la siguiente manera:

Los puntos finales de API en las implementaciones de API están disponibles de la siguiente manera:

También puede seleccionar el punto final de API requerido para ver su informe de análisis detallado.

Para obtener más información sobre cada sección, consulte Ver análisis de la API.

Cree definiciones de API a partir de puntos de enlace de API descubiertos

Para crear definiciones de API a partir de puntos finales de API descubiertos (recursos y métodos de la API):

1. Vaya a Seguridad > API Security > Descubrimiento de API para ver la lista de servidores virtuales e implementaciones de API.

2. Haga clic en cualquier servidor virtual de la ficha vServers.

3. La página del servidor virtual muestra la lista de puntos finales detectados. Seleccione cualquier punto final y haga clic en Crear definición de API.

Nota:

Si no selecciona ningún punto final y hace clic en Crear definición de API, aparecerá una ventana emergente para confirmar si quiere crear una definición de API para todos los puntos de conexión. Haga clic en Sí para crear la definición de API con todos los puntos finales; de lo contrario, haga clic en No.

1. En Crear definición de API, especifique lo siguiente:

   • Nombre: Nombre para la definición de API.

   • Definición de API: Una definición debe incluir título, versión, ruta base y host. Puede especificar un nombre de dominio o una dirección IP en el campo Host.

   • Recursos de API: Agregue varios recursos API a su definición. Cada recurso tiene una ruta de acceso y un método soportado.

2. Haga clic en Crear definición para crear la definición de API.

Nota:

Si quieres modificar una ruta de recursos de API antes de agregarla a la definición de API, usa la función de clasificación o búsqueda de los recursos de API en la pantalla de definición de API.

Por ejemplo, considere un recurso de API denominado “/api/products/123-3243-2344334/reviews” donde el segmento de ruta “123-3243-2344334” es un identificador de producto variable. Ahora puede ordenar los recursos de la API, agregar la ruta del recurso como “/api/products/{id}/reviews” y eliminar todos los extremos de la API con identificadores como “/api/products/123-3243-2344334/reviews”.

Actualizar una definición de API existente con puntos finales de API descubiertos

Para actualizar una definición de API existente con puntos finales de API (recursos y métodos de API):

1. Vaya a Seguridad > API Security > Descubrimiento de API para ver la lista de servidores virtuales e implementaciones de API.

2. Haga clic en cualquier servidor virtual de la ficha vServers.

3. La página del servidor virtual muestra la lista de puntos finales detectados. Seleccione el punto final que quiere agregar a una definición de API existente. Haga clic en Actualizar la definición de API existente.

   

4. En la lista desplegable Seleccione una definición de API existente, seleccione la definición de API que quiere actualizar. Haga clic en Actualizar definición.

5. Aparece la página Actualizar la definición de la API existente. La sección Recursos de la API muestra las siguientes tablas:

   • Recursos adicionales: Los puntos finales de la API que seleccionó.

   • Recursos existentes: Los puntos finales de la API ya están disponibles en la definición de la API.

   Nota:

   Si el mismo punto final de la API está disponible en Recursos agregados y Recursos existentes, el punto final se agrega solo una vez a la definición de la API.

6. Haga clic en Actualizar definición.