Рекомендации по использованию MSAL.NET в системном браузере Xamarin Android

В этой статье рассматриваются вопросы, которые следует учитывать при использовании системного браузера Xamarin Android с библиотекой проверки подлинности Майкрософт для .NET (MSAL.NET).

Начиная с MSAL.NET 2.4.0 Preview, эта библиотека поддерживает не только Chrome, но и другие браузеры. Теперь не требуется устанавливать Chrome для проверки подлинности на устройстве Android.

Мы рекомендуем использовать браузеры, которые поддерживают настраиваемые вкладки. Вот несколько примеров таких браузеров:

Браузеры с поддержкой настраиваемых вкладок	Имя пакета
Chrome	com.android.chrome
Microsoft Edge	com.microsoft.emmx
Firefox	org.mozilla.firefox
Ecosia	com.ecosia.android
Kiwi	com.kiwibrowser.browser
Brave	com.brave.browser

Результаты нашего тестирования показали, что помимо браузеров с поддержкой настраиваемых вкладок с проверкой подлинности могут работать и некоторые другие браузеры. К ним относятся Opera, Opera Mini, InBrowser и Maxthon.

Протестированные устройства и браузеры

В следующей таблице перечислены устройства и браузеры, для которых подтверждена совместимость с проверкой подлинности.

Устройство	Браузер	Результат
Huawei/One+	Chrome*	Пройдено
Huawei/One+	Edge*	Пройдено
Huawei/One+	Firefox*	Пройдено
Huawei/One+	Brave*	Пройдено
One+	Ecosia*	Пройдено
One+	Kiwi*	Пройдено
Huawei/One+	Opera	Пройдено
Huawei	OperaMini	Пройдено
Huawei/One+	InBrowser	Пройдено
One+	Maxthon	Пройдено
Huawei/One+	DuckDuckGo	Пользователь отменил проверку подлинности.
Huawei/One+	UC Browser	Пользователь отменил проверку подлинности.
One+	Dolphin	Пользователь отменил проверку подлинности.
One+	CM Browser	Пользователь отменил проверку подлинности.
Huawei/One+	Не установлено	Исключение AndroidActivityNotFound

* Поддерживает настраиваемые вкладки

Известные проблемы

Если на устройстве не включен ни один браузер, MSAL.NET создаст исключение AndroidActivityNotFound.

• Решение: предложите пользователю включить браузер на этом устройстве. Порекомендуйте выбрать браузер, поддерживающий настраиваемые вкладки.

Если проверка подлинности завершается сбоем (например, при запуске с сайта DuckDuckGo), MSAL.NET создаст исключение AuthenticationCanceled MsalClientException.

• Причина проблемы: на устройстве не включен ни один браузер, поддерживающий настраиваемые вкладки. Проверка подлинности запущена в браузере, который не может ее выполнить.
• Решение: предложите пользователю включить браузер на этом устройстве. Порекомендуйте выбрать браузер, поддерживающий настраиваемые вкладки.

Следующие шаги

Дополнительные сведения и примеры кода см. в разделах Выбор между встроенным веб-браузером и системным браузером Xamarin Android или Встроенный и системный веб-интерфейс.