Microsoft.Identity.Client Przestrzeń nazw

Klasa podstawowa dla konstruktorów żądań tokenu, które próbują uzyskać token na podstawie podanych parametrów.

Microsoft.Identity.Clientto podstawowa przestrzeń nazw Microsoft Authentication Library (MSAL) dla .NET, która jest dostępna za pośrednictwem Microsoft.Identity.Client pakietu. Zawiera on wszystkie kluczowe składniki, które należy uzyskać token od obsługiwanych dostawców uwierzytelniania.

Instalacja

Za pomocą interfejsu .NET Command-Line (CLI):

dotnet add package Microsoft.Identity.Client

Za pomocą interfejsu wiersza polecenia (CLI) narzędzia NuGet:

nuget install Microsoft.Identity.Client

Za pomocą konsoli Menedżer pakietów:

Install-Package Microsoft.Identity.Client

Korzystanie z Visual Studio:

1. Otwórz Eksplorator rozwiązań.
2. Kliknij prawym przyciskiem myszy projekt w rozwiązaniu.
3. Kliknij pozycję Zarządzaj pakietami NuGet...
4. Kliknij kartę Przeglądaj i wyszukaj ciąg Microsoft.Identity.Client.
5. Microsoft.Identity.Client Kliknij pakiet i kliknij przycisk Zainstaluj.

Dokumentacja

Aby rozpocząć, zapoznaj się z przewodnikiem Microsoft Authentication Library .NET.

Przykłady

Zapoznaj się z przykładami kodu Platforma tożsamości Microsoft i przeglądarką Samples Browser.

Klasa bazowa dla konstruktorów parametrów typowych dla publicznej aplikacji klienckiej i poufnych operacji pozyskiwania tokenu aplikacji klienckiej

Klasa podstawowa dla konstruktorów żądań tokenu poufnej aplikacji klienckiej

Abstrakcyjna klasa podstawowa dla konstruktorów żądań tokenu aplikacji tożsamości zarządzanej.

Klasa podstawowa dla konstruktorów żądań tokenu aplikacji klienckiej publicznej

Metody rozszerzeń dla IAccount

Identyfikator konta w określonej dzierżawie. Zwrócone przez IAccount.HomeAccountId

Konstruktor dla elementu AcquireTokenByAuthorizationCode

Konstruktor dla elementu AcquireTokenByIntegratedWindowsAuth

Konstruktor parametrów AcquireTokenByRefreshToken(IEnumerable<String>, String) dla metody . Zobacz https://aka.ms/msal-net-migration-adal2-msal2

Konstruktor parametrów AcquireTokenByUserFederatedIdentityCredential(IEnumerable<String>, String, String) dla operacji.

Konstruktor parametrów AcquireTokenByUsernamePassword(IEnumerable<String>, String, String) dla operacji. Zobacz https://aka.ms/msal-net-up

Konstruktor parametrów AcquireTokenByUsernamePassword(IEnumerable<String>, String, String) dla operacji. Zobacz https://aka.ms/msal-net-up

Builder for AcquireTokenForClient (używany w przepływach poświadczeń klienta w aplikacjach demona). Zobacz https://aka.ms/msal-net-client-credentials

Konstruktor dla elementu AcquireTokenForManagedIdentity (używany do pobierania tokenu dla tożsamości zarządzanych). Zobacz https://aka.ms/msal-net-managed-identity

Konstruktor żądania tokenu interakcyjnego. Zobacz https://aka.ms/msal-net-acquire-token-interactively

Konstruktor dla elementu AcquireTokenOnBehalfOf (przepływ OBO) Zobacz https://aka.ms/msal-net-on-behalf-of

Konstruktor parametrów AcquireTokenSilent(IEnumerable<String>, IAccount) dla operacji. Zobacz https://aka.ms/msal-net-acquiretokensilent

Konstruktor parametrów dla AcquireTokenWithDeviceCode(IEnumerable<String>, Func<DeviceCodeResult,Task>) operacji. Zobacz https://aka.ms/msal-net-device-code-flow

Interfejs używany do tworzenia aplikacji klienckich. Aby uzyskać szczegółowe informacje, zobacz https://aka.ms/msal-net-client-applications.

