Como configurar proxies para o SDK do Azure para Python

Geralmente, você precisará de um proxy se:

  • Você está por trás de um firewall corporativo.
  • O tráfego de rede precisa passar por um dispositivo de segurança.
  • Você deseja usar um proxy personalizado para depuração ou roteamento.

Se sua organização exigir que um servidor proxy acesse recursos da Internet, defina uma variável de ambiente com as informações do servidor proxy antes de usar o SDK do Azure para Python. Quando você define as variáveis de ambiente HTTP_PROXY e HTTPS_PROXY, o SDK do Azure para Python usa o servidor proxy em tempo de execução.

Uma URL do servidor proxy tem o formulário http[s]://[username:password@]<ip_address_or_domain>:<port>/, em que o nome de usuário e a combinação de senha são opcionais.

Você pode obter suas informações de proxy de sua equipe de TI ou rede, do navegador ou de utilitários de rede.

Você pode configurar um proxy globalmente usando variáveis de ambiente. Você também pode configurar um proxy para um método de operação ou construtor de cliente individual passando um argumento chamado proxies.

Configuração global

Para configurar um proxy globalmente para seu script ou aplicativo, defina HTTP_PROXY ou HTTPS_PROXY variáveis de ambiente com a URL do servidor. Essas variáveis funcionam com qualquer versão das bibliotecas do Azure. Observe que HTTPS_PROXY isso não significa um proxy HTTPS. Especifica o proxy a ser usado para https:// solicitações.

Se você passar o parâmetro use_env_settings=False para um construtor de objeto cliente ou método de operação, o SDK ignorará essas variáveis de ambiente.

Definir a partir da linha de comando

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

Codificado em Python

Defina as configurações de proxy usando variáveis de ambiente. Você não precisa de nenhuma configuração 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"

Configuração personalizada

Configure um proxy no código Python para um cliente ou método

Para configuração personalizada, especifique um proxy para um objeto ou método de operação de cliente específico. Use um argumento chamado proxies.

Por exemplo, o código a seguir do artigo Exemplo: usar o Armazenamento do Azure especifica um proxy HTTPS com credenciais de usuário no construtor BlobClient. Nesse caso, o objeto vem da azure.storage.blob biblioteca, que se baseia em 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