TokenAcquisitionOptions Klasse

Übergebene Optionen zum Erstellen des Tokenakquisitionsobjekts, das msAL .NET aufruft.

Ruft den Namen der Optionen ab, die die vertrauliche Clientanwendung beschreiben (ClientID, Region, Autorität, Clientanmeldeinformationen). In ASP.NET Core entspricht der Name der Authentifizierungsoptionen dem Authentifizierungsschema.

Abbruchtoken, das beim Aufrufen der Tokenakquisitionsmethoden verwendet werden soll.

Eine Zeichenfolge mit einem oder mehreren Ansprüchen, die angefordert werden sollen. Es ist ein JSON-Blob (codiert oder nicht) Normalerweise mit bedingtem Zugriff verwendet. Es empfängt das Claims-Mitglied der UiRequiredException. Sie kann auch verwendet werden, um bestimmte optionale Ansprüche anzufordern, und für Ca Auth-Kontext

Legt die Korrelations-ID fest, die in der Anforderung an den STS-Endpunkt "/token" verwendet werden soll.

Übergebene Optionen zum Erstellen des Tokenakquisitionsobjekts, das msAL .NET aufruft.

Ein Eigenschaftenbehälter, der für die Erweiterbarkeit verwendet wird.

Legt Abfrageparameter für die Abfragezeichenfolge in der HTTP-Anforderung auf den Endpunkt "/token" fest.

FMI-Unterpfad (Federated Managed Identity).

Gibt an, ob die Tokenanforderung das Zugriffstoken im Tokencache ignoriert und versucht, ein neues Zugriffstoken abzurufen. Wenn true, ignoriert die Anforderung den Tokencache. Der Standardwert lautet false. Verwenden Sie diese Option mit Bedacht und nur bei Bedarf, wenn Sie beispielsweise wissen, dass sich Richtlinien für bedingten Zugriff geändert haben, damit die Leistung beeinträchtigt wird, da der Tokencache nicht verwendet wird und der STS die App möglicherweise drosselt.

Schlüssel, der für lange ausgeführte Web-APIs verwendet wird, die nachgeschaltete Web-APIs im Namen des Benutzers aufrufen müssen. Kann null sein, wenn Sie keine lange ausgeführte Web-API entwickeln, LongRunningWebApiSessionKeyAuto wenn der Token-Acquirer einen Sitzungsschlüssel für Sie zuweisen soll, oder ihre eigene Zeichenfolge, wenn Sie die Sitzung externen Informationen zuordnen möchten (z. B. eine Microsoft Graph Hook-ID).

Wenn ManagedIdentity diese Einstellung festgelegt ist, verwendet die Anwendung eine verwaltete Identität anstelle von Clientanmeldeinformationen, um ein App-Token abzurufen. Wenn Sie eine vom System zugewiesene Identität verwenden möchten, lassen Sie einfach NULL.UserAssignedClientId Um eine vom Benutzer zugewiesene Identität zu verwenden, legen Sie diese auf die Client-ID der vom Benutzer zugewiesenen Identität fest UserAssignedClientId , die Sie verwenden möchten. Die Verwendung einer der formenverwalteten Identität erfordert, dass die Anwendung auf Azure bereitgestellt wird und die verwaltete Identität konfiguriert wird. Weitere Informationen finden Sie in den verwalteten Identitäten für Azure Dokumentation.

Geben Sie zusätzlich zum PopPublicKeyPopClaim bei Bedarf in bestimmten POP-Protokollen den PopClaim an.

Ändert die Tokenakquisitionsanforderung so, dass das erworbene Token ein Proof of Possession-Token (PoP) anstelle eines Bearertokens ist. PoP-Token ähneln Bearer-Token, sind aber an die HTTP-Anforderung und an einen kryptografischen Schlüssel gebunden, den MSAL verwalten kann. Siehe https://aka.ms/msal-net-pop.

Ändert die Tokenakquisitionsanforderung so, dass das erworbene Token ein Proof of Possession-Token (PoP) anstelle eines Bearertokens ist. PoP-Token ähneln Bearer-Token, sind aber an die HTTP-Anforderung und an einen kryptografischen Schlüssel gebunden, den MSAL verwalten kann. Siehe https://aka.ms/msal-net-pop.

(Microsoft Identitätsspezifisch) Ermöglicht das Überschreiben des Mandanten/Kontos, für das ein Token abgerufen werden soll. Dies ist bei Mehrinstanzen-Apps in den Fällen nützlich, in denen ein bestimmtes Benutzerkonto ein Gast in anderen Mandanten ist und Sie Token für einen bestimmten Mandanten erwerben möchten.

(Microsoft Identitätsspezifisch) Bei AzureAD B2C wird ein bestimmter Benutzerfluss verwendet.

Klonen Sie die Optionen (um sie außer Kraft zu setzen).

Legt Schlüssel-Wert-Paare der Cachepartition für die Optionen fest. Bei Festlegung enthält die Tokencachesuche und -speicherung diese Komponenten und isoliert zwischengespeicherte Token aus Einträgen, die unterschiedliche (oder keine) Partitionsschlüssel aufweisen.

Betrachten Sie die Client-Assertion für die Tokenanforderung.

Fügt der Tokenakquisitionsanforderung zusätzliche Textparameter hinzu. Parameter werden in alle vorhandenen zusätzlichen Textparameterwörterbücher zusammengeführt, sodass dies mit anderen Erweiterungen zusammengesetzt werden kann, die auch Textparameter hinzufügen.