Klasa podstawowa dla obiektów opcji z wartościami ciągów ładowanymi z pliku konfiguracji (na przykład pliku JSON, jak w scenariuszu konfiguracji asp.net) Zobacz https://aka.ms/msal-net-application-configuration również klasy PublicClientApplicationOptions pochodne i ConfidentialClientApplicationOptions

Informacje o asercji klienta, które należy wygenerować Zobacz https://aka.ms/msal-net-client-assertion

Przeanalizowane nagłówki uwierzytelniania w celu pobrania wartości nagłówka z HttpResponseHeaderselementu .

Parametry zwracane przez nagłówek Authentication-Info. Pozwala to na scenariusze, takie jak dowód posiadania itp. Zobacz https://www.rfc-editor.org/rfc/rfc7615

Zawiera wyniki jednej operacji pozyskiwania tokenu w elemencie PublicClientApplication Lub ConfidentialClientApplication. Aby uzyskać szczegółowe informacje, zobacz https://aka.ms/msal-net-authenticationresult

Zawiera metadane wyniku uwierzytelniania. Metrics dodatkowe metryki obejmujące bibliotekę MSAL.

Klasa podstawowa dla konstruktorów żądań tokenu, które próbują uzyskać token na podstawie podanych parametrów.

Microsoft.Identity.Clientto podstawowa przestrzeń nazw Microsoft Authentication Library (MSAL) dla .NET, która jest dostępna za pośrednictwem Microsoft.Identity.Client pakietu. Zawiera on wszystkie kluczowe składniki, które należy uzyskać token od obsługiwanych dostawców uwierzytelniania.

Instalacja

Za pomocą interfejsu .NET Command-Line (CLI):

dotnet add package Microsoft.Identity.Client

Za pomocą interfejsu wiersza polecenia (CLI) narzędzia NuGet:

nuget install Microsoft.Identity.Client

Za pomocą konsoli Menedżer pakietów:

Install-Package Microsoft.Identity.Client

Korzystanie z Visual Studio:

1. Otwórz Eksplorator rozwiązań.
2. Kliknij prawym przyciskiem myszy projekt w rozwiązaniu.
3. Kliknij pozycję Zarządzaj pakietami NuGet...
4. Kliknij kartę Przeglądaj i wyszukaj ciąg Microsoft.Identity.Client.
5. Microsoft.Identity.Client Kliknij pakiet i kliknij przycisk Zainstaluj.

Dokumentacja

Aby rozpocząć, zapoznaj się z przewodnikiem Microsoft Authentication Library .NET.

Przykłady

Zapoznaj się z przykładami kodu Platforma tożsamości Microsoft i przeglądarką Samples Browser.

Klasa podstawowa dla obiektów opcji z wartościami ciągów ładowanymi z pliku konfiguracji (na przykład pliku JSON, jak w scenariuszu konfiguracji asp.net) Zobacz https://aka.ms/msal-net-application-configuration również klasy pochodne ApplicationOptions

Klasa określa opcje brokera w systemach operacyjnych Wspólne właściwości są bezpośrednimi właściwościami członkowskimi Właściwości specyficzne dla platformy (jeśli istnieją) są częścią odpowiednich opcji

Opcje pamięci podręcznych tokenów biblioteki MSAL.

Klasa abstrakcyjna zawierająca typowe metody i właściwości interfejsu API. Zarówno PublicClientApplication , jak i ConfidentialClientApplication, rozszerz tę klasę. Aby uzyskać szczegółowe informacje, zobacz https://aka.ms/msal-net-client-applications

Kontener zwrócony z WithClientAssertion.

Klasa do użycia w przypadku poufnych aplikacji klienckich (aplikacji internetowych, internetowych interfejsów API i aplikacji demona).

Microsoft.Identity.Clientto podstawowa przestrzeń nazw Microsoft Authentication Library (MSAL) dla .NET, która jest dostępna za pośrednictwem Microsoft.Identity.Client pakietu. Zawiera on wszystkie kluczowe składniki, które należy uzyskać token od obsługiwanych dostawców uwierzytelniania.

Instalacja

Za pomocą interfejsu .NET Command-Line (CLI):

dotnet add package Microsoft.Identity.Client

Za pomocą interfejsu wiersza polecenia (CLI) narzędzia NuGet:

nuget install Microsoft.Identity.Client

Za pomocą konsoli Menedżer pakietów:

Install-Package Microsoft.Identity.Client

