共计 2586 个字符,预计需要花费 7 分钟才能阅读完成。
oAuth 机制对于网站间的授权管理是很容易实现的,设置好 app 回调端口,当数据服务提供方拿到其用户授权,则返回授权码发送到回调端口。上一篇文章介绍了如何授权 Forge app 访问 Autodesk 云应用数据,即,获取三条腿的 token。
但移动端的原生 app,授权码返回到发起请求 app 的某个 Activity,可如何得知是哪个 Activity 并且跳转到此 Activity?这时就要用到 URL Scheme。iOS 和 Android 都提供了这样的机制。它实现了页面内跳转协议,通过定义自己的 scheme 协议,非常方便跳转到 app 中的各个 Activity。也让不同 app 可以唤起其它 app 的 Activity。当然,前提 app 已经安装到系统。这位大咖对此话题做了专业的讲解,推荐大家先阅读:https://www.jianshu.com/p/7b0…
我的同事 Bryan 搭建了一个框架,演示 Android app 集成 Forge oAuth,拿到三条腿 token,并调用了用户信息(Profile)API,列出登录用户的在 Forge 数据管理中的基本信息。该框架很好的展示了使用 URL Scheme 整个过程。https://github.com/dukedhx/oa…
我借此学习了有关内容。另外,基于此代码,略微改造,添加流程展示获取 Autodesk 云应用的 Hub,Project,Folder 和 File,为进一步的综合应用 app 做一些铺垫。https://github.com/xiaodongli…
oAuth 相关的几个步骤:
1. 定义监听 oAuth 回传的 Activity 属性
<activity android:name=”.MainActivity”>
<intent-filter>
<action android:name=”android.intent.action.MAIN”/>
<category android:name=”android.intent.category.LAUNCHER”/>
</intent-filter>
<intent-filter>
<data android:scheme=”@string/FORGE_CALLBACK_SCHEME” android:host=”@string/FORGE_CALLBACK_HOST”/>
<action android:name=”android.intent.action.VIEW”/>
<category android:name=”android.intent.category.DEFAULT”/>
<category android:name=”android.intent.category.BROWSABLE”/>
</intent-filter>
</activity>
其中,FORGE_CALLBACK_SCHEME 和 FORGE_CALLBACK_HOST 定义为:
<string name=”FORGE_CALLBACK_SCHEME”>lxdapp</string>
<string name=”FORGE_CALLBACK_HOST”>mytest3legged</string>
同样的, URL Scheme 必须和 Forge app 注册的时候填写的 callback URL 要一致。
2. 登录事件将创建一个 Intent.ACTION_VIEW,用以启动网页,URL 拼接了 Forge app 的 client id,授权方式(response_type=code),回传地址和授权的权限范围 跳转到 Autodesk 登录过程,等待客户授权。
public void onLoginClick(View v) {
Intent i = new Intent(Intent.ACTION_VIEW);
Resources resources = getResources();
i.setData(Uri.parse(getResources().getString(R.string.FORGE_AUTHORIZATION_URL) + “?response_type=code&redirect_uri=” + this.getCallbackUrl() + “&scope=” + resources.getString(R.string.FORGE_SCOPE) + “&client_id=” + resources.getString(R.string.FORGE_CLIENT_ID)));
startActivity(i);
}
3. 用户授权后,将对 URLScheme 地址回传,也就是发起请求的 Activity。Activity 的 OnStart 拿到回传信息。由于没有设定 android:mimetype, 则任何数据类型都可接收。但我们需要只是授权码,在回传请求的 URL 参数中。
@Override
protected void onStart() {
super.onStart();
Intent intent = getIntent();
Uri data = intent == null ? null : intent.getData();
// 从回传请求中拿到授权码
String authorizationCode = data == null ? null : data.getQueryParameter(“code”);
if (authorizationCode != null && !authorizationCode.isEmpty()) {
……
4. 接下来的过程就和常规的网页应用类似了,依授权码得到最终的 token。
5. 该样例调用 Forge 服务采取 okhttp3, 推荐参考下文的详细讲解:https://www.jianshu.com/p/da4…
注:
Activity 的 URLScheme 是可能同名的,而且如何保证应用之间跳转和传参的目标正确性,这方面我还在研究中。
本例为方便计,将 Forge Client Secret 也存在了 app 之中。我想安全的方式是由 app 服务器端进行 secret 的管理,当原生 app 拿到授权码,通过它来向 app 服务器端发起请求,由 app 服务器来获取 Forge token,再传回原生 app。
扩展的部分(Hub,Project,Folder 和 File)只是简单的替换 ListView 的内容,尚未对页面回退做处理。