Zagadnienia związane z przeglądarką systemową Android Xamarin w kontekście korzystania z MSAL.NET

W tym artykule omówiono, co należy wziąć pod uwagę podczas korzystania z przeglądarki systemowej na platformie Xamarin Android z biblioteką Microsoft Authentication Library for .NET (MSAL.NET).

Uwaga

MSAL.NET w wersji 4.61.0 lub nowszej nie zapewnia obsługi Uniwersalnej Platformy Windows (UWP), Xamarin Android i Xamarin iOS. Zalecamy migrację aplikacji platformy Xamarin do nowoczesnych struktur, takich jak MAUI. Przeczytaj więcej o wycofaniu w temacie Ogłaszanie nadchodzącego wycofania MSAL.NET dla platform Xamarin i platformy UWP.

Począwszy od wersji zapoznawczej MSAL.NET 2.4.0, MSAL.NET obsługuje przeglądarki inne niż Chrome. Na urządzeniu z systemem Android nie trzeba już instalować przeglądarki Chrome na potrzeby uwierzytelniania.

Zalecamy używanie przeglądarek obsługujących karty niestandardowe. Oto kilka przykładów tych przeglądarek:

Przeglądarki obsługujące karty niestandardowe Nazwa pakietu
Chrom com.android.chrome
Microsoft Edge com.microsoft.emmx
Firefox org.mozilla.firefox
Ekozja com.ecosia.android powiedział:
Kiwi com.kiwibrowser.browser
Odważny com.brave.browser

Oprócz identyfikowania przeglądarek, które oferują obsługę kart niestandardowych, nasze testy wskazują, że kilka przeglądarek, które nie obsługują kart niestandardowych, również działają na potrzeby uwierzytelniania. Te przeglądarki obejmują Opera, Opera Mini, InBrowser i Maxthon.

Przetestowane urządzenia i przeglądarki

W poniższej tabeli wymieniono urządzenia i przeglądarki, które zostały przetestowane pod kątem zgodności uwierzytelniania.

Urządzenie Przeglądarka Wynik
Huawei/Jeden+ Chrom* Podanie
Huawei/Jeden+ Krawędź* Podanie
Huawei/Jeden+ Przeglądarka Firefox* Podanie
Huawei/Jeden+ Odważny* Podanie
Jeden+ Ekozja* Podanie
Jeden+ Kiwi* Podanie
Huawei/Jeden+ Opera Podanie
Huawei (Huawei) Przeglądarka OperaMini Podanie
Huawei/Jeden+ W przeglądarce Podanie
Jeden+ Maxthon powiedział: Podanie
Huawei/Jeden+ KaczkaKaczka Użytkownik anulował uwierzytelnianie
Huawei/Jeden+ Przeglądarka UC Użytkownik anulował uwierzytelnianie
Jeden+ Delfin Użytkownik anulował uwierzytelnianie
Jeden+ Przeglądarka CM Użytkownik anulował uwierzytelnianie
Huawei/Jeden+ Nic nie zainstalowano Wyjątek Android-Activity-Not-Found

* Obsługuje niestandardowe zakładki

Znane problemy

Jeśli użytkownik nie ma włączonej przeglądarki na urządzeniu, MSAL.NET zgłosi wyjątek AndroidActivityNotFound .

  • Środki zaradcze: poproś użytkownika o włączenie przeglądarki na swoim urządzeniu. Zalecamy przeglądarkę, która obsługuje karty niestandardowe.

Jeśli uwierzytelnianie zakończy się niepowodzeniem (na przykład jeśli uwierzytelnianie zostanie uruchomione z usługą DuckDuckGo), MSAL.NET zwróci wartość AuthenticationCanceled MsalClientException.

  • Główny problem: przeglądarka obsługująca niestandardowe zakładki nie została włączona na urządzeniu. Uwierzytelnianie zostało uruchomione przy użyciu przeglądarki, która nie mogła ukończyć uwierzytelniania.
  • Środki zaradcze: poproś użytkownika o włączenie przeglądarki na swoim urządzeniu. Zalecamy przeglądarkę, która obsługuje karty niestandardowe.

Następne kroki

Aby uzyskać więcej informacji i przykładów kodu, zobacz Wybieranie między osadzoną przeglądarką internetową a przeglądarką systemową na platformie Xamarin Android i osadzonym a systemowym internetowym interfejsem użytkownika.