AcquireTokenByIntegratedWindowsAuthParameterBuilder Klasa
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Konstruktor dla elementu AcquireTokenByIntegratedWindowsAuth
public sealed class AcquireTokenByIntegratedWindowsAuthParameterBuilder : Microsoft.Identity.Client.AbstractPublicClientAcquireTokenParameterBuilder<Microsoft.Identity.Client.AcquireTokenByIntegratedWindowsAuthParameterBuilder>type AcquireTokenByIntegratedWindowsAuthParameterBuilder = class
inherit AbstractPublicClientAcquireTokenParameterBuilder<AcquireTokenByIntegratedWindowsAuthParameterBuilder>Public NotInheritable Class AcquireTokenByIntegratedWindowsAuthParameterBuilder
Inherits AbstractPublicClientAcquireTokenParameterBuilder(Of AcquireTokenByIntegratedWindowsAuthParameterBuilder)- Dziedziczenie
-
AbstractPublicClientAcquireTokenParameterBuilder<AcquireTokenByIntegratedWindowsAuthParameterBuilder>AcquireTokenByIntegratedWindowsAuthParameterBuilder
Metody
| Nazwa | Opis |
|---|---|
| ExecuteAsync() |
Wykonuje żądanie tokenu asynchronicznie. (Odziedziczone po BaseAbstractAcquireTokenParameterBuilder<T>) |
| ExecuteAsync(CancellationToken) |
Wykonuje żądanie tokenu asynchronicznie z możliwością anulowania metody asynchronicznej. (Odziedziczone po AbstractPublicClientAcquireTokenParameterBuilder<T>) |
| Validate() |
Weryfikuje parametry operacji AcquireToken. (Odziedziczone po BaseAbstractAcquireTokenParameterBuilder<T>) |
| WithAdfsAuthority(String, Boolean) |
Dodaje znany urząd odpowiadający serwerowi usług AD FS. Zobacz: https://aka.ms/msal-net-adfs. (Odziedziczone po AbstractAcquireTokenParameterBuilder<T>) |
| WithAuthority(AadAuthorityAudience, Boolean) |
Przestarzałe.
Ważne: zamiast tego użyj właściwości WithTenantId lub WithTenantIdFromAuthority lub WithB2CAuthority dla urzędów B2C. Dodaje do aplikacji znany urząd Azure AD w celu logowania użytkowników określających odbiorców logowania (chmura jest chmurą publiczną Azure). Zobacz: https://aka.ms/msal-net-application-configuration. (Odziedziczone po AbstractAcquireTokenParameterBuilder<T>) |
| WithAuthority(AzureCloudInstance, AadAuthorityAudience, Boolean) |
Przestarzałe.
Dodaje znany urząd Azure AD do aplikacji, aby logować użytkowników określających wystąpienie chmury i odbiorców logowania. Zobacz: https://aka.ms/msal-net-application-configuration. (Odziedziczone po AbstractAcquireTokenParameterBuilder<T>) |
| WithAuthority(AzureCloudInstance, Guid, Boolean) |
Przestarzałe.
Ważne: zamiast tego użyj właściwości WithTenantId lub WithTenantIdFromAuthority lub WithB2CAuthority dla urzędów B2C. Dodaje do aplikacji znany urząd Azure AD, aby logować użytkowników z jednej organizacji (pojedynczej aplikacji dzierżawy) opisanej przez wystąpienie chmury i identyfikator dzierżawy. Zobacz: https://aka.ms/msal-net-application-configuration. (Odziedziczone po AbstractAcquireTokenParameterBuilder<T>) |
| WithAuthority(AzureCloudInstance, String, Boolean) |
Przestarzałe.
Ważne: zamiast tego użyj właściwości WithTenantId lub WithTenantIdFromAuthority lub WithB2CAuthority dla urzędów B2C. Dodaje do aplikacji znany urząd Azure AD, aby logować użytkowników z jednej organizacji (pojedynczej aplikacji dzierżawy) opisanej przez wystąpienie chmury i nazwę domeny lub identyfikator dzierżawy. Zobacz: https://aka.ms/msal-net-application-configuration. (Odziedziczone po AbstractAcquireTokenParameterBuilder<T>) |
| WithAuthority(String, Boolean) |
Przestarzałe.
Ważne: zamiast tego użyj właściwości WithTenantId lub WithTenantIdFromAuthority lub WithB2CAuthority dla urzędów B2C. Określony urząd, dla którego żądano tokenu. Przekazywanie innej wartości niż skonfigurowano w konstruktorze aplikacji zawęża wybór do określonej dzierżawy. Nie powoduje to zmiany skonfigurowanej wartości w aplikacji. Jest to specyficzne dla aplikacji zarządzających kilkoma kontami (na przykład klient poczty z kilkoma skrzynkami pocztowymi). Zobacz: https://aka.ms/msal-net-application-configuration. (Odziedziczone po AbstractAcquireTokenParameterBuilder<T>) |
| WithAuthority(String, Guid, Boolean) |
Przestarzałe.
Ważne: zamiast tego użyj właściwości WithTenantId lub WithTenantIdFromAuthority lub WithB2CAuthority dla urzędów B2C. Dodaje do aplikacji znany urząd Azure AD, aby logować użytkowników z jednej organizacji (pojedynczej aplikacji dzierżawy) określonej przez jej identyfikator dzierżawy. Zobacz: https://aka.ms/msal-net-application-configuration. (Odziedziczone po AbstractAcquireTokenParameterBuilder<T>) |
| WithAuthority(String, String, Boolean) |
Przestarzałe.
Ważne: zamiast tego użyj właściwości WithTenantId lub WithTenantIdFromAuthority lub WithB2CAuthority dla urzędów B2C. Dodaje do aplikacji znany urząd Azure AD, aby logować użytkowników z jednej organizacji (aplikacji z jedną dzierżawą) opisaną przez jej nazwę domeny. Zobacz: https://aka.ms/msal-net-application-configuration. (Odziedziczone po AbstractAcquireTokenParameterBuilder<T>) |
| WithB2CAuthority(String) |
Dodaje znany urząd odpowiadający zasadom usługi Azure AD B2C. Zobacz https://aka.ms/msal-net-b2c-specificities (Odziedziczone po AbstractAcquireTokenParameterBuilder<T>) |
| WithClaims(String) |
Ustawia oświadczenia w zapytaniu. Użyj, gdy administrator usługi AAD włączył dostęp warunkowy. Uzyskanie tokenu zwykle spowoduje utworzenie MsalUiRequiredException obiektu z zestawem Claims właściwości. Ponów próbę uzyskania tokenu i użyj tej wartości w metodzie WithClaims(String) . Zobacz https://aka.ms/msal-exceptions , aby uzyskać szczegółowe informacje, a także https://aka.ms/msal-net-claim-challenge. (Odziedziczone po AbstractAcquireTokenParameterBuilder<T>) |
| WithCorrelationId(Guid) |
Ustawia identyfikator korelacji, który ma być używany w żądaniu uwierzytelniania. Służy do śledzenia żądania w dziennikach zarówno zestawu SDK, jak i usługi Dostawcy tożsamości. Jeśli nie zostanie ustawiona, zostanie wygenerowany losowy. (Odziedziczone po BaseAbstractAcquireTokenParameterBuilder<T>) |
| WithExtraQueryParameters(Dictionary<String,String>) |
Przestarzałe.
Ustawia dodatkowe parametry zapytania dla ciągu zapytania w żądaniu uwierzytelniania HTTP. (Odziedziczone po BaseAbstractAcquireTokenParameterBuilder<T>) |
| WithExtraQueryParameters(IDictionary<String,ValueTuple<String,Boolean>>) |
Ustawia dodatkowe parametry zapytania dla ciągu zapytania w żądaniu uwierzytelniania HTTP z kontrolą, które parametry są zawarte w kluczu pamięci podręcznej (Odziedziczone po BaseAbstractAcquireTokenParameterBuilder<T>) |
| WithExtraQueryParameters(String) |
Przestarzałe.
Ustawia dodatkowe parametry zapytania dla ciągu zapytania w żądaniu uwierzytelniania HTTP. (Odziedziczone po AbstractAcquireTokenParameterBuilder<T>) |
| WithFederationMetadata(String) |
Umożliwia biblioteki MSAL odczytywanie metadanych federacji dla WS-Trust wymiany z podanych danych wejściowych zamiast pobierania ich z punktu końcowego. Dotyczy to tylko zarządzanych kont usług AD FS. Zobacz: https://aka.ms/MsalFederationMetadata. |
| WithScopes(IEnumerable<String>) |
Określa zakresy do żądania. Ta metoda jest używana, gdy aplikacja musi określić zakresy wymagane do wywołania chronionego interfejsu API. >https://docs.microsoft.com/azure/active-directory/develop/v2-permissions-and-consent<Zobacz</zobacz>, aby dowiedzieć się więcej na temat zakresów, uprawnień i zgody oraz zobacz/zobacz>>https://docs.microsoft.com/azure/active-directory/develop/msal-v1-app-scopes<, aby dowiedzieć się, <jak tworzyć zakresy dla starszych aplikacji, które były używane do uwidaczniania uprawnień OAuth2. (Odziedziczone po AbstractAcquireTokenParameterBuilder<T>) |
| WithTenantId(String) |
Zastępuje identyfikator dzierżawy określony w urzędzie na poziomie aplikacji. Ta operacja zachowuje hosta urzędu (środowisko). Jeśli urząd nie został określony na poziomie aplikacji, używana wartość domyślna to |
| WithTenantIdFromAuthority(Uri) |
Wyodrębnia identyfikator dzierżawy z podanego identyfikatora URI urzędu i zastępuje identyfikator dzierżawy określony w urzędzie na poziomie aplikacji. Ta operacja zachowuje hosta urzędu (środowisko) udostępnione konstruktorowi aplikacji.
Jeśli dla konstruktora aplikacji nie podano urzędu, ta metoda zastąpi identyfikator dzierżawy w urzędzie domyślnym — |
| WithUsername(String) |
Określa nazwę użytkownika. |
Metody rozszerzania
| Nazwa | Opis |
|---|---|
| OnBeforeTokenRequest<T>(AbstractAcquireTokenParameterBuilder<T>, Func<OnBeforeTokenRequestData,Task>) |
Interweniuje w potoku żądania, wykonując pełnomocnika dostarczonego przez użytkownika, zanim biblioteka MSAL wysyła żądanie tokenu. Delegat może zmodyfikować ładunek żądania, dodając lub usuwając parametry treści i nagłówki. OnBeforeTokenRequestData |
| WithAdditionalCacheParameters<T>(AbstractAcquireTokenParameterBuilder<T>, IEnumerable<String>) |
Określa dodatkowe parametry uzyskane z odpowiedzi uwierzytelniania, które mają być buforowane z tokenem dostępu, które zwykle nie są uwzględnione w obiekcie pamięci podręcznej. te wartości można odczytać z parametru AdditionalResponseParameters . |
| WithAuthenticationExtension<T>(AbstractAcquireTokenParameterBuilder<T>, MsalAuthenticationExtension) |
Umożliwia aplikacjom klienckim udostępnianie niestandardowej operacji uwierzytelniania, która ma być używana w żądaniu pozyskiwania tokenu. |
| WithCachePartitionKey<T>(BaseAbstractAcquireTokenParameterBuilder<T>, String, String) |
Dodaje parę klucz-wartość do klucza pamięci podręcznej tokenu bez wysyłania go jako parametru zapytania.
Służy do partycjonowania buforowanych tokenów (np. izolowania sesji krótkotrwałych z regularnych sesji dla tego samego użytkownika). Zarówno |
| WithExtraClientAssertionClaims<T>(AbstractAcquireTokenParameterBuilder<T>, String) |
Określa dodatkowe oświadczenia, które mają być uwzględnione w asercji klienta. Te oświadczenia zostaną scalone z oświadczeniami domyślnymi po wygenerowaniu asercji klienta. Dzięki temu interfejsy API wyższego poziomu, takie jak Microsoft. Identity.Web udostępniają dodatkowe oświadczenia dla potwierdzenia klienta. Ważne: tokeny są skojarzone z dodatkowymi oświadczeniami asercji klienta, które mają wpływ na wyszukiwanie w pamięci podręcznej. Jest to interfejs API rozszerzalności i nie powinien być używany bezpośrednio przez aplikacje. |
| WithExtraHttpHeaders<T>(AbstractAcquireTokenParameterBuilder<T>, IDictionary<String,String>) |
Przestarzałe.
Dodaje dodatkowe nagłówki HTTP do żądania tokenu. |
| WithExtraHttpHeaders<T>(AbstractAcquireTokenParameterBuilder<T>, IDictionary<String,String>) |
Dodaje dodatkowe nagłówki HTTP do żądania tokenu. |
| WithFmiPathForClientAssertion<T>(AbstractAcquireTokenParameterBuilder<T>, String) |
Określa ścieżkę FMI, która ma być używana dla asercji klienta. Dzięki temu interfejsy API wyższego poziomu, takie jak Id.Web, udostępniają poświadczenia poufne w standardzie FMI. Ważne: tokeny są skojarzone ze ścieżką FMI poświadczeń, która ma wpływ na wyszukiwanie w pamięci podręcznej Jest to interfejs API rozszerzalności i nie powinien być używany przez aplikacje. |
| WithProofOfPosessionKeyId<T>(AbstractAcquireTokenParameterBuilder<T>, String, String) |
Wiąże token z kluczem w pamięci podręcznej. Na tokenie nie są wykonywane żadne operacje kryptograficzne. |