Puede implementar el Agente proxy de peticiones de Apidog en una máquina con el entorno de red adecuado. Esto permite que las peticiones a endpoints desde el cliente de Apidog, la web o la documentación compartida se enruten a través de este agente hacia el endpoint de destino.Esta función es especialmente útil para depurar endpoints en documentaciones compartidas, ya que ayuda a resolver problemas de intercambio de recursos de origen cruzado (CORS). Es ideal para escenarios en los que diferentes entornos tienen requisitos de red específicos, lo que hace imposible la depuración directa desde un entorno local.Requisitos previos#
Un servidor, preferiblemente con Linux.
Docker instalado en el servidor (versión mínima requerida: 20.10.0. Versión recomendada: 20.10.13). Implementar el Agente proxy de peticiones#
El agente proxy de peticiones es un recurso a nivel de equipo/organización. Una vez implementado, puede utilizarse en todos los proyectos dentro de su equipo u organización. Para implementar el agente en un servidor con Docker habilitado, ejecute el siguiente comando:Puede configurar ajustes básicos mediante variables de entorno durante la implementación. Use las siguientes opciones según sea necesario:| Variable de entorno | Descripción | Ejemplo |
|---|
| SOURCE_IP_WHITELIST | Lista de IP de origen permitidas, separadas por comas (debido a restricciones del sistema operativo, esta variable solo se puede usar en Linux y debe usarse con --network=host.) | --network=host
-e SOURCE_IP_WHITELIST=134.34.4.3,123.333.33.0/24 |
| SOURCE_IP_BLACKLIST | Lista de IP de origen bloqueadas, separadas por comas (debido a restricciones del sistema operativo, esta variable solo se puede usar en Linux y debe usarse con --network=host.) | --network=host
-e SOURCE_IP_BLACKLIST=134.34.4.3,123.333.33.0/24 |
| DESTINATION_DOMAIN_WHITELIST | Lista de nombres de dominio de destino permitidos, separados por comas | -e DESTINATION_DOMAIN_WHITELIST=xxx.yyy.com,*.yyy.com |
| DESTINATION_DOMAIN_BLACKLIST | Lista de nombres de dominio de destino bloqueados, separados por comas | -e DESTINATION_DOMAIN_BLACKLIST=xxx.yyy.com,*.yyy.com |
| DESTINATION_IP_WHITELIST | Lista de IP de destino permitidas, separadas por comas | -e DESTINATION_IP_WHITELIST=134.34.4.3,123.333.33.0/24 |
| DESTINATION_IP_BLACKLIST | Lista de IP de destino bloqueadas, separadas por comas | -e DESTINATION_IP_BLACKLIST=134.34.4.3,123.333.33.0/24 |
| ALLOW_PRIVATE_IP | Permitir peticiones a IP internas (booleano, el valor predeterminado es false) | -e ALLOW_PRIVATE_IP=false |
El Agente proxy de peticiones de Apidog es de código abierto, lo que le permite personalizarlo aún más para satisfacer sus necesidades (por ejemplo, agregar parámetros de encabezado personalizados). Acceda al código fuente aquí.
Agregar el Agente proxy de peticiones en Apidog#
Una vez que el agente proxy de peticiones de Apidog se esté ejecutando en Docker, puede agregarlo a los recursos del equipo en Apidog. Introduzca la información del host del servidor (el puerto predeterminado es 9159) en la ventana emergente y haga clic en guardar. A continuación, Apidog intentará conectarse.Si la conexión falla, verá una notificación y no se permitirá la creación.
Si la conexión se realiza correctamente, el agente proxy de peticiones se creará correctamente dentro de su equipo.
