MSAL.NET 사용을 위한 Xamarin Android 시스템 브라우저 고려 사항
이 문서에서는 .NET용 Microsoft 인증 라이브러리(MSAL.NET)에서 Xamarin Android의 시스템 브라우저를 사용하는 경우 고려해야 할 사항을 설명합니다.
참고 항목
MSAL.NET 버전 4.61.0 이상에서는 UWP(유니버설 Windows 플랫폼), Xamarin Android 및 Xamarin iOS를 지원하지 않습니다. Xamarin 애플리케이션을 MAUI와 같은 최신 프레임워크로 마이그레이션하는 것이 좋습니다. Xamarin 및 UWP용 MSAL.NET의 향후 사용 중단 발표에서 사용 중단에 대해 자세히 알아보세요.
MSAL.NET 2.4.0 미리 보기부터, MSAL.NET은 Chrome 이외의 브라우저를 지원합니다. 더 이상 인증을 위해 Android 디바이스에 Chrome을 설치할 필요가 없습니다.
사용자 지정 탭을 지원하는 브라우저를 사용하는 것이 좋습니다. 해당 브라우저의 몇 가지 예는 다음과 같습니다.
| 사용자 지정 탭 지원이 있는 브라우저 | 패키지 이름 |
|---|---|
| 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 브라우저 | 사용자가 인증을 취소함 |
| One+ | Dolphin | 사용자가 인증을 취소함 |
| One+ | CM Browser | 사용자가 인증을 취소함 |
| Huawei/One+ | 설치되지 않음 | AndroidActivityNotFound 예외 |
* 사용자 지정 탭 지원
알려진 문제
사용자가 디바이스에서 브라우저를 사용하도록 설정하지 않은 경우 MSAL.NET은 AndroidActivityNotFound 예외를 throw합니다.
- 완화: 디바이스에서 브라우저를 사용하도록 설정하도록 사용자에게 요청합니다. 사용자 지정 탭을 지원하는 브라우저를 권장합니다.
인증이 실패하는 경우(예: 인증이 DuckDuckGo를 사용하여 시작되는 경우) MSAL.NET은 AuthenticationCanceled MsalClientException을 반환합니다.
- 근본 문제: 사용자 지정 탭을 지원하는 브라우저가 디바이스에서 사용하도록 설정되지 않았습니다. 인증을 완료할 수 없는 브라우저를 사용하여 인증이 시작되었습니다.
- 완화: 디바이스에서 브라우저를 사용하도록 설정하도록 사용자에게 요청합니다. 사용자 지정 탭을 지원하는 브라우저를 권장합니다.
다음 단계
자세한 내용과 코드 예제는 포함된 웹 브라우저와 Xamarin Android의 시스템 브라우저 중에 선택 및 포함 및 시스템 웹 UI를 참조하세요.