Configuración de servidores proxy para El SDK de Azure para Python

A menudo necesita un proxy si:

  • Está detrás de un firewall corporativo.
  • El tráfico de red debe pasar por un dispositivo de seguridad.
  • Quieres usar un proxy personalizado para depurar o redirigir el tráfico.

Si su organización requiere un servidor proxy para acceder a los recursos de Internet, establezca una variable de entorno con la información del servidor proxy antes de usar el SDK de Azure para Python. Cuando se establecen las variables de entorno HTTP_PROXY y HTTPS_PROXY, SDK de Azure para Python usa el servidor proxy en tiempo de ejecución.

Una dirección URL del servidor proxy tiene el formato http[s]://[username:password@]<ip_address_or_domain>:<port>/, donde la combinación de nombre de usuario y contraseña es opcional.

Puede obtener la información de proxy del equipo de TI o de red, del explorador o de las utilidades de red.

Puede configurar un proxy globalmente mediante variables de entorno. También puede configurar un proxy para un método de operación o constructor de cliente individual pasando un argumento denominado proxies.

Configuración global

Para configurar un proxy globalmente para su script o aplicación, defina las variables de entorno HTTP_PROXY o HTTPS_PROXY con la dirección URL del servidor. Estas variables funcionan con cualquier versión de las bibliotecas de Azure. Tenga en cuenta que HTTPS_PROXY no significa un proxy HTTPS. Especifica el proxy que se utilizará para las solicitudes https://.

Si pasa el parámetro use_env_settings=False a un constructor de objetos de cliente o método de operación, el SDK omite estas variables de entorno.

Establecer desde la línea de comandos

rem Non-authenticated HTTP server:
set HTTP_PROXY=http://10.10.1.10:1180

rem Authenticated HTTP server:
set HTTP_PROXY=http://username:password@10.10.1.10:1180

rem Non-authenticated HTTPS server:
set HTTPS_PROXY=http://10.10.1.10:1180

rem Authenticated HTTPS server:
set HTTPS_PROXY=http://username:password@10.10.1.10:1180

Configurado en código de Python

Establezca la configuración de proxy mediante variables de entorno. No necesita ninguna configuración personalizada.

import os
os.environ["HTTP_PROXY"] = "http://10.10.1.10:1180"

# Alternate URL and variable forms:
# os.environ["HTTP_PROXY"] = "http://username:password@10.10.1.10:1180"
# os.environ["HTTPS_PROXY"] = "http://10.10.1.10:1180"
# os.environ["HTTPS_PROXY"] = "http://username:password@10.10.1.10:1180"

Configuración personalizada

Configurar un proxy en código Python para un cliente o método

Para la configuración personalizada, especifique un proxy para un método de operación o objeto de cliente específico. Use un argumento denominado proxies.

Por ejemplo, el código siguiente del artículo Example: use Azure storage especifica un proxy HTTPS con credenciales de usuario en el constructor BlobClient. En este caso, el objeto procede de la azure.storage.blob biblioteca, que se basa en azure.core.

from azure.identity import DefaultAzureCredential

# Import the client object from the SDK library
from azure.storage.blob import BlobClient

credential = DefaultAzureCredential()

storage_url = "https://<storageaccountname>.blob.core.windows.net"

blob_client = BlobClient(storage_url, container_name="blob-container-01",
    blob_name="sample-blob.txt", credential=credential,
    proxies={ "https": "https://username:password@10.10.1.10:1180" }
)

# Other forms that the proxy URL might take:
# proxies={ "http": "http://10.10.1.10:1180" }
# proxies={ "http": "http://username:password@10.10.1.10:1180" }
# proxies={ "https": "https://10.10.1.10:1180" }
  • Last updated on