Proxy's configureren voor de Azure SDK voor Python

U hebt vaak een proxy nodig als:

  • U bevindt zich achter een bedrijfsfirewall.
  • Uw netwerkverkeer moet via een beveiligingsapparaat gaan.
  • U wilt een aangepaste proxy gebruiken voor foutopsporing of routering.

Als uw organisatie een proxyserver nodig heeft voor toegang tot internetbronnen, stelt u een omgevingsvariabele in met de gegevens van de proxyserver voordat u de Azure SDK voor Python gebruikt. Wanneer u de omgevingsvariabelen HTTP_PROXY en HTTPS_PROXY instelt, gebruikt de Azure SDK voor Python de proxyserver tijdens runtime.

Een URL van een proxyserver heeft het formulier http[s]://[username:password@]<ip_address_or_domain>:<port>/, waarbij de combinatie van gebruikersnaam en wachtwoord optioneel is.

U kunt uw proxygegevens verkrijgen van uw IT- of netwerkteam, van uw browser of van netwerkhulpprogramma's.

U kunt een proxy globaal configureren met behulp van omgevingsvariabelen. U kunt ook een proxy configureren voor een afzonderlijke clientconstructor of -bewerkingsmethode door een argument met de naam proxiesdoor te geven.

Globale configuratie

Als u een proxy globaal wilt configureren voor uw script of app, definieert HTTP_PROXY of HTTPS_PROXY omgevingsvariabelen met de server-URL. Deze variabelen werken met elke versie van de Azure-bibliotheken. Houd er rekening mee dat HTTPS_PROXY dit geen HTTPS-proxy betekent. Hiermee geeft u de proxy op die moet worden gebruikt voor https:// aanvragen.

Als u de parameter use_env_settings=False doorgeeft aan een clientobjectconstructor of -bewerkingsmethode, negeert de SDK deze omgevingsvariabelen.

Instellen vanaf de opdrachtprompt

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

Instellen in Python-code

Proxy-instellingen instellen met behulp van omgevingsvariabelen. U hebt geen aangepaste configuratie nodig.

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"

Aangepaste configuratie

Een proxy instellen in Python code voor een client of methode

Geef voor aangepaste configuratie een proxy op voor een specifiek clientobject of een specifieke bewerkingsmethode. Gebruik een argument met de naam proxies.

Bijvoorbeeld, de volgende code uit het artikel Voorbeeld: Azure Storage gebruiken geeft een HTTPS-proxy met gebruikersgegevens op in de constructor BlobClient. In dit geval komt het object uit de azure.storage.blob bibliotheek, die is gebaseerd op 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