开发你自己的Android 授权管理器

简介: 转自:http://www.devtf.cn/?p=1121 原文链接 : Write your own Android Authenticator原文作者 : UDI COHEN译文出自 : 开发技术前线 www.devtf.cn。未经允许,不得转载!译者 : kevinhong校对者: desmond1121状态 : 完成 18个月之前

转自:http://www.devtf.cn/?p=1121


18个月之前,我在开发Any.DD同步系统时,打算使用安卓提供的AccountManager API实现认证的相关功能并存储用户秘钥。当我用它来访问Google账号时,一切都非常简单,所以我想Any.DD就用这个API来做吧。确实,使用SyncAdapter进行同步操作进展很顺利,看起来的确是一个完美的方案。但它的问题也随之出现——没有好的文档,开发者社区也没能提供太多可供参考的经验,而我们也没有太多时间来研究这个“无人之地“引发的各种问题。所以当时决定使用其他方案。

但是,今非昔比…

因为一个最近着手的项目,我最近又开始研究相关功能,我突然发现这方面知识的丰富程度有了巨大的提升。包括Android.com上的更好的文档,外面的教程( 教程1 教程2)也逐渐丰富了起来。让我们了解到声名狼藉的AccountManager的神秘之处。坊间传闻的用来创建个人账户的方式,我几乎全都读了。
但是,好像还是缺点什么。

我感觉整个流程并非尽知,有些部分并没有足够清楚。所以我决定用我的方法调查它——就像我平时想要了解一件事情所用的方法一样——用“杰克鲍尔“的方式。我发表了这篇深入调查后的结论性文章,包含了所有这个服务所能提供的功能和一些我觉得重要的需要发掘的细节。后面,我还会贴出一篇关于“SyncAdapter“的文章,所以如果读者感兴趣,我建议读者通过RSS或Twitter来订阅(我的博客)。我还是比较了解这方面的诸多细节,不仅仅是教程提供的简单功能。但如果我遗漏了什么,请在评论中指出。

为什么选择 Account Manager?

为什么?

为什么不是写一个简单的登录表单,实现一个提交按钮,发送(post)所有信息到服务器,然后服务器返回一个鉴权令牌(auth token)?原因在于有很多(与用户鉴权相关的)附加功能和小细节你未必能考虑周全。这些容易被开发者忽略的小细节可能导致用户重新登录,或者被“100000个用户才会出现一次,无所谓“的声音 忽略掉。用户如果在另外一个客户端修改密码该如何处理?auth-token的过期判断呢?是要运行一个没有用户交互UI的后台服务吗?
想要用户登录一次,相关APP就可以自动登录的便利吗?(就像Google的APP那样)

读这篇文章之前或许让你感觉有些东西太复杂,但其实不是。对于绝大多数应用场景来说, Account Manager都简化了登录过程。而且我也给你提供了代码样例,还有什么理由不用呢?

好吧,让我们来看看(使用 AccountManager)都有哪些好处:
好处:标准的用户鉴权方式;为开发者简化了登录的流程;处理访问拒绝的场景;可以为一个账户处理不同类型的访问令牌(如:只读、全权限);轻松的在不同程序间共享令牌;有如Sync Adapter这样的后台处理的良好支持;并且,在手机的Setting界面中有一个很酷的入口:

alt text

看,妈妈,设置屏幕上有我的”名纸”!

缺陷:需要学习它!但是,嗨,这不就是你读此文的目的吗?

要实现这些功能,需要下面几步:
1. 创建Authenticator,这是所有操作的核心
2. 创建若干Activity,用户可以在其中输入验证需要的信息
3. 创建Service,通过Service我们可以与Authenticator进行交互

首先,(来看)一些概念。

Authenti..啥?

授权令牌 (Authentication Token,auth-token) – 是由服务器提供的一个临时的访问令牌。所有需要识别用户的请求,在发送到服务器时都要带着这个令牌。在这篇文章中,我们使用OAuth2,它也是现在最为流行的方法。

授权服务器 – 用来管理所有用户的服务器。它将会为登录到服务器的用户生成授权令牌(auth-token),并且校验所有的用户请求(是否合法)。授权令牌有时间限制,过期后将时效。

AccountManager – 管理设备上的所有账户,也是这项功能的核心。App从AccountManager获得auth-token,它也将决定是否该打开登录、创建用户的Activity,或者从之前的请求中返回一个已经存储好的auth-token。AccountManager了解不同场景下该调用何种操作。

