学徒浅析Android——基于Microsoft的OAUTH2.0认证（二）

MSAL库的引用和定制

 

本章围绕Microsoft Authentication Library讲述两件事：1、如何引用MSAL库；2、如何对MSAL库进行二次开发。

其他相关文章：

基于Microsoft的OAUTH2.0认证（一）：基本概念梳理

基于Microsoft的OAUTH2.0认证（三）：MSAL API和Microsoft API的使用

基于Microsoft的OAUTH2.0认证（四）：常见错误归纳

 

1. msal库的引用

性急的同行们可以直接参考Microsoft提供的示例项目：

https://github.com/Azure-Samples/ms-identity-android-java/archive/master.zip

以及快速入门手册：

https://docs.microsoft.com/zh-cn/azure/active-directory/develop/quickstart-v2-android#how-the-sample-works

性慢的听我娓娓道来，MSAL库引用分为两部分：第一部分在AzureAD上配置应用信息，第二部分：在项目中配置MSAL相关声明。

1.1在AzureAD上配置应用信息

1、首先需要拥有一个Microsoft账号。可以是个人账号也可以是企业账号，如果没有也可以在登录AzureAD网站时实时注册。

2、使用IE浏览器打开AzureAD首页（https://portal.azure.com/#home），并用已有的Microsoft账号进行登录，在订阅服务列表中查找应用注册服务。如果未看到应用注册服务，可以直接在搜索栏中查询应用注册，就可以进入到注册应用管理页面。这里需要注意的是一定要用IE浏览器打开，即使是Edge浏览器也存在页面按钮显示不全的情况，会妨碍后续操作。

3、新增目标应用，按照注册要求填写相关的数据。主要是名称，受支持的账户类型。

名称除了标记当前应用的别名外，还会在发起认证请求时展示在权限授予换面中，并且可以随时更改。

受支持的账户类型需要根据你的业务需求决定，当然如果不确定的话，选择最长的第三项是妥妥没问题的。

重定向可以选择不设置，添加平台认证时会自动生成所需的重定向url。

4、点击注册后就可以看到一个绑定应用管理页面，建议此时将网页语言换成英语，这样有利于你去理解Microsoft其它说明文档中提到的术语，比如目录（租户）ID就是（tenant ID）

5、选择品牌打造，可以设置权限认证页面时展示的应用名称（默认用注册时填写的别名）、图标（默认不展示图标）、服务条款声明网址，隐私声明网址等。大部分场景下只需要修改名称和图标就可以，如果需要自定义域名，选择更新域名，按提示配置即可。注意点：做完操作后记得点击保存，否则配置不会生效。

6，选择身份认证获取msal配置清单。这里认证的是你注册的应用信息和你项目的关系，决定着你能否正常使用msal库。从平台配置中选择添加平台，你能看到Microsoft一共提供了5种平台类型，如下如所示：