Korzystanie z Visual Studio:

1. Otwórz Eksplorator rozwiązań.
2. Kliknij prawym przyciskiem myszy projekt w rozwiązaniu.
3. Kliknij pozycję Zarządzaj pakietami NuGet...
4. Kliknij kartę Przeglądaj i wyszukaj ciąg Microsoft.Identity.Client.
5. Microsoft.Identity.Client Kliknij pakiet i kliknij przycisk Zainstaluj.

Dokumentacja

Aby rozpocząć, zapoznaj się z przewodnikiem Microsoft Authentication Library .NET.

Przykłady

Zapoznaj się z przykładami kodu Platforma tożsamości Microsoft i przeglądarką Samples Browser.

Opcje konfiguracji poufnej aplikacji klienckiej (aplikacja internetowa/ internetowy interfejs API/aplikacja demona). Zobacz https://aka.ms/msal-net/application-configuration

Ten obiekt jest zwracany w ramach przepływu kodu urządzenia i ma informacje, które mają być wyświetlane użytkownikowi o tym, gdzie przejść do logowania i jaki kod urządzenia musi zostać wprowadzony na tym urządzeniu. Zobacz: https://aka.ms/msal-device-code-flow.

Opcje korzystania z osadzonego widoku internetowego.

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?

Ten wyjątek jest zgłaszany, gdy usługa Intune wymaga zasad ochrony aplikacji. Informacje przedstawione w tym wyjątku mogą być używane przez aplikację do uzyskania wymaganego identyfikatora rejestracji z zestawu SDK zarządzania aplikacjami mobilnymi (MAM). Zobacz https://aka.ms/msal-net-trueMAM

Klasa do użycia w aplikacjach tożsamości zarządzanych (w zasobach Azure, takich jak App Services, Virtual Machines, Azure Arc, Service Fabric i Cloud Shell).

Konstruktor aplikacji tożsamości zarządzanych.

Metody rozszerzeń umożliwiające włączenie funkcji weryfikacji posiadania biblioteki mTLS w przepływach tożsamości zarządzanych.

Metryki obejmujące bibliotekę MSAL.

Ten wyjątek wskazuje, że oświadczenia zostały zwrócone z punktu końcowego, który należy rozwiązać. Można to osiągnąć, używając ich w następnym żądaniu uwierzytelniania. Zobacz Wyzwania związane z dostępem warunkowym i oświadczeniami. Zobacz Obsługa uwierzytelniania wieloskładnikowego (MFA), dostępu warunkowego i zgody przyrostowej.

Ta klasa wyjątku reprezentuje błędy lokalne dla biblioteki lub urządzenia. W przeciwieństwie do MsalServiceException tego, które reprezentują błędy występujące w usłudze Azure AD lub sieci. Aby uzyskać więcej informacji, zobacz https://aka.ms/msal-net-exceptions

Kod błędu zwrócony jako właściwość w msalException

Typ wyjątku podstawowego zgłaszany, gdy wystąpi błąd podczas pozyskiwania tokenu. Aby uzyskać więcej informacji, zobacz https://aka.ms/msal-net-exceptions

Ta klasa wyjątku dotyczy wyjątków generowanych ze źródeł tożsamości zarządzanych. Ta klasa jest przestarzała i zostanie usunięta w przyszłej wersji. Zamiast tego catch MsalServiceException. Aby uzyskać więcej informacji, zobacz https://aka.ms/msal-net-managed-identity

Typ wyjątku zgłaszany, gdy usługa zwraca odpowiedź o błędzie lub wystąpią inne błędy sieciowe. Aby uzyskać więcej informacji, zobacz https://aka.ms/msal-net-exceptions

Typ wyjątku zgłaszany, gdy biblioteka MSAL wykrywa, że aplikacja próbuje uzyskać token zbyt często, w wyniku:

• Poprzednie żądanie spowodowało odpowiedź HTTP zawierającą nagłówek Retry-After, który nie był obserwowany.
• Poprzednie żądanie spowodowało błąd HTTP 429 lub 5xx, co oznacza problem z serwerem.

Właściwości tego wyjątku są identyczne z oryginalnym wyjątkiem

Aby uzyskać więcej informacji, zobacz https://aka.ms/msal-net-throttling

