Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
Configuración de proxies de HTTP
Puede configurar proxies de HTTP mediante código, definiendo propiedades del sistema Java o definiendo variables de entorno.
Configuración en código
Los proxies se configuran en código con un generador ProxyConfiguration específico del cliente al crear el cliente de servicio. El código siguiente muestra una configuración de proxy de ejemplo para un cliente HTTP basado en Apache que utiliza un cliente de servicio de Amazon S3.
SdkHttpClient httpClient1 = ApacheHttpClient.builder() .proxyConfiguration(ProxyConfiguration.builder() .endpoint(URI.create("http://proxy.example.com")) .username("username") .password("password") .addNonProxyHost("localhost") .build()) .build(); S3Client s3Client = S3Client.builder() .httpClient(httpClient) .build();
En la sección correspondiente a cada cliente HTTP de este tema se muestra un ejemplo de configuración de proxy.
Configuración de proxies de HTTP con ajustes externos
Aunque no utilice explícitamente un compilador de ProxyConfiguration en el código, el SDK busca ajustes externos para configurar una configuración de proxy predeterminada.
De forma predeterminada, el SDK busca primero las propiedades del sistema JVM. Si se encuentra una sola propiedad, el SDK usa el valor y cualquier otro valor de propiedad del sistema. Si no hay propiedades del sistema disponibles, el SDK busca variables de entorno del proxy.
El SDK puede usar las siguientes propiedades y variables de entorno del sistema Java.
| Propiedad del sistema | Descripción | Compatibilidad con clientes HTTP |
|---|---|---|
|
http.proxyHost |
Nombre de host del servidor proxy HTTP |
Todos |
|
http.proxyPort |
Número de puerto del servidor proxy HTTP |
Todos |
| http.proxyUser |
Nombre de usuario para la autenticación mediante proxy HTTP |
Todos |
|
http.proxyPassword |
Contraseña para la autenticación mediante proxy HTTP |
Todos |
| http.nonProxyHosts |
Lista de hosts a los que se debe acceder directamente, sin pasar por el proxy. Esta lista también es válida cuando se utiliza HTTPS |
Todos |
| https.proxyHost |
Nombre de host del servidor proxy HTTP |
Netty, CRT |
|
https.proxyPort |
Número de puerto del servidor proxy HTTP |
Netty, CRT |
| https.proxyUser |
Nombre de usuario para la autenticación mediante proxy HTTPS |
Netty, CRT |
| https.proxyPassword | Contraseña para la autenticación mediante proxy HTTPS | Netty, CRT |
| Variable de entorno | Descripción | Compatibilidad con clientes HTTP |
|---|---|---|
| HTTP_PROXY1 |
URL válida con un esquema de HTTP |
Todos |
|
HTTPS_PROXY1 |
URL válida con un esquema de HTTPS |
Netty, CRT |
| NO_PROXY2 |
Lista de hosts a los que se debe acceder directamente, sin pasar por el proxy. La lista es válida tanto para HTTP como para HTTPS. |
Todos |
Todos: todos los clientes HTTP que ofrece el SDK: UrlConnectionHttpClient, ApacheHttpClient, NettyNioAsyncHttpClient, AwsCrtAsyncHttpClient.
Netty: el cliente de HTTP basado en Netty (NettyNioAsyncHttpClient)
CRT: los clientes de HTTP basados en AWS CRT (AwsCrtHttpClient y AwsCrtAsyncHttpClient).
1La variable de entorno consultada, ya sea HTTP_PROXY o HTTPS_PROXY, depende de la configuración del esquema en la ProxyConfiguration del cliente. El esquema predeterminado es HTTP. El siguiente fragmento de código muestra cómo cambiar el esquema a HTTPS utilizado para la resolución de variables de entorno.
SdkHttpClient httpClient = ApacheHttpClient.builder() .proxyConfiguration(ProxyConfiguration.builder() .scheme("https") .build()) .build();
2La variable de entorno NO_PROXY admite una combinación de separadores “|” y “,” entre los nombres de host. Los nombres de host pueden incluir el comodín “*”.
Uso de una combinación de ajustes
Puede usar una combinación de ajustes de proxy de HTTP en el código, las propiedades del sistema y las variables de entorno.
ejemplo – configuración proporcionada por una propiedad del sistema y por código.
// Command line with the proxy password set as a system property. $ java -Dhttp.proxyPassword=SYS_PROP_password -cp ... App // Since the 'useSystemPropertyValues' setting is 'true' (the default), the SDK will supplement // the proxy configuration in code with the 'http.proxyPassword' value from the system property. SdkHttpClient apacheHttpClient = ApacheHttpClient.builder() .proxyConfiguration(ProxyConfiguration.builder() .endpoint(URI.create("http://localhost:1234")) .username("username") .build()) .build(); // Use the apache HTTP client with proxy configuration. DynamoDbClient dynamoDbClient = DynamoDbClient.builder() .httpClient(apacheHttpClient) .build();
El SDK resuelve la siguiente configuración del proxy.
Host = localhost Port = 1234 Password = SYS_PROP_password UserName = username Non ProxyHost = null
ejemplo – están disponibles tanto las propiedades del sistema como las variables de entorno
El compilador ProxyConfiguration del cliente de HTTP ofrece configuraciones denominadas useSystemPropertyValues y useEnvironmentVariablesValues. De forma predeterminada, ambas configuraciones son true. Cuando es true, el SDK utiliza automáticamente valores de propiedades del sistema o variables de entorno para las opciones que no proporciona el compilador ProxyConfiguration.
importante
Las propiedades del sistema tienen prioridad sobre las variables de entorno. Si se encuentra una propiedad del sistema proxy de HTTP, el SDK recupera todos los valores de las propiedades del sistema y ninguno de las variables de entorno. Si desea priorizar las variables de entorno sobre las propiedades del sistema, establezca useSystemPropertyValues en false.
En este ejemplo, los siguientes ajustes están disponibles en tiempo de ejecución:
// System properties http.proxyHost=SYS_PROP_HOST.com http.proxyPort=2222 http.password=SYS_PROP_PASSWORD http.user=SYS_PROP_USER // Environment variables HTTP_PROXY="http://EnvironmentUser:EnvironmentPassword@ENV_VAR_HOST:3333" NO_PROXY="environmentnonproxy.host,environmentnonproxy2.host:1234"
El cliente de servicio se crea con una de las instrucciones siguientes. Ninguna de las instrucciones establece explícitamente una configuración de proxy.
DynamoDbClient client = DynamoDbClient.create(); DynamoDbClient client = DynamoDbClient.builder().build(); DynamoDbClient client = DynamoDbClient.builder() .httpClient(ApacheHttpClient.builder() .proxyConfiguration(ProxyConfiguration.builder() .build()) .build()) .build();
El SDK resuelve la siguiente configuración del proxy.
Host = SYS_PROP_HOST.com Port = 2222 Password = SYS_PROP_PASSWORD UserName = SYS_PROP_USER Non ProxyHost = null
Dado que el cliente de servicio tiene la configuración de proxy predeterminada, el SDK busca las propiedades del sistema y, a continuación, las variables de entorno. Puesto que la configuración de las propiedades del sistema tiene prioridad sobre las variables de entorno, el SDK utiliza únicamente las propiedades del sistema.
Si el uso de las propiedades del sistema se cambia a false, como se muestra en el código siguiente, el SDK resuelve solo las variables de entorno.
DynamoDbClient client = DynamoDbClient.builder() .httpClient(ApacheHttpClient.builder() .proxyConfiguration(ProxyConfiguration.builder() .useSystemPropertyValues(Boolean.FALSE) .build()) .build()) .build();
La configuración de proxy resuelta mediante HTTP es:
Host = ENV_VAR_HOST Port = 3333 Password = EnvironmentPassword UserName = EnvironmentUser Non ProxyHost = environmentnonproxy.host, environmentnonproxy2.host:1234