AccountAuthenticator – 是一个为具体账户类型提供鉴权处理过程的组件。AccountManager查找合适的AccountAuthenticator,与其通信,并根据账户类型执行所有动作。AccountAuthenticator知道哪个Activity用来让用户输入登录信息,也知道服务器上次返回的auth-token在哪里存储。在一个账户类型下,多个不同的服务也会共用同一个AccountAuthenticator。比如Google的AccountAuthenticator为GMail提供认证服务,也为其他的Google程序,如:Google Calendar和Google Drive提供授权服务。

AccountAuthenticatorActivity – “登录/创建用户“Activity的基类,当用户需要认证的时候,authenticator调用会这个Activity。这个Activity负责用户登录或用户创建过程,并将auth-token返回给
authenticator

当你的App需要auth-token时,只需调用AccountManager#getAuthToken()AccountManager将负责一切必须的步骤直到给你拿到auth-token。Google提供了一个流程图展现了整个过程:

<img src="http://blog.udinic.com/assets/media/images/2013-04-24-write-your-own-android-authenticator/oauth_dance1.png" alt="Google-<code>AccountManager</code>-Process-Daigram” title=”Title” /></p><p>这图看起来有点繁琐,但其实它很简单。我将通过用户首次在设备上登陆的场景来进行解释。</p><p>用户首次登陆时</p><blockquote><ul><li>App向<code>AccountManager</code>请求auth-token。</li><li><code>AccountManager</code> 询问与其关联的 <code>AccountAuthenticator</code> 是否保存了有效的token</li><li>由于目前还没有(用户还没有登陆嘛),他将调用 <code>AccountAuthenticatorActivity</code>来让用户登录。</li><li>用户正常登陆,服务器返回了auth-token。</li><li><code>AccountManager</code>存储了auth-token以备将来使用。</li><li>App获得了它想要的auth-token</li></ul></blockquote><p>皆大欢喜!</p><p>在用户已经登陆的情况下,上述的第二步将直接返回auth-token。你可以在<a href=" http:="" developer.android.com="" training="" id-auth="" authenticate.html"="" style="box-sizing: border-box; border: 0px; vertical-align: middle; max-width: 100%; height: auto;">这里获得更多如何使用OAuth2进行认证的文章。

现在,我们已经了解了基础知识。现在来看看如何建立一个自有账户类型的authenticator。

建立我们自己的Authenticator

如前文所述, Account Authenticator 由AccountManager管理并满足账户相关的所有任务:存储auth-token;展现账户登录屏幕;处理服务器的用户登录。

建立我们自己的Authenticator需要继承AbstractAccountAuthenticator并实现一些方法。我们现在来关注其中两个主要方法:

addAccount

当用户打算登录并在一个设备上新建账户时,会调用这个方法。

我们需要返回一个Bundle,其中包含一个会启动我们自己的_AccountAuthenticatorActivity(稍后解释)的Intent,这个方法在app通过调用AccountManager#addAccount() (需要特殊权限)时被调用。或者在手机设置 中,用户点击“添加新用户“时被调用,即:

SettingScreen

例如:

getAuthToken

如上面的流程图所示,getAuthToken可以获取存储在设备上的已经登陆成功用户的auth-token。如果auth-token不存在,将会提示用户登录。在成功登陆之后,请求auth-token的app会“长等待“此token。为了避免此情况,我们应该通过AccountManager#peekAuthToken()来检查AccountManager是否已经存在一个有效的auth-token。如果没有,我们应该返回与addAccount()相同的结果。

如果我们通过此方法获得的auth-token已经无效了,比如过期了或者用户从其他客户端修改了密码。我们应该调用AccountManager#invalidateAuthToken()使当前存储在AccountManager的auth-token失效,并调用getAuthToken()再次请求auth-token。再次调用 getAuthToken()时会尝试使用之前存储的密码进行登陆,如果失败,用户将必须再次输入登陆信息。

所以,用户要在哪输入验证信息?这就是AccountAuthenticatorActivity了。

创建Activity

AccountAuthenticatorActivity是整个过程中唯一直接与用户交互的Activity