Typ wyjątku zgłaszany, gdy biblioteka MSAL wykryje, że aplikacja próbuje uzyskać token, mimo że MsalUiRequiredException ostatnio został zgłoszony. Aby temu zapobiec, gdy MsalUiRequiredException wystąpi błąd, aplikacja powinna przełączyć się na interaktywne uzyskiwanie tokenu. Aby lepiej zrozumieć, dlaczego MsalUiRequiredException został zgłoszony, sprawdź Classification właściwość.

Właściwości tego wyjątku są identyczne z oryginalnym wyjątkiem

Aby uzyskać więcej informacji, zobacz https://aka.ms/msal-net-throttling

Ta klasa wyjątku polega na informowaniu deweloperów, że interakcja interfejsu użytkownika jest wymagana do pomyślnego uwierzytelnienia. Jest zgłaszany podczas wywoływania AcquireTokenSilent(IEnumerable<String>, IAccount) lub jednego z jego przesłonięć, a gdy token nie istnieje w pamięci podręcznej, lub użytkownik musi zapewnić więcej zawartości lub wykonać uwierzytelnianie wieloskładnikowe na podstawie zasad Azure AD itp. Aby uzyskać więcej informacji, zobacz https://aka.ms/msal-net-exceptions

Metody rozszerzeń

Klasa abstrakcyjna zawierająca typowe metody i właściwości interfejsu API. Aby uzyskać szczegółowe informacje, zobacz https://aka.ms/msal-net-client-applications

Microsoft.Identity.Clientto podstawowa przestrzeń nazw Microsoft Authentication Library (MSAL) dla .NET, która jest dostępna za pośrednictwem Microsoft.Identity.Client pakietu. Zawiera on wszystkie kluczowe składniki, które należy uzyskać token od obsługiwanych dostawców uwierzytelniania.

Instalacja

Za pomocą interfejsu .NET Command-Line (CLI):

dotnet add package Microsoft.Identity.Client

Za pomocą interfejsu wiersza polecenia (CLI) narzędzia NuGet:

nuget install Microsoft.Identity.Client

Za pomocą konsoli Menedżer pakietów:

Install-Package Microsoft.Identity.Client

Korzystanie z Visual Studio:

1. Otwórz Eksplorator rozwiązań.
2. Kliknij prawym przyciskiem myszy projekt w rozwiązaniu.
3. Kliknij pozycję Zarządzaj pakietami NuGet...
4. Kliknij kartę Przeglądaj i wyszukaj ciąg Microsoft.Identity.Client.
5. Microsoft.Identity.Client Kliknij pakiet i kliknij przycisk Zainstaluj.

Dokumentacja

Aby rozpocząć, zapoznaj się z przewodnikiem Microsoft Authentication Library .NET.

Przykłady

Zapoznaj się z przykładami kodu Platforma tożsamości Microsoft i przeglądarką Samples Browser.

Metody rozszerzalności dla IPublicClientApplication

Opcje konfiguracji dla publicznej aplikacji klienckiej (aplikacja klasyczna/mobilna). Zobacz https://aka.ms/msal-net/application-configuration

Zawiera wynik regionu, w którym jest używane odnajdywanie regionów biblioteki MSAL, opublikowane w ramach uwierzytelnianiaResultMetadata. AuthenticationResultMetadata dodatkowe informacje o metadanych wyniku uwierzytelniania.

Opcje używania domyślnej przeglądarki systemu operacyjnego jako oddzielnego procesu obsługi uwierzytelniania interakcyjnego. Biblioteka MSAL nasłuchuje przeglądarki systemu operacyjnego w celu zakończenia uwierzytelniania, ale nie może zamknąć przeglądarki. Może on jednak odpowiedzieć za pomocą komunikatu 200 OK lub przekierowania 302, który można skonfigurować tutaj. Aby uzyskać więcej informacji, zobacz https://aka.ms/msal-net-os-browser

Reprezentuje konto w określonej dzierżawie. To samo konto może istnieć w dzierżawie głównej, a także jako gość w wielu innych dzierżawach. Tokeny dostępu i tokeny identyfikatorów są specyficzne dla dzierżawy, a ten obiekt zawiera ogólne informacje o wszystkich tokenach identyfikatorów skojarzonych z kontem.

