Uso de interceptores con Gateway

La configuración de los interceptores en su puerta de enlace le permite ejecutar un código personalizado durante cada invocación de su puerta de enlace. Esta sección proporciona orientación sobre la implementación y la configuración de los interceptores para su puerta de enlace.

Temas

• Descripción general de

• Prácticas recomendadas de seguridad

• Permisos para interceptores

• Tipos de interceptores

• Configuración

• Ejemplos

Descripción general de

La configuración de los interceptores en su puerta de enlace le permite ejecutar un código personalizado durante cada invocación de su puerta de enlace. Esto es útil para los siguientes casos de uso:

• Implementar un control de acceso detallado sobre las herramientas o las operaciones de MCP

• Transformar la solicitud objetivo y la respuesta de la puerta de enlace

• Implementación de una lógica de autorización personalizada

Hay dos tipos de interceptores que se pueden configurar en su puerta de enlace:

• SOLICITE interceptores: se ejecutan antes de que la puerta de enlace llame al objetivo. Son útiles para solicitar la validación, la transformación o la autorización personalizada.

• Interceptores de respuesta: se ejecutan después de que el objetivo responda, pero antes de que la puerta de enlace devuelva la respuesta a la persona que llama. Son útiles para la transformación de respuestas, el filtrado o la adición de encabezados personalizados.

Una puerta de enlace puede tener configurados como máximo un interceptor REQUEST y un interceptor RESPONSE como máximo. Puede configurar ambos tipos en la misma puerta de enlace, pero no puede tener varios interceptores del mismo tipo.

Actualmente, los interceptores solo se pueden configurar con funciones de Lambda.

Prácticas recomendadas de seguridad

Al implementar los interceptores, es importante seguir las mejores prácticas de seguridad para proteger la información confidencial y mantener un control de acceso adecuado.

1. De forma predeterminada, los encabezados de las solicitudes no se pasarán a un interceptor a menos que el passRequestHeaders campo esté establecido en verdadero. Tenga cuidado al usar este campo, ya que los encabezados de las solicitudes pueden contener información confidencial, como credenciales y credenciales de autenticación. Asegúrese de verificar que su interceptor no esté registrando esta información confidencial.

2. Asegúrese de restringir su función de ejecución en la puerta de enlace para que solo tenga permisos para invocar las funciones lambda específicas que esté utilizando como interceptores y no para conceder permisos lambda comodín a su función de ejecución.

3. Implemente funciones Lambda idempotentes para sus interceptores. La puerta de enlace puede volver a intentar enviar solicitudes a las funciones de Interceptor Lambda en caso de que se produzcan errores o se agoten los tiempos de espera. Asegúrese de que su lógica de interceptor pueda gestionar las invocaciones duplicadas de forma segura mediante la implementación de claves de idempotencia, el seguimiento de las solicitudes procesadas o el diseño de operaciones sin estado que produzcan resultados coherentes cuando se ejecuten varias veces con la misma entrada.