Authenticator首先调用这个Activity,此Activity将展现一个用户登录表单,发送到服务器鉴权用户,并将结果传给authenticator。我们继承AccountAuthenticatorActivity,不仅要实现常规Activity的功能,还要实现setAccountAuthenticatorResult()方法。此方法负责将鉴权过程的结果发送给Authenticator。此方法也为我们省掉了与Authenticator直接交互。

我在我的Activity中构建了一个简单的用户名/密码表单。你可以使用Android官方网站上建议使用的登录Activity模版,提交时,我进行了以下操作:

sServerAuthenticate是与服务器进行认证的接口,我实现了了其中例如userSignIn(用户登录)和userSignUp(用户注册)的方法,这些方法会在登录成功时获得服务器返回的auth-token。

mAuthTokenType是我从服务器请求的令牌的类型。我可以让服务器给我不同的令牌例如只读或全访问,或者在相同的账户下的不同服务。一个好的列子是Google‘账号,它的令牌类型包括:“_Manage your calendars”(管理日历), “Manage your _tasks”(管理任务), “View your calendars”(查看日历)等等。在这个列子中,我不会为不同类型的令牌区分不同的操作。

完成后,调用 finishLogin():

通过上面的方法我们获得了一个全新的auth-token,具体细节如下:

  1. 在这个案例中,AccountManager已经存在了一条记录,它是一个已经失效了的auth-token。新的auth-token会替代原有的,此时你不需要做任何操作。但如果用户的密码已经修改,你需要向AccountManager更新用户密码,就像上面代码中实现的那样。

  2. 添加了一个新的账户到设备 —— 这是有技巧的部分。当新账户创建时,auth-token并没有立刻保存到AccountManager,你需要显示的设置auth-token。这也是我在添加完账户之后,又明确的设置auth-token的原因。如果设置失败了,AccountManager将会再到服务器执行获取auth-token的过程,这时getAuthToken会被调用,并再次进行用户鉴权。

注意:addAccountExplicitly() 的第三个参数,是用户数据Bundle,它可以用在AccountManager保存其他认证信息的同时存储一些自定义信息,比如你的服务的API Key。当然这些信息也可以通过setUserData()设置。

在Activity完成登陆之后,我们已经为AccountManager建立了我们的账户。最后调用setAccountAuthenticatorResult()将信息传回给Authenticator

现在一切流程准备就绪,那谁来启动这个过程呢?(其他应用)如何来访问它?我们需要让我们的Authenticator对其他想使用它的应用可用,因此我们需要让Authenticator在后台运行(还可以调用登录屏幕),使用Service是一个明显的选择。

创建Service

Service非常简单。

我们要做的,是让其他的进程与我们的服务绑定,并于Authenticator交互。幸运的是,Authenticator的父类AbstractAccountAuthenticator提供了getIBinder() 方法,该方法返回了一个IBInder实现。我们的服务需要在onBind()方法中调用它。这个基本的实现保证了其他进程请求Authenticator时进行适当的操作(原文为:“调用合适的方法“。译者注)。如果读者想了解其中的细节,可以看看Transport,一个AbstractAccountAuthenticator的内部类,并了解关于AIDL——进程间通信的一些知识。

现在我们的服务是这样的:

..and on the manifest we need to add our service with the

在manifest文件中,需要对Service声明

很简单,是吧?
作为资源引用的authenticator.xml用来定义Authenticator用到的一些属性。

让我们来解释一下:

  • accountType(账户类型) 是一个独一无二的名字,用来识别我们的账户类别。当其他app要通过我们的应用进行鉴权操作时。它需要明确知道这个名字来使用AccountManager

  • icon and smallIcon(图标和小图标) 是在设备的Setting画面中,账户条目显示的图标。在账户确认画面(稍后会解释),它也会出现。

  • label(标签) 是在设备Setting画面中显示的代表我们账户的的字符串。

  • accountPreferences(账户偏好) 是一个偏好XML的引用。它将在通过设备的Setting画面中访问账户偏好时展现,它允许用户更好的控制庄户。作为例子,你可以看看Google及Dropbox的账户偏好画面,里面包含了一些可供调整的项。我的例子如下:

SettingScreen

你需要了解的其他特性

在我调查的过程中,我发现了一些有意思的场景。为了让你使用相关API时不致想破头,我把它分享出来。

  1. 检查账户的有效性 – 如果你打算为一个账户获取auth-token并自己存储起来,你应该先调用AccountManager#getAccounts*()方法来看看该账户是否存在。这里引用AccountManager的官方文档

