AuthorizationCodeCredential class

Ermöglicht die Authentifizierung der Microsoft Entra ID mithilfe eines Autorisierungscodes, der über den Autorisierungscodefluss erhalten wurde, der ausführlicher in der Microsoft Entra ID-Dokumentation beschrieben wird:

https://learn.microsoft.com/entra/identity-platform/v2-oauth2-auth-code-flow

Konstruktoren

AuthorizationCodeCredential(string, string, string, string, AuthorizationCodeCredentialOptions)

Erstellt eine Instanz von AuthorizationCodeCredential mit den Details, die benötigt werden, um ein Zugriffstoken mit einer Authentifizierung anzufordern, die von Microsoft Entra ID erhalten wurde.

Es ist derzeit erforderlich, dass der Benutzer dieser Anmeldeinformationen den Autorisierungscodefluss initiiert, um einen Autorisierungscode abzurufen, der mit diesen Anmeldeinformationen verwendet werden soll. Ein vollständiges Beispiel für diesen Fluss finden Sie hier:

https://github.com/Azure/azure-sdk-for-js/blob/main/sdk/identity/identity/samples/v2/manual/authorizationCodeSample.ts

AuthorizationCodeCredential(string, string, string, string, string, AuthorizationCodeCredentialOptions)

Erstellt eine Instanz von AuthorizationCodeCredential mit den Details, die benötigt werden, um ein Zugriffstoken mit einer Authentifizierung anzufordern, die von Microsoft Entra ID erhalten wurde.

Es ist derzeit erforderlich, dass der Benutzer dieser Anmeldeinformationen den Autorisierungscodefluss initiiert, um einen Autorisierungscode abzurufen, der mit diesen Anmeldeinformationen verwendet werden soll. Ein vollständiges Beispiel für diesen Fluss finden Sie hier:

https://github.com/Azure/azure-sdk-for-js/blob/main/sdk/identity/identity/samples/v2/manual/authorizationCodeSample.ts

Methoden

getToken(string | string[], GetTokenOptions)

Authentifiziert sich mit der Microsoft Entra ID und gibt bei Erfolg ein Zugriffstoken zurück. Wenn die Authentifizierung fehlschlägt, wird ein CredentialUnavailableError- mit den Details des Fehlers ausgelöst.

Details zum Konstruktor

AuthorizationCodeCredential(string, string, string, string, AuthorizationCodeCredentialOptions)

Erstellt eine Instanz von AuthorizationCodeCredential mit den Details, die benötigt werden, um ein Zugriffstoken mit einer Authentifizierung anzufordern, die von Microsoft Entra ID erhalten wurde.

Es ist derzeit erforderlich, dass der Benutzer dieser Anmeldeinformationen den Autorisierungscodefluss initiiert, um einen Autorisierungscode abzurufen, der mit diesen Anmeldeinformationen verwendet werden soll. Ein vollständiges Beispiel für diesen Fluss finden Sie hier:

https://github.com/Azure/azure-sdk-for-js/blob/main/sdk/identity/identity/samples/v2/manual/authorizationCodeSample.ts

new AuthorizationCodeCredential(tenantId: string, clientId: string, authorizationCode: string, redirectUri: string, options?: AuthorizationCodeCredentialOptions)

Parameter

tenantId

string

Die Microsoft Entra-Tenant-ID (Verzeichnis-)ID oder Name. "common" kann beim Umgang mit Szenarien mit mehreren Mandanten verwendet werden.

clientId

string

Die Client-ID (Anwendungs-ID) einer App-Registrierung im Mandanten.

authorizationCode

string

Ein Autorisierungscode, der nach dem Autorisierungscodefluss empfangen wurde. Dieser Autorisierungscode darf noch nicht zum Abrufen eines Zugriffstokens verwendet worden sein.

redirectUri

string

Der Umleitungs-URI, der zum Anfordern des Autorisierungscodes verwendet wurde. Muss derselbe URI sein, der für die App-Registrierung konfiguriert ist.

options
AuthorizationCodeCredentialOptions

Optionen zum Konfigurieren des Clients, der die Zugriffstokenanforderung vorgibt.

AuthorizationCodeCredential(string, string, string, string, string, AuthorizationCodeCredentialOptions)

Erstellt eine Instanz von AuthorizationCodeCredential mit den Details, die benötigt werden, um ein Zugriffstoken mit einer Authentifizierung anzufordern, die von Microsoft Entra ID erhalten wurde.

Es ist derzeit erforderlich, dass der Benutzer dieser Anmeldeinformationen den Autorisierungscodefluss initiiert, um einen Autorisierungscode abzurufen, der mit diesen Anmeldeinformationen verwendet werden soll. Ein vollständiges Beispiel für diesen Fluss finden Sie hier:

https://github.com/Azure/azure-sdk-for-js/blob/main/sdk/identity/identity/samples/v2/manual/authorizationCodeSample.ts

new AuthorizationCodeCredential(tenantId: string, clientId: string, clientSecret: string, authorizationCode: string, redirectUri: string, options?: AuthorizationCodeCredentialOptions)

Parameter

tenantId

string

Die Microsoft Entra-Tenant-ID (Verzeichnis-)ID oder Name. "common" kann beim Umgang mit Szenarien mit mehreren Mandanten verwendet werden.

clientId

string

Die Client-ID (Anwendungs-ID) einer App-Registrierung im Mandanten.

clientSecret

string

Ein geheimer Clientschlüssel, der für die App-Registrierung generiert wurde

authorizationCode

string

Ein Autorisierungscode, der nach dem Autorisierungscodefluss empfangen wurde. Dieser Autorisierungscode darf noch nicht zum Abrufen eines Zugriffstokens verwendet worden sein.

redirectUri

string

Der Umleitungs-URI, der zum Anfordern des Autorisierungscodes verwendet wurde. Muss derselbe URI sein, der für die App-Registrierung konfiguriert ist.

options
AuthorizationCodeCredentialOptions

Optionen zum Konfigurieren des Clients, der die Zugriffstokenanforderung vorgibt.

Details zur Methode

getToken(string | string[], GetTokenOptions)

Authentifiziert sich mit der Microsoft Entra ID und gibt bei Erfolg ein Zugriffstoken zurück. Wenn die Authentifizierung fehlschlägt, wird ein CredentialUnavailableError- mit den Details des Fehlers ausgelöst.

function getToken(scopes: string | string[], options?: GetTokenOptions): Promise<AccessToken>

Parameter

scopes

string | string[]

Die Liste der Bereiche, für die das Token Zugriff hat.

options
GetTokenOptions

Die Optionen zum Konfigurieren von Anforderungen, die diese TokenCredential-Implementierung möglicherweise vorgibt.

Gibt zurück

Promise<AccessToken>