Konfigurace proxy serverů pro Sadu Azure SDK pro Python

Proxy server často potřebujete v následujících případech:

  • Nacházíte se za podnikovým firewallem.
  • Síťový provoz musí projít zařízením zabezpečení.
  • Chcete použít vlastní proxy server pro ladění nebo směrování.

Pokud vaše organizace vyžaduje proxy server pro přístup k internetovým prostředkům, nastavte proměnnou prostředí s informacemi o proxy serveru před použitím Azure SDK pro Python. Když nastavíte proměnné prostředí HTTP_PROXY a HTTPS_PROXY, Azure SDK pro Python používá proxy server za běhu.

Adresa URL proxy serveru má formulář http[s]://[username:password@]<ip_address_or_domain>:<port>/, kde kombinace uživatelského jména a hesla je volitelná.

Informace o proxy serveru můžete získat od IT nebo síťového týmu, z prohlížeče nebo ze síťových nástrojů.

Proxy server můžete nakonfigurovat globálně pomocí proměnných prostředí. Proxy server můžete také nakonfigurovat pro jednotlivé konstruktor klienta nebo metodu operace předáním argumentu s názvem proxies.

Globální konfigurace

Pokud chcete pro svůj skript nebo aplikaci nakonfigurovat proxy server globálně, definujte proměnné prostředí HTTP_PROXY nebo HTTPS_PROXY pomocí URL serveru. Tyto proměnné fungují s libovolnou verzí knihoven Azure. Všimněte si, že HTTPS_PROXY to neznamená proxy https. Určuje proxy server, který se má použít pro https:// požadavky.

Pokud předáte parametr use_env_settings=False konstruktoru objektu klienta nebo metodě operace, sada SDK tyto proměnné prostředí ignoruje.

Nastavení z příkazového řádku

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

Nastavení v kódu Pythonu

Nastavení proxy serveru nastavte pomocí proměnných prostředí. Nepotřebujete žádnou vlastní konfiguraci.

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"

Vlastní konfigurace

Nastavení proxy serveru v Python kódu pro klienta nebo metodu

Pro vlastní konfiguraci zadejte proxy server pro konkrétní objekt klienta nebo metodu operace. Použijte argument s názvem proxies.

Například následující kód z článku Example: použijte Azure storage určuje proxy https s přihlašovacími údaji uživatele v konstruktoru BlobClient. V tomto případě objekt pochází z azure.storage.blob knihovny, která je založena na 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" }