“为一个设备上不存在的账户请求auth-token,将会导致未定义的失败。“

在我这,这个“未定义的失败“虽热调用了登录画面,但当我输入认证信息后却没有任何反应,所以你得注意一下。

  1. 先进先服务 – 如果你复制了authenticator的相关代码到你的两个应用,二者具备相同的逻辑,但在每个应用中修改了自己的登录画面。在这种情况下,无论哪个应用需要请求auth-token,都会调用先安装的app的authenticator。如果你卸载了第一个应用,第二个应用的authenticator才会起作用(因为它是唯一有个了)。克服这个问题的一个技巧,是将不同的登陆页放到同一个authenticator中,并在调用addAccount() 时,把各自的设计需求通过addAccountOptions 的参数传过去。

  2. 为了安全,小心共享 – 如果你打算获取其他应用的authenticator生成的auth-token,并且该应用与你的应用具有不同的签名秘钥,用户必须显示的同意这个操作。用户将会看到如下画面:

SettingScreen

“Full access to..”字符串是通过我们的Authenticator_getAuthTokenLabel()方法获得。你可以为每一个auth-token类型指定一个标签,以便在类似的场景下对用户更加友好。

1, 存储密码 – AccountManager并没有使用加密方法存储密码。所有的密码都明文存储。你不能对其他的Authenticator调用peekAuthToken() 方法(获得其他Authenticator的auth-token)(会出现“caller uid X is different than the authenticator’s uid”错误),但root权限或adb命令却可以得到。在示例代码中,存储明文密码是为了让已经过期的token自动登录更方便。在大多数场合中,我选择更加安全的方式,但有的时候,为用户的错误牺牲便利性是不值得的——如果有人获得了root权限并能在设备上执行adb命令,那与获得用户的“最高分“比起来,他可以做到更大的危害。

接下来?

现在,你已经对这个很棒的服务比较熟悉了。你可以在Google Play上下载我开发的样例程序。它会在你的设备创建“Udinic account”类型的账户,验证则会通过Parse.com账户来进行。样例应用提供了下面几项功能:

SettingScreen

getAuthToken按钮首先会查询设备上是否有“Udinic”类型的账户。如果有,它通过调用AccountManager#getAuthToken()来返回token。如果有多个token,它将弹出一个对话框让用户选择打算使用哪一个。

getAuthTokenByFeatures 调用了AccountManager提供的一个很棒很方便的同名方法,它会为你完成所有的工作。它也会查询AccountManager中是否包含目标类型“Udinic”。它的行为遵循以下步骤:

  • 没有账户时: 调用_ addAccount()_让用户创建一个账户。此后,自动调用getAuthToken()获取token。
  • 存在账户时:获取auth-token。
  • 有两个账户或更多时:创建一个账户选择对话框,并返回用户所选账户的token。

如果你打算让token失效,你可以用invalidateAuthToken按钮。注意:Udinic authenticator知道如何恢复失效token,就像之前示例代码中所展示的那样,通过getAuthToken()方法。那意味着,在让token失效后,getAuthToken按钮仍然可以返回token,但只在它向服务器请求成功之后。你可以在LogCat中通过查看网络状态来确认。删除帐户只能通过设备的Setting菜单。

你可以在Github上下载相关源代码。里面包含了2个样例应用,所以你可以尝试下2个应用之间共享相同的Authenticator。比如:使用不同的签名密钥打包程序,一个应用请求由另一个应用创建的auth-token。你也可以尝试创建一个authenticator的apklib(apk库),并在不同的应用中重用它。如果你有意见或建议,别犹豫直接在文章后面指出或在Github上提出PR吧。


