OAuth 2 开发者指南

介绍


这是OAuth2用户指南,OAuth1与其有很大差异请查看OAuth1资料

本指南分为两个部分,第一部分讲OAuth2 provider,第二部分讲OAuth2 client。无论是provider还是client最好的示例代码请参考integration testssample apps

OAuth 2.0 Provider


OAuth2 provider机制负责暴露被保护的资源。其配置需保证clients可以独立或代表用户访问受保护资源。OAuth provider通过管理和验证OAuth2 token访问被保护资源。必要时,provider须提供界面给用户确认授权给client访问受保护资源(比如:确认授权页面)。

OAuth 2.0 Provider 实现


provider的角色在OAuth2中被分为授权服务(Authorization Service)和资源服务(Resource Service),两者有时被放在同一个应用,使用spring security oauth可以将二者分开放在两个不同的应用,而且可以同时拥有多个资源服务(Resource Service)共享同一个授权服务(Authorization Service)。Spring MVC Controller的端点处理token请求,标准的Spring Security 过滤器处理访问受保护资源请求。下面的端点在Spring Security过滤器链中请求以实现OAuth2 Provider:

授权端点(AuthorizationEndpoint)用于授权。默认URL:/oauth/authorize.

Token端点(TokenEndpoint) 用于获取access tokens。默认URL: /oauth/token.

下面的过滤器是实现一个OAuth2资源服务(Resrouce Server)必须要有的:

OAuth2授权处理过滤器(OAuth2AuthenticationProcessingFilter) 用于加载附带验证过的访问token请求的验证信息(Authentication)。

对于OAuth2 Provider所有功能特性,可以通过特定的Spring OAuth2 配置适配器进行配置。也可以通过XML命名空间方式进行配置。

授权服务配置


配置授权服务时,必须考虑客户端(Client)用于从最终用户那里获取Access Token的授予类型(Grant Type)(如:授权码 - authorization code, 用户凭证 - user credentials, 更新token - refresh token)。授权服务配置用于提供客户端用户详情服务和token服务的实现,并用于开启和关闭机制的全局部分。注意,尽管如此,所有客户端依然可以特殊配置许可以使用特定的授权机制和访问准许。例如:仅仅配置了Provider支持"client credentials" 授予类型, 并不意味着特定的客户端也要通过该授予类型授权。

@EnableAuthorizationServer注解和实现了AuthorizationServerConfigurer的@Bean一起用于配置授权服务。

ClientDetailsServiceConfigurer: 定义客户端明细服务,客户端明细可以初始化,也可以引用存在的库。

AuthorizationServerSecurityConfigurer: 定义token端点安全限制。

AuthorizationServerEndpointsConfigurer: 定义授权和token端点以及token 服务。

Provider配置一个重要的方面是一个授权码供给一个客户端,授权码是由客户端通过使终端用户跳转到一个用户可输入其身份验证信息的授权页面,由Provider授权服务携带授权码跳转回客户端的结果。关于这些的实例请参考关于OAuth 2的详细说明。

配置客户端明细


ClientDetailsServiceConfigurer可以用来定义内存或jdbc实现的客户端明细服务。客户端重要的配置属性有:

clientId: (必要) 客户端ID,唯一标识。

secret: (required for trusted clients) 客户端密码。

scope: 客户端限定范围。如果未定义则不限制。

authorizedGrantTypes: 准许客户端使用的授权类型,默认为空。

authorities: 授予客户端的授权(通常就是Spring Security的授权)。

客户端明细可以通过访问底层存储或者通过ClientDetailsManager接口在运行应用中进行变更。

管理Tokens


AuthorizationServerTokenServices接口定义了管理Tokens的所有必要操作,注意一下几点:

当一个access token被创建,其验证信息必须被保存以供访问资源时引用。

access token用于在加载曾授权创建它的验证信息。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 203,179评论 5 476
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,229评论 2 380
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 150,032评论 0 336
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,533评论 1 273
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,531评论 5 365
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,539评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,916评论 3 395
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,574评论 0 256
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,813评论 1 296
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,568评论 2 320
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,654评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,354评论 4 318
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,937评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,918评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,152评论 1 259
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 42,852评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,378评论 2 342

推荐阅读更多精彩内容