Establecer proxy HTTP
SE APLICA A: todos los niveles de API Management
La directiva proxy le permite enrutar las solicitudes reenviadas a los back-ends a través de un proxy HTTP. Solo se admite HTTP (no HTTPS) entre la puerta de enlace y el proxy. Solo autenticación básica y NTLM.
Precaución
Minimice los riesgos de exposición de credenciales al configurar esta directiva. Microsoft recomienda usar métodos de autenticación más seguros si son compatibles con el back-end, como la autenticación de identidad administrada o el administrador de credenciales. Si configura información confidencial en las definiciones de directiva, se recomienda usar valores con nombre y almacenar secretos en Azure Key Vault.
Nota:
Establezca los elementos de la directiva y los elementos secundarios en el orden proporcionado en la instrucción de directiva. Obtenga más información sobre el establecimiento o modificación de directivas de API Management.
Instrucción de la directiva
<proxy url="http://hostname-or-ip:port" username="username" password="password" />
Atributos
| Atributo | Descripción | Necesario | Valor predeterminado |
|---|---|---|---|
| url | Dirección URL del proxy en forma de http://host:port. Se permiten expresiones de directiva. |
Sí | N/D |
| username | Nombre de usuario que se usará para la autenticación con el servidor proxy. Se permiten expresiones de directiva. | No | N/D |
| password | Contraseña que se usará para la autenticación con el servidor proxy. Se permiten expresiones de directiva. | No | N/D |
Uso
- Secciones de la directiva: inbound (entrada)
- Ámbitos de la directiva: global, área de trabajo, producto, API, operación
- Puertas de enlace: clásica, v2, consumo, autohospedada y área de trabajo
Notas de uso
- Se recomienda usar valores con nombre para proporcionar credenciales, con secretos protegidos en un almacén de claves.
Ejemplo
En este ejemplo, se usan valores con nombre para el nombre de usuario y la contraseña para evitar almacenar información confidencial en el documento de directiva.
<proxy url="http://192.168.1.1:8080" username={{username}} password={{password}} />
Directivas relacionadas
Contenido relacionado
Para más información sobre el trabajo con directivas, vea:
- Tutorial: Transformación y protección de una API
- Referencia de directivas para una lista completa de instrucciones de directivas y su configuración
- Expresiones de directiva
- Establecimiento o edición de directivas
- Reutilización de configuraciones de directivas
- Repositorio de fragmentos de código de directiva
- Kit de herramientas de directivas de API Management de Azure
- Creación de directivas mediante Microsoft Copilot en Azure