Pamięć podręczna tokenów przechowująca tokeny dostępu i odświeżania dla kont Ta klasa jest używana w konstruktorach PublicClientApplication elementów i ConfidentialClientApplication. W przypadku klasy ConfidentialClientApplication używane są dwa wystąpienia, jedno dla pamięci podręcznej tokenu użytkownika i jedno dla pamięci podręcznej tokenu aplikacji (w przypadku aplikacji korzystających z przepływów poświadczeń klienta).

Metody rozszerzenia dla ITokenCache

Zawiera parametry używane przez wywołanie MSAL, które uzyskuje dostęp do pamięci podręcznej. Zobacz również ITokenCacheSerializer , który zawiera metody dostosowywania serializacji pamięci podręcznej. Aby uzyskać więcej informacji na temat pamięci podręcznej tokenów, zobacz https://aka.ms/msal-net-web-token-cache

Prosta ITelemetryConfig implementacja, która zapisuje dane przy użyciu elementu System.Diagnostics.Trace.

Microsoft.Identity.Clientto podstawowa przestrzeń nazw Microsoft Authentication Library (MSAL) dla .NET, która jest dostępna za pośrednictwem Microsoft.Identity.Client pakietu. Zawiera on wszystkie kluczowe składniki, które należy uzyskać token od obsługiwanych dostawców uwierzytelniania.

Instalacja

Za pomocą interfejsu .NET Command-Line (CLI):

dotnet add package Microsoft.Identity.Client

Za pomocą interfejsu wiersza polecenia (CLI) narzędzia NuGet:

nuget install Microsoft.Identity.Client

Za pomocą konsoli Menedżer pakietów:

Install-Package Microsoft.Identity.Client

Korzystanie z Visual Studio:

1. Otwórz Eksplorator rozwiązań.
2. Kliknij prawym przyciskiem myszy projekt w rozwiązaniu.
3. Kliknij pozycję Zarządzaj pakietami NuGet...
4. Kliknij kartę Przeglądaj i wyszukaj ciąg Microsoft.Identity.Client.
5. Microsoft.Identity.Client Kliknij pakiet i kliknij przycisk Zainstaluj.

Dokumentacja

Aby rozpocząć, zapoznaj się z przewodnikiem Microsoft Authentication Library .NET.

Przykłady

Zapoznaj się z przykładami kodu Platforma tożsamości Microsoft i przeglądarką Samples Browser.

Zaawansowane opcje korzystania z brokera Windows 10. Aby uzyskać więcej informacji, zobacz https://aka.ms/msal-net-wam

Parametry zwracane przez nagłówek WWW-Authenticate. Pozwala to na dynamiczne scenariusze, takie jak wyzwanie oświadczeń, ocena ciągłego dostępu (CAE) i dostęp warunkowy (CAE). Zobacz: https://aka.ms/msal-net/wwwAuthenticate.

Struktura zawierająca statyczne elementy członkowskie, których można użyć do określenia sposobu, w jaki interakcyjne przesłonięcia metody AcquireTokenAsync w IPublicClientApplication programie powinny monitować użytkownika.

Interfejs IAccount reprezentuje informacje o pojedynczym koncie. Ten sam użytkownik może być obecny w różnych dzierżawach, czyli użytkownik może mieć wiele kont. Element IAccount jest zwracany we AuthenticationResultwłaściwości .Account i może służyć jako parametry metod PublicClientApplication i ConfidentialClientApplication uzyskiwania tokenów, takich jak AcquireTokenSilent(IEnumerable<String>, IAccount)

Właściwości konfiguracji używane do tworzenia publicznej lub poufnej aplikacji klienckiej.

Interfejs używany do tworzenia aplikacji klienckich. Aby uzyskać szczegółowe informacje, zobacz https://aka.ms/msal-net-client-applications.

Microsoft.Identity.Clientto podstawowa przestrzeń nazw Microsoft Authentication Library (MSAL) dla .NET, która jest dostępna za pośrednictwem Microsoft.Identity.Client pakietu. Zawiera on wszystkie kluczowe składniki, które należy uzyskać token od obsługiwanych dostawców uwierzytelniania.

Instalacja

Za pomocą interfejsu .NET Command-Line (CLI):

dotnet add package Microsoft.Identity.Client

Za pomocą interfejsu wiersza polecenia (CLI) narzędzia NuGet:

nuget install Microsoft.Identity.Client

Za pomocą konsoli Menedżer pakietów:

Install-Package Microsoft.Identity.Client

Korzystanie z Visual Studio:

1. Otwórz Eksplorator rozwiązań.
2. Kliknij prawym przyciskiem myszy projekt w rozwiązaniu.
3. Kliknij pozycję Zarządzaj pakietami NuGet...
4. Kliknij kartę Przeglądaj i wyszukaj ciąg Microsoft.Identity.Client.
5. Microsoft.Identity.Client Kliknij pakiet i kliknij przycisk Zainstaluj.

Dokumentacja

Aby rozpocząć, zapoznaj się z przewodnikiem Microsoft Authentication Library .NET.

Przykłady

Zapoznaj się z przykładami kodu Platforma tożsamości Microsoft i przeglądarką Samples Browser.

Udostępnia interfejs do uzyskiwania tokenów przy użyciu przepływu poświadczeń tożsamości federacyjnej użytkownika (UserFIC).

Udostępnia jawny interfejs do korzystania z przyznawania haseł właściciela zasobu w kliencie poufnym.

Interfejs definiujący typowe metody i właściwości interfejsu API. Zarówno, PublicClientApplication jak i ConfidentialClientApplication rozszerz tę klasę. Aby uzyskać szczegółowe informacje, zobacz https://aka.ms/msal-net-client-applications

Reprezentuje poufne aplikacje klienckie — aplikacje internetowe, internetowe interfejsy API, aplikacje demona.

Metody dla długotrwałych lub w tle procesów w internetowych interfejsach API.

Składnik do użycia z aplikacjami tożsamości zarządzanych dla zasobów Azure.

Fabryka odpowiedzialna za tworzenie klienta HttpClient. Aby uzyskać więcej informacji, zobacz https://learn.microsoft.com/dotnet/api/system.net.http.httpclient?view=net-7.0#instancing.

Fabryka odpowiedzialna za tworzenie wystąpień httpClient skonfigurowanych dla wzajemnego protokołu TLS (mTLS). Ta fabryka jest przeznaczona do zabezpieczania komunikacji z usługą Azure AD przy użyciu biblioteki mTLS. Aby uzyskać więcej informacji na temat instancingu httpClient, zobacz https://learn.microsoft.com/en-us/dotnet/api/system.net.http.httpclient?view=net-8.0#instancing.

Fabryka odpowiedzialna za tworzenie klienta HttpClient z wywołaniem zwrotnym weryfikacji certyfikatu niestandardowego serwera. Jest to przydatne w scenariuszu usługi Fabric, w którym weryfikacja certyfikatu serwera jest wymagana przy użyciu certyfikatu serwera. Zobaczhttps://learn.microsoft.com/dotnet/api/system.net.http.httpclient?view=net-7.0#instancing, aby uzyskać więcej szczegółów.

Reprezentuje publiczne aplikacje klienckie — aplikacje klasyczne i mobilne.

Microsoft.Identity.Clientto podstawowa przestrzeń nazw Microsoft Authentication Library (MSAL) dla .NET, która jest dostępna za pośrednictwem Microsoft.Identity.Client pakietu. Zawiera on wszystkie kluczowe składniki, które należy uzyskać token od obsługiwanych dostawców uwierzytelniania.

Instalacja

Za pomocą interfejsu .NET Command-Line (CLI):

dotnet add package Microsoft.Identity.Client

Za pomocą interfejsu wiersza polecenia (CLI) narzędzia NuGet:

nuget install Microsoft.Identity.Client

Za pomocą konsoli Menedżer pakietów:

Install-Package Microsoft.Identity.Client

Korzystanie z Visual Studio:

1. Otwórz Eksplorator rozwiązań.
2. Kliknij prawym przyciskiem myszy projekt w rozwiązaniu.
3. Kliknij pozycję Zarządzaj pakietami NuGet...
4. Kliknij kartę Przeglądaj i wyszukaj ciąg Microsoft.Identity.Client.
5. Microsoft.Identity.Client Kliknij pakiet i kliknij przycisk Zainstaluj.

Dokumentacja

Aby rozpocząć, zapoznaj się z przewodnikiem Microsoft Authentication Library .NET.

Przykłady

Zapoznaj się z przykładami kodu Platforma tożsamości Microsoft i przeglądarką Samples Browser.

Dane reprezentujące pojedynczą migawkę w serii zdarzeń, które są zbierane

