GetAuthorizationRequestUrlParameterBuilder 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.
UWAGA: kilka metod w abstractAcquireTokenParameterBuilder (np. konto) nie ma sensu w tym miejscu. Czy chcemy utworzyć kolejną bazę zawierającą wszystkie typowe metody, a następnie mieć inną, w tym konto itp., które są używane tylko dla metody AcquireToken?
public sealed class GetAuthorizationRequestUrlParameterBuilder : Microsoft.Identity.Client.AbstractConfidentialClientAcquireTokenParameterBuilder<Microsoft.Identity.Client.GetAuthorizationRequestUrlParameterBuilder>type GetAuthorizationRequestUrlParameterBuilder = class
inherit AbstractConfidentialClientAcquireTokenParameterBuilder<GetAuthorizationRequestUrlParameterBuilder>Public NotInheritable Class GetAuthorizationRequestUrlParameterBuilder
Inherits AbstractConfidentialClientAcquireTokenParameterBuilder(Of GetAuthorizationRequestUrlParameterBuilder)- Dziedziczenie
-
GetAuthorizationRequestUrlParameterBuilder
Metody
| Nazwa | Opis |
|---|---|
| ExecuteAsync() |
UWAGA: kilka metod w abstractAcquireTokenParameterBuilder (np. konto) nie ma sensu w tym miejscu. Czy chcemy utworzyć kolejną bazę zawierającą wszystkie typowe metody, a następnie mieć inną, w tym konto itp., które są używane tylko dla metody AcquireToken? |
| ExecuteAsync(CancellationToken) |
UWAGA: kilka metod w abstractAcquireTokenParameterBuilder (np. konto) nie ma sensu w tym miejscu. Czy chcemy utworzyć kolejną bazę zawierającą wszystkie typowe metody, a następnie mieć inną, w tym konto itp., które są używane tylko dla metody AcquireToken? |
| Validate() |
Weryfikuje parametry operacji AcquireToken. (Odziedziczone po AbstractConfidentialClientAcquireTokenParameterBuilder<T>) |
| WithAccount(IAccount) |
UWAGA: kilka metod w abstractAcquireTokenParameterBuilder (np. konto) nie ma sensu w tym miejscu. Czy chcemy utworzyć kolejną bazę zawierającą wszystkie typowe metody, a następnie mieć inną, w tym konto itp., które są używane tylko dla metody AcquireToken? |
| 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>) |
| WithCcsRoutingHint(String, String) |
Aby ułatwić odporność, system uwierzytelniania kopii zapasowej usługi AAD działa jako kopia zapasowa usługi AAD. Zapewni to system uwierzytelniania kopii zapasowej usługi AAD z wskazówką routingu, aby zwiększyć wydajność podczas uwierzytelniania. Wskazówka utworzona za pomocą tego interfejsu API będzie mieć pierwszeństwo przed tą utworzoną za pomocą WithLoginHint(String) |
| 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>) |
| WithExtraScopesToConsent(IEnumerable<String>) |
UWAGA: kilka metod w abstractAcquireTokenParameterBuilder (np. konto) nie ma sensu w tym miejscu. Czy chcemy utworzyć kolejną bazę zawierającą wszystkie typowe metody, a następnie mieć inną, w tym konto itp., które są używane tylko dla metody AcquireToken? |
| WithLoginHint(String) |
UWAGA: kilka metod w abstractAcquireTokenParameterBuilder (np. konto) nie ma sensu w tym miejscu. Czy chcemy utworzyć kolejną bazę zawierającą wszystkie typowe metody, a następnie mieć inną, w tym konto itp., które są używane tylko dla metody AcquireToken? |
| WithPkce(String) |
Służy do zabezpieczania udzielania kodu autoryzacji za pośrednictwem klucza weryfikacji kodu Exchange (PKCE). Aby uzyskać więcej informacji, zobacz PKCE RCF: https://tools.ietf.org/html/rfc7636 |
| WithPrompt(Prompt) |
Określa środowisko interaktywne dla użytkownika. |
| WithProofOfPossession(PoPAuthenticationConfiguration) |
Przestarzałe.
Modyfikuje żądanie pozyskiwania tokenu, tak aby uzyskany token był tokenem dowodowym posiadania (PoP), a nie tokenem elementu nośnego. Tokeny poP są podobne do tokenów elementu nośnego, ale są powiązane z żądaniem HTTP i kluczem kryptograficznym, którym biblioteka MSAL może zarządzać w Windows. Zobacz https://aka.ms/msal-net-pop (Odziedziczone po AbstractConfidentialClientAcquireTokenParameterBuilder<T>) |
| WithRedirectUri(String) |
Ustawia identyfikator URI przekierowania, aby dodać go do adresu URL żądania autoryzacji |
| 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. <Zobacz>https://docs.microsoft.com/azure/active-directory/develop/v2-permissions-and-consent</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>) |
| WithSignedHttpRequestProofOfPossession(PoPAuthenticationConfiguration) |
Modyfikuje żądanie uzyskania tokenu dowodu posiadania podpisanego żądania HTTP (SHR), a nie elementu nośnego. Tokeny SHR PoP są powiązane z żądaniem HTTP i kluczem kryptograficznym, który biblioteka MSAL zarządza w Windows. Tokeny SHR PoP różnią się od tokenów mTLS PoP, które są używane do uwierzytelniania wzajemnego protokołu TLS (mTLS). Zobacz https://aka.ms/mtls-pop , aby uzyskać szczegółowe informacje. (Odziedziczone po AbstractConfidentialClientAcquireTokenParameterBuilder<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 — |
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 . |
| WithAttributeTokens<T>(AbstractConfidentialClientAcquireTokenParameterBuilder<T>, IEnumerable<String>) |
|
| 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 |
| WithClaimsFromClient<T>(AbstractConfidentialClientAcquireTokenParameterBuilder<T>, String) |
Określa oświadczenia pochodzące od klienta, które mają być uwzględnione w żądaniu tokenu. W przeciwieństwie do (w przypadku WithClaims(String) problemów z oświadczeniami wystawionymi przez serwer) tokeny pozyskane za pomocą oświadczeń klienta są buforowane , a wpis pamięci podręcznej jest kluczem wartości oświadczeń. Różne wartości oświadczeń tworzą oddzielne wpisy pamięci podręcznej. Użyj stabilnych, niedynamicznych wartości, aby uniknąć niezwiązanego wzrostu pamięci podręcznej. |
| WithExtraBodyParameters<T>(AbstractConfidentialClientAcquireTokenParameterBuilder<T>, Dictionary<String,Func<CancellationToken,Task<String>>>) |
Dodaj dodatkowe parametry treści do żądania tokenu. Te parametry są dodawane do klucza pamięci podręcznej w celu skojarzenia tych parametrów z uzyskanym tokenem. Działa w przypadku poufnych przepływów klienta (AcquireTokenForClient, AcquireTokenOnBehalfOf, AcquireTokenByAuthorizationCode). |
| 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. |