目录
相关文章
|
8天前
|
编解码 Java Android开发
通义灵码:在安卓开发中提升工作效率的真实应用案例
本文介绍了通义灵码在安卓开发中的应用。作为一名97年的聋人开发者,我在2024年Google Gemma竞赛中获得了冠军,拿下了很多项目竞赛奖励,通义灵码成为我的得力助手。文章详细展示了如何安装通义灵码插件,并通过多个实例说明其在适配国际语言、多种分辨率、业务逻辑开发和编程语言转换等方面的应用,显著提高了开发效率和准确性。
|
7天前
|
Android开发 开发者 UED
安卓开发中自定义View的实现与性能优化
【10月更文挑战第28天】在安卓开发领域,自定义View是提升应用界面独特性和用户体验的重要手段。本文将深入探讨如何高效地创建和管理自定义View,以及如何通过代码和性能调优来确保流畅的交互体验。我们将一起学习自定义View的生命周期、绘图基础和事件处理,进而探索内存和布局优化技巧,最终实现既美观又高效的安卓界面。
19 5
|
5天前
|
JSON Java Android开发
探索安卓开发之旅:打造你的第一个天气应用
【10月更文挑战第30天】在这个数字时代,掌握移动应用开发技能无疑是进入IT行业的敲门砖。本文将引导你开启安卓开发的奇妙之旅,通过构建一个简易的天气应用来实践你的编程技能。无论你是初学者还是有一定经验的开发者,这篇文章都将成为你宝贵的学习资源。我们将一步步地深入到安卓开发的世界中,从搭建开发环境到实现核心功能,每个环节都充满了发现和创造的乐趣。让我们开始吧,一起在代码的海洋中航行!
|
6天前
|
缓存 数据库 Android开发
安卓开发中的性能优化技巧
【10月更文挑战第29天】在移动应用的海洋中,性能是船只能否破浪前行的关键。本文将深入探讨安卓开发中的性能优化策略,从代码层面到系统层面,揭示如何让应用运行得更快、更流畅。我们将以实际案例和最佳实践为灯塔,引领开发者避开性能瓶颈的暗礁。
22 3
|
9天前
|
存储 IDE 开发工具
探索Android开发之旅:从新手到专家
【10月更文挑战第26天】在这篇文章中,我们将一起踏上一段激动人心的旅程,探索如何在Android平台上从零开始,最终成为一名熟练的开发者。通过简单易懂的语言和实际代码示例,本文将引导你了解Android开发的基础知识、关键概念以及如何实现一个基本的应用程序。无论你是编程新手还是希望扩展你的技术栈,这篇文章都将为你提供价值和启发。让我们开始吧!
|
15天前
|
Java API Android开发
安卓应用程序开发的新手指南:从零开始构建你的第一个应用
【10月更文挑战第20天】在这个数字技术不断进步的时代,掌握移动应用开发技能无疑打开了一扇通往创新世界的大门。对于初学者来说,了解并学习如何从无到有构建一个安卓应用是至关重要的第一步。本文将为你提供一份详尽的入门指南,帮助你理解安卓开发的基础知识,并通过实际示例引导你完成第一个简单的应用项目。无论你是编程新手还是希望扩展你的技能集,这份指南都将是你宝贵的资源。
43 5
|
13天前
|
设计模式 IDE Java
探索安卓开发:从新手到专家的旅程
【10月更文挑战第22天】 在数字时代的浪潮中,移动应用开发如同一座金矿,吸引着无数探险者。本文将作为你的指南针,指引你进入安卓开发的广阔天地。我们将一起揭开安卓平台的神秘面纱,从搭建开发环境到掌握核心概念,再到深入理解安卓架构。无论你是初涉编程的新手,还是渴望进阶的开发者,这段旅程都将为你带来宝贵的知识和经验的财富。让我们开始吧!
|
3天前
|
移动开发 Java Android开发
探索Android与iOS开发的差异性与互联性
【10月更文挑战第32天】在移动开发的大潮中,Android和iOS两大平台各领风骚。本文将深入浅出地探讨这两个平台的开发差异,并通过实际代码示例,展示如何在各自平台上实现相似的功能。我们将从开发环境、编程语言、用户界面设计、性能优化等多个角度进行对比分析,旨在为开发者提供跨平台开发的实用指南。
22 0
|
13天前
|
搜索推荐 Android开发 UED
安卓开发中的自定义视图:打造个性化用户界面
【10月更文挑战第22天】在安卓应用的海洋中,如何让你的应用脱颖而出?一个独特且直观的用户界面(UI)至关重要。本文将引导你通过自定义视图来打造个性化的用户体验,从基础的视图绘制到触摸事件的处理,我们将一步步深入探讨。准备好了吗?让我们开始吧!
|
14天前
|
Android开发
我是一位Android工程师,用通义灵码的AS插件做开发工作助手,对比之前没有灵码,现在提效了60%
我是一位Android工程师,用通义灵码的AS插件做开发工作助手,对比之前没有灵码,现在提效了60%
29 0