Jest to interfejs, który implementuje publiczny dostęp do operacji pamięci podręcznej. W przypadku pamięci podręcznej CacheV2 powinno to być konieczne tylko wtedy, gdy obiekt wywołujący utrwala pamięć podręczną we własnym magazynie, ponieważ zapewni to serializowanie/deserializowanie i przed/po powiadomieniach używanych w tym scenariuszu. Zobacz https://aka.ms/aka.ms/msal-net-token-cache-serialization

Ten interfejs będzie dostępny w wywołaniu zwrotnym TokenCacheNotificationArgs w celu włączenia serializacji/deserializacji pamięci podręcznej.

Określa, które konta Microsoft mogą być używane do logowania się przy użyciu danej aplikacji. Zobacz https://aka.ms/msal-net-application-configuration

Microsoft.Identity.Clientto podstawowa przestrzeń nazw Microsoft Authentication Library (MSAL) dla .NET, która jest dostępna za pośrednictwem Microsoft.Identity.Client pakietu. Zawiera on wszystkie kluczowe składniki, które należy uzyskać token od obsługiwanych dostawców uwierzytelniania.

Instalacja

Za pomocą interfejsu .NET Command-Line (CLI):

dotnet add package Microsoft.Identity.Client

Za pomocą interfejsu wiersza polecenia (CLI) narzędzia NuGet:

nuget install Microsoft.Identity.Client

Za pomocą konsoli Menedżer pakietów:

Install-Package Microsoft.Identity.Client

Korzystanie z Visual Studio:

1. Otwórz Eksplorator rozwiązań.
2. Kliknij prawym przyciskiem myszy projekt w rozwiązaniu.
3. Kliknij pozycję Zarządzaj pakietami NuGet...
4. Kliknij kartę Przeglądaj i wyszukaj ciąg Microsoft.Identity.Client.
5. Microsoft.Identity.Client Kliknij pakiet i kliknij przycisk Zainstaluj.

Dokumentacja

Aby rozpocząć, zapoznaj się z przewodnikiem Microsoft Authentication Library .NET.

Przykłady

Zapoznaj się z przykładami kodu Platforma tożsamości Microsoft i przeglądarką Samples Browser.

Obsługiwane systemy operacyjne

Określa przyczynę pobierania tokenu dostępu od dostawcy tożsamości podczas korzystania z metody AcquireTokenSilent, AcquireTokenForClient lub AcquireTokenOnBehalfOf.

Reprezentuje poziom dziennika w usłudze MSAL. Aby uzyskać szczegółowe informacje, zobacz Rejestrowanie biblioteki MSAL.

Opisuje typy odbiorców telemetrii. AudienceType

Określa źródło tokenów dostępu i identyfikatorów w wyniku uwierzytelniania.

Szczegółowe informacje o przyczynie elementu MsalUiRequiredException, dając wskazówki dotyczące tego, czego użytkownik może oczekiwać po przejściu przez uwierzytelnianie interakcyjne. Aby uzyskać szczegółowe informacje, zobacz Understanding MsalUiRequiredException (Opis elementu MsalUiRequiredException ).

Delegat wywołania zwrotnego, który umożliwia deweloperom aplikacji korzystanie z dzienników i obsługę ich w niestandardowy sposób. To wywołanie zwrotne jest ustawiane przy użyciu polecenia WithLogging(LogCallback, Nullable<LogLevel>, Nullable<Boolean>, Nullable<Boolean>). Jeśli PiiLoggingEnabled jest ustawiona wartość true, podczas rejestrowania wywołania zwrotnego ta metoda będzie otrzymywać komunikaty dwa razy: raz z containsPii parametrem równa false się i komunikat bez danych piI, a drugi raz z containsPii parametrem równym true , a komunikat może zawierać dane osobowe. W niektórych przypadkach (jeśli komunikat nie zawiera danych PII), komunikat będzie taki sam. Aby uzyskać szczegółowe informacje, zobacz https://aka.ms/msal-net-logging

Powiadomienie dotyczące interakcji z określoną pamięcią podręczną tokenu podczas pozyskiwania tokenu. Ten delegat jest używany w szczególności do zapewnienia niestandardowej serializacji pamięci podręcznej tokenu. Zobacz https://aka.ms/aka.ms/msal-net-token-cache-serialization