AzureDeveloperCliCredential Klasse

Authentifiziert sich, indem ein Token vom Azure Developer CLI angefordert wird.

Azure Developer CLI ist ein Befehlszeilenschnittstellentool, mit dem Entwickler Ressourcen in Azure erstellen, verwalten und bereitstellen können. Es basiert auf der Azure CLI und bietet zusätzliche Funktionen, die für Azure-Entwickler spezifisch sind. Es ermöglicht Benutzern, sich als Benutzer und/oder dienstprinzipal bei Azure Active Directory (Azure AD) zu authentifizieren. AzureDeveloperCliCredential authentifiziert sich in einer Entwicklungsumgebung und ruft ein Token im Namen des angemeldeten Benutzers oder Dienstprinzipals in Azure Developer CLI ab. Er fungiert als Azure Developer CLI angemeldeten Benutzer oder Dienstprinzipals und führt einen Azure CLI-Befehl darunter aus, um die Anwendung bei Azure Active Directory zu authentifizieren.

Um diese Anmeldeinformationen verwenden zu können, muss sich der Entwickler lokal in Azure Developer CLI mit einem der folgenden Befehle authentifizieren:

• Führen Sie "azd auth login" in Azure Developer CLI aus, um sich interaktiv als Benutzer zu authentifizieren.

• Führen Sie "azd auth login –client-id 'client_id' –client-secret 'client_secret' –tenant-id 'tenant_id'" aus, um sich als Dienstprinzipal zu authentifizieren.

Abhängig von der Gültigkeit des Aktualisierungstokens in Ihrer Organisation müssen Sie diesen Vorgang möglicherweise nach einem bestimmten Zeitraum wiederholen. Im Allgemeinen beträgt die Gültigkeitsdauer des Aktualisierungstokens einige Wochen bis hin zu einigen Monaten. AzureDeveloperCliCredential fordert Sie auf, sich erneut anzumelden.

Vererbung

builtins.object

AzureDeveloperCliCredential

Konstruktor

AzureDeveloperCliCredential(*, tenant_id: str = '', additionally_allowed_tenants: List[str] | None = None, process_timeout: int = 10)

Parameter

tenant_id

str

Optionaler Mandant, der in die Tokenanforderung aufgenommen werden soll.

additionally_allowed_tenants

List[str]

Gibt Mandanten zusätzlich zum angegebenen "tenant_id" an, für den die Anmeldeinformationen Token abrufen können. Fügen Sie den Platzhalterwert "*" hinzu, damit die Anmeldeinformationen Token für jeden Mandanten abrufen können, auf den die Anwendung zugreifen kann.

process_timeout

int

Warten sie in Sekunden, bis der Azure Developer CLI-Prozess reagiert. Der Standardwert ist 10 Sekunden.

Beispiele

Erstellen Sie eine AzureDeveloperCliCredential.Create an AzureDeveloperCliCredential.

   from azure.identity import AzureDeveloperCliCredential

   credential = AzureDeveloperCliCredential()

Methoden

close	Das Aufrufen dieser Methode ist nicht erforderlich.
get_token	Fordern Sie ein Zugriffstoken für Bereiche an. Diese Methode wird von Azure SDK-Clients automatisch aufgerufen. Anwendungen, die diese Methode direkt aufrufen, müssen auch die Tokenzwischenspeicherung verarbeiten, da diese Anmeldeinformationen die abgerufenen Token nicht zwischenspeichern.

close

Das Aufrufen dieser Methode ist nicht erforderlich.

close() -> None

get_token

Fordern Sie ein Zugriffstoken für Bereiche an.

Diese Methode wird von Azure SDK-Clients automatisch aufgerufen. Anwendungen, die diese Methode direkt aufrufen, müssen auch die Tokenzwischenspeicherung verarbeiten, da diese Anmeldeinformationen die abgerufenen Token nicht zwischenspeichern.

get_token(*scopes: str, claims: str | None = None, tenant_id: str | None = None, **kwargs: Any) -> AccessToken

Parameter

scopes

str

Erforderlich

Gewünschter Bereich für das Zugriffstoken. Diese Anmeldeinformationen lassen nur einen Bereich pro Anforderung zu. Weitere Informationen zu Bereichen finden Sie unter https://learn.microsoft.com/azure/active-directory/develop/scopes-oidc.

claims

str

von diesen Anmeldeinformationen nicht verwendet; alle angegebenen Werte werden ignoriert.

tenant_id

str

optionaler Mandant, der in die Tokenanforderung aufgenommen werden soll.

Gibt zurück

Ein Zugriffstoken mit den gewünschten Bereichen.

Rückgabetyp

AccessToken

Ausnahmen

CredentialUnavailableError

die Anmeldeinformationen konnten die Azure Developer CLI nicht aufrufen.

ClientAuthenticationError

Die Anmeldeinformationen haben die Azure Developer CLI aufgerufen, aber kein Zugriffstoken empfangen.