Konfigurieren von Proxys für das Azure SDK für Python

Sie benötigen häufig einen Proxy, wenn:

  • Sie befinden sich hinter einer Unternehmensfirewall.
  • Ihr Netzwerkdatenverkehr muss eine Sicherheitsanwendung durchlaufen.
  • Sie möchten einen benutzerdefinierten Proxy zum Debuggen oder Routing verwenden.

Wenn Ihre Organisation einen Proxyserver für den Zugriff auf Internetressourcen benötigt, legen Sie eine Umgebungsvariable mit den Proxyserverinformationen fest, bevor Sie die Azure SDK für Python verwenden. Wenn Sie die Variablen HTTP_PROXY und HTTPS_PROXY Umgebung festlegen, verwendet die Azure SDK für Python den Proxyserver zur Laufzeit.

Eine Proxyserver-URL weist das Formular http[s]://[username:password@]<ip_address_or_domain>:<port>/auf, in dem die Kombination aus Benutzername und Kennwort optional ist.

Sie können Ihre Proxyinformationen von Ihrem IT- oder Netzwerkteam, aus Ihrem Browser oder von Netzwerkdienstprogrammen abrufen.

Sie können einen Proxy global konfigurieren, indem Sie Umgebungsvariablen verwenden. Sie können auch einen Proxy für einen einzelnen Clientkonstruktor oder eine Operationsmethode konfigurieren, indem Sie ein Argument namens proxiesübergeben.

Globale Konfiguration

Um einen Proxy global für Ihr Skript oder Ihre App zu konfigurieren, definieren HTTP_PROXY oder HTTPS_PROXY Umgebungsvariablen mit der Server-URL. Diese Variablen funktionieren mit einer beliebigen Version der Azure-Bibliotheken. Beachten Sie, dass HTTPS_PROXY kein HTTPS-Proxy gemeint ist. Er gibt den Proxy an, der für https:// Anforderungen verwendet werden soll.

Wenn Sie den Parameter use_env_settings=False an einen Clientobjektkonstruktor oder eine Operationsmethode übergeben, ignoriert das SDK diese Umgebungsvariablen.

Festlegen über die Befehlszeile

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

Festlegen im Python-Code

Legen Sie Proxyeinstellungen mithilfe von Umgebungsvariablen fest. Sie benötigen keine benutzerdefinierte Konfiguration.

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"

Benutzerdefinierte Konfiguration

Festlegen eines Proxys in Python Code für einen Client oder eine Methode

Geben Sie für die benutzerdefinierte Konfiguration einen Proxy für ein bestimmtes Clientobjekt oder eine bestimmte Vorgangsmethode an. Verwenden Sie ein Argument mit dem Namen proxies.

Der folgende Code aus dem Artikel Example: Verwenden Sie Azure Speicher gibt einen HTTPS-Proxy mit Benutzeranmeldeinformationen im Konstruktor BlobClient an. In diesem Fall stammt das Objekt aus der azure.storage.blob Bibliothek, die auf azure.core basiert.

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