本文目录一览:
- 1、二oauthServer自定义配置-密码模式
- 2、5 分钟部署一个 OAuth2 服务并对接 Shibboleth-IdP 3.4.6
- 3、OAuth2 认证流程
- 4、java oauth2 server 实现哪个好
- 5、OAuth 2.0 授权认证详解
二oauthServer自定义配置-密码模式
1.1默认配置即可支持
1.2获取token访问方式:
2.1使用默认的配置(客户端和用户都是默认的)
3.2使用密码方式获取token
3.3客户端Basic认证
3.4请求头加密方式:
3.1自定义配置
3.1客户端配置
(1)客户端配置可以用yml配置,也可以继承AuthorizationServerConfigurer配置客户端信息
(2)注意配置客户端redirect URI,不能用yml配置,只能用InMemoryClientDetailsService 或 JdbcClientDetailsService方式
3.2 自定义用户信息配置(覆盖默认配置)
3.3暴漏自定义的UserDetailService类
3.4注意:如果你继承AuthorizationServerConfigurerAdapter自定义覆盖默认
需要暴漏AuthenticationManager (密码模式必需)
3.5AuthenticationManager 注意点:
(1)密码授权是基于用户的,客户端授权是基于Client信息的,RefreshToken模式是基于refresh-token的
(2)除了AuthenticationManager涉及到UserDetailService,其他类似授权码模式和简化模式在登陆的时候需要认证用户的时候也涉及到UserDetailService
(3)客户端通过密码模式认证的时候才需要AuthenticationManager
3.6你也可以自定义实现AuthenticationManager
3.7自定义配置AuthenticationManager注意:不然容易出现注入不了的bug
(1)在一些老的案例中AuthenticationManager配置需要你创建AuthorizationServerConfigurerAdapter和WebSecurityConfigurerAdapter特定配置 -phpoauth2server
4.1密码模式请求参数
4.2测试
5 分钟部署一个 OAuth2 服务并对接 Shibboleth-IdP 3.4.6
这还是一个标题党。
OAuth2 现在已经是开放授权协议的事实标准,你可以看到几乎所有的 xxx 开放平台均采取的 OAuth2 协议来进行授权。而在 Authorization Code 模式的基础上结合 JWT ,标准化的 userinfo endpoint 和服务发现,就成了 OpenID-Connect。当然即便不加上这些限定,OAuth2 在 Authorization Code 模式下,也通常被用作统一身份认证的解决方案提供给用户。而由于 OAuth2 与 CAS 不同,缺乏 Apereo CAS 这样的重量级产品来对标(话说回来,Apereo CAS 现在自己就支持 OAuth2 来着)。于是市场上的 OAuth2 实现可谓群魔乱舞,槽点一时难以穷尽。-phpoauth2server
个人建议,在选取 OAuth2 产品时,务必通过 oauth playground 进行测试,以验证协议实现的标准性,避免将来踩坑。而如果需要自己临时起一个 OAuth2 服务做测试的话嘛~~~-phpoauth2server
是的,搭一个 OAuth 服务器 5 分钟就够了。
是的,Apereo CAS 现在也支持 OAuth2 协议了,所以如果你已经按照 15 分钟部署一个 CAS 服务并对接 Shibboleth-IdP 3.4.6 的路程部署好了 CAS 服务的话,那么只需要略微的调整,就可以让他支持 OAuth2 了,5 分钟足矣。-phpoauth2server
下文假定已经安装好了 shibboleth-idp-3.4.6 和 cas 6.1 ,并使用 httpd 方式代理发布。
设置好 clientId , clientSecret ,设置好允许的 serviceId ,也就是 redirect_uri 。
此处默认的值是 NEST ,此时 userinfo 的中,属性部分是带 attributes 的子结构的, 如果是 FLAT 的话,则会去掉结构铺平。以下示例引用自 Apereo CAS 官网 -phpoauth2server
Shibboleth-IdP 的 OAuth2 对接需要去掉结构,所以我们使用 FLAT 模式
如果没有 CAS 部署的前序工作的话,5 分钟的时间可能不太够。但是既然 FLAG 已经立好了。。。我们可以用 oauth-server-lite 来快速的构建一个 oauth 服务。
配置文件的示例。考虑到 5 分钟还是有点紧张,我们只挑重要的部分修改。把 ldap 部分的配置修改为实际的 ldap 参数,把 http-session_options-domain 修改为实际的服务器域名。然后执行 ./control start 运行-phpoauth2server
其实 3.4.6 之后,由于新版插件均采用标准的 Externel 模式运行,因此 IdP 的 OAuth2 对接和 CAS 对接基本是完全一致的 —— 实际上 OAuth2 插件本来就是在 CAS 插件的基础上改的。有变化的地方仅 2 处。-phpoauth2server
更多细节可以关注 上海教育认证中心-IdP-Oauth2 对接 中的配置说明。
CC BY-SA
我的博客即将同步至 OSCHINA 社区,这是我的 OSCHINA ID:小冯冯,邀请大家一同入驻:
OAuth2 认证流程
OAuth2 是一种开放授权协议, 他使得第三方应用能够通过其他服务来认证用户,而不需要再维护用户认证密钥信息。
OAuth2 框架内包含三个角色:
Resource Owner:可以理解成用户
Client:第三方应用
Authorization Server: 认证服务
认证流程如下图:
(A): 第三方应用通过将浏览器重定向到认证页面发起OAuth2流程,重定向必须包含以下参数:
java oauth2 server 实现哪个好
即,service_a - service_b的话,
request_credential_of_service_a = digest(request+access_token_of_service_b)
然后在service_b端的话,
重新计算一下digest(request+ access_token_of_service_b)是否跟request_credential_of_service_a一致就行了.
一致则认为确实是service_a发送的请求.
对于service_b - service_a类似.
如果真要用完整的oauth/oauth2的话,可能需要对services内嵌oauth server或者假设一个中立的authorize server.
目的是你所提到的解决 Code授权码 的问题或者会所前面所提到的拿到对方给各自的access_token的过程.
这个是oauth标准流程必须的.
服务器的思路可以简单的对services的authorization request简单check一下IP之类的,然后就直接返回对应的access_token就好了,不用太复杂.
结论就是,
1. 考虑如何分享/给予各自的授权码/access token.
2. 实现各自基于access_token的请求校验逻辑.
OAuth 2.0 授权认证详解
一、认识 OAuth 2.0
1.1 OAuth 2.0 应用场景
OAuth 2.0 标准目前被广泛应用在第三方登录场景中,以下是虚拟出来的角色,阐述 OAuth2 能帮我们干什么,引用阮一峰这篇理解OAuth 2.0中的例子:
有一个"云冲印"的网站,可以将用户储存在Google的照片,冲印出来。用户为了使用该服务,必须让"云冲印"读取自己储存在Google上的照片。
问题是只有得到用户的授权,Google才会同意"云冲印"读取这些照片。那么,"云冲印"怎样获得用户的授权呢?
传统方法是,用户将自己的Google用户名和密码,告诉"云冲印",后者就可以读取用户的照片了。这样的做法有以下几个严重的缺点。
1.2 名词概念
OAuth 就是为了解决上面这些问题而诞生的。在详解 OAuth 之前,需要明确一些基本的概念,从上面场景中抽象出以下概念。
第三方应用程序
Third-party application :第三方应用程序,本文中又称"客户端"(client),即上一节例子中的"云冲印"。
HTTP服务提供商
HTTP service :HTTP服务提供商,本文中简称"服务提供商",即上一节例子中的Google。
资源所有者
Resource Owner :资源所有者,本文中又称"用户"(user)。
用户代理
User Agent :用户代理,本文中就是指浏览器。
认证服务器
Authorization server :认证服务器,即服务提供商专门用来处理认证的服务器。
资源服务器
Resource server :资源服务器,即服务提供商存放用户生成的资源的服务器。它与认证服务器,可以是同一台服务器,也可以是不同的服务器。
知道了上面这些名词,就不难理解,OAuth的作用就是让"客户端"安全可控地获取"用户"的授权,从而可以和"服务商提供商"进行互动。
二、OAuth 的授权认证流程
2.1 认证思路
OAuth 在"客户端"与"服务提供商"之间,设置了一个 授权层 (authorization layer)。"客户端"不能直接登录"服务提供商",只能登录授权层,以此将用户与客户端区分开来。"客户端"登录授权层所用的令牌(token),与用户的密码不同。用户可以在登录的时候,指定授权层令牌的权限范围和有效期。-phpoauth2server
"客户端"登录授权层以后,"服务提供商"根据令牌的权限范围和有效期,向"客户端"开放用户储存的资料。
2.2 认证流程
官方 RFC 6749 文件中的 OAuth 2.0 流程图有点晦涩,优化了 一下:
上述中的第 2 步 是关键,即用户怎样才能给于客户端授权。有了这个授权以后,客户端就可以获取令牌,进而凭令牌获取资源。
三、四种授权模式
上一小节可以得出用户对客户端的授权动作是核心,客户端必须得到用户的授权(authorization grant),才能获得令牌(access token)。OAuth 2.0定义了四种授权方式:
3.1 授权码模式(authorization code)
授权码(authorization code)方式,指的是第三方应用先申请一个授权码,然后再用该码获取令牌。
3.2 简化模式(implicit)
有些 Web 应用是纯前端应用,没有后端。这时就不能用上面的方式了,必须将令牌储存在前端。RFC 6749 就规定了第二种方式,允许直接向前端颁发令牌。这种方式没有授权码这个中间步骤,所以称为(授权码)"隐藏式"(implicit)。-phpoauth2server
3.3 密码模式(resource owner password credentials)
如果你高度信任某个应用,RFC 6749 也允许用户把用户名和密码,直接告诉该应用。该应用就使用你的密码,申请令牌,这种方式称为"密码式"(password)。
3.4 客户端模式(client credentials)
最后一种方式是凭证式(client credentials),适用于没有前端的命令行应用,即在命令行下请求令牌。
四、授权码模式详解
4.1 授权码模式流程
授权码模式(authorization code)是功能最完整、流程最严密安全的授权模式。它的特点就是通过客户端的 后台服务器 ,与"服务提供商"的认证服务器进行互动。
注意这种方式适用于那些有后端的 Web 应用。授权码通过前端传送,令牌则是储存在后端,而且所有与资源服务器的通信都在后端完成。这样的前后端分离,可以避免令牌泄漏。
授权码模式流程如下:
从上述的流程描述可知,只有第 2 步需要用户进行授权操作,之后的流程都是在客户端的后台和认证服务器后台之前进行"静默"操作,对于用户来说是无感知的。
下面是上面这些步骤所需要的参数。
4.2 授权码模式流程的五个步骤
第 1 步骤
参数说明
第 1 步骤中,客户端申请认证的URI,包含以下参数:
示例
A 网站提供一个链接,用户点击后就会跳转到 B 网站,授权用户数据给 A 网站使用。下面就是 A 网站跳转 B 网站的一个示意链接:
上面 URL 中:
response_type参数表示要求返回授权码(code);
client_id参数让 B 网站知道是谁在请求;
redirect_uri参数是 B 网站接受或拒绝请求后的跳转网址;
scope参数表示要求的授权范围(这里是只读)。
第 2 步骤
第 2 步骤中,用户跳转后,B 网站会要求用户登录,然后询问是否同意给予 A 网站授权。
第 3 步骤
参数说明
第 3 步骤中,服务器回应客户端的URI,包含以下参数:
示例
在第 2 步骤用户表示同意之后,这时 B 网站就会跳回redirect_uri参数指定的网址。跳转时,会传回一个授权码,就像下面这样。
上面 URL 中,code参数就是授权码。
第 4 步骤
参数说明
第 4 步骤中,客户端向认证服务器申请令牌的HTTP请求,包含以下参数:
示例
在第 3 步骤中,A 网站拿到授权码以后,就可以在后端,向 B 网站请求令牌。
上面 URL 中:
client_id参数和client_secret参数用来让 B 确认 A 的身份(client_secret参数是保密的,因此只能在后端发请求);
grant_type参数的值是AUTHORIZATION_CODE,表示采用的授权方式是授权码;
code参数是上一步拿到的授权码;
redirect_uri参数是令牌颁发后的回调网址。
第 5 步骤
参数说明
第 5 步骤中,认证服务器发送的HTTP回复,包含以下参数:
示例
第 4 步骤中,B 网站收到请求以后,就会颁发令牌。具体做法是向redirect_uri指定的网址,发送一段 JSON 数据:
上面 JSON 数据中,access_token字段就是令牌,A 网站在后端拿到了。注意:HTTP头信息中明确指定不得缓存。
五、令牌(Token)传递方式
当客户端(第三方应用程序)拿到访问资源服务器的令牌时,便可以使用这个令牌进行资源访问了。
在第三方应用程序拿到access_token后,如何发送给资源服务器这个问题并没有在 RFC6729 文件中定义,而是作为一个单独的 RFC6750 文件中独立定义了。这里做以下简单的介绍,主要有三种方式如下:-phpoauth2server
5.1 请求头参数传递
Authorization Request Header Field,因为在HTTP应用层协议中,专门有定义一个授权使用的Request Header,所以也可以使用这种方式:
其中"Bearer "是固定的在access_token前面的头部信息。
5.2 表单编码传递
使用 Request Body 这种方式,有一个额外的要求,就是 Request Header 的Content-Type必须是固定的application/x-www-form-urlencoded,此外还有一个限制就是 不可以使用 GET 访问,这个好理解,毕竟 GET 请求是不能携带 Request Body 的。-phpoauth2server
5.3 URI 请求参数传递
URI Query Parameter,这种使用途径应该是最常见的一种方式,非常简单,比如:
在我们请求受保护的资源的 Url 后面追加一个 access_token 的参数即可。另外还有一点要求,就是 Client 需要设置以下 Request Header 的 Cache-Control:no-store ,用来阻止 access_token 不会被 Web 中间件给 log 下来,属于安全防护方面的一个考虑。-phpoauth2server
5.4 令牌的刷新
为了防止客户端使用一个令牌无限次数使用,令牌一般会有过期时间限制,当快要到期时,需要重新获取令牌,如果再重新走授权码的授权流程,对用户体验非常不好,于是 OAuth 2.0 允许用户自动更新令牌。
具体方法是,B 网站颁发令牌的时候,一次性颁发两个令牌,一个用于获取数据,另一个用于获取新的令牌(refresh token 字段)。令牌到期前,用户使用 refresh token 发一个请求,去更新令牌。-phpoauth2server
上面 URL 中:
grant_type参数为refresh_token表示要求更新令牌,此处的值固定为refresh_token,必选项;
client_id参数和client_secret参数用于确认身份;
refresh_token参数就是用于更新令牌的令牌。
B 网站验证通过以后,就会颁发新的令牌。
注意: 第三方应用服务器拿到刷新令牌必须存于服务器,通过后台进行重新获取新的令牌,以保障刷新令牌的保密性。
六、OAuth2的安全问题
6.1 CSRF攻击
应用程序在早期使用 OAuth2 的时候爆发过不少相关的安全方面的漏洞,其实仔细分析后会发现大都都是没有严格遵循 OAuth2 的安全相关的指导造成的,相关的漏洞事件自行搜索。
其实 OAuth2 在设计之初是已经做了很多安全方面的考虑,并且在 RFC6749 中加入了一些安全方面的规范指导。比如:
安全无小事,这方面是要靠各方面(开放平台,第三方开发者)共同防范的。
6.2 攻击流程
假设有用户张三,攻击者李四,第三方"云冲印"应用(它集成了第三方社交账号登录,并且允许用户将社交账号和"云冲印"中的账号进行绑定),以及 OAuth2 服务提供者 Google。
步骤1
攻击者李四登录"云冲印"网站,并且选择绑定自己的 Google 账号
步骤2
"云冲印"网站将李四重定向到 Google,由于他之前已经登录过 Google,所以 Google 直接向他显示是否授权"云冲印"访问的页面。
步骤3
李四在点击"同意授权"之后,截获 Google 服务器返回的含有Authorization code参数的HTTP响应。
步骤4
李四精心构造一个 Web 页面,它会触发"云冲印"网站向 Google 发起令牌申请的请求,而这个请求中的Authorization Code参数正是上一步截获到的 code。
步骤5
李四将这个 Web 页面放到互联网上,等待或者诱骗受害者张三来访问。
步骤6
张三之前登录了"云冲印"网站,只是没有把自己的账号和其他社交账号绑定起来。在张三访问了李四准备的这个 Web 页面,令牌申请流程在张三的浏览器里被顺利触发,"云冲印"网站从 Google 那里获取到access_token,但是这个 token 以及通过它进一步获取到的用户信息却都是攻击者李四的。-phpoauth2server
步骤7
"云冲印"网站将李四的 Google 账号同张三的"云冲印"账号关联绑定起来,从此以后,李四就可以用自己的 Google 账号通过 OAuth 登录到张三在 "云冲印" 网站中的账号,堂而皇之的冒充张三的身份执行各种操作。-phpoauth2server
从整体上来看,本次 CSRF 攻击的时序图应该是下面这个样子的:
从上图中可以看出,造成 CSRF 攻击漏洞问题的关键点在于,OAuth2 的认证流程是分为好几步来完成的,在上一章节授权码模式流程中的流程图中的第 4步骤中,第三方应用在收到一个 GET 请求时,除了能知道当前用户的 cookie,以及 URL 中的Authorization Code之外,难以分辨出这个请求到底是用户本人的意愿,还是攻击者利用用户的身份伪造出来的请求。-phpoauth2server
于是,攻击者就能使用移花接木的手段,提前准备一个含有自己的Authorization Code的请求,并让受害者的浏览器来接着完成后续的令牌申请流程。
6.3 解决方案
要防止这样的攻击其实很容易,作为第三方应用的开发者,只需在 OAuth 认证过程中加入state参数,并验证它的参数值即可。具体细节如下:
state参数在 OAuth2 认证过程中不是必选参数,因此在早期第三方应用开发者在集成 OAuth2 认证的时候很容易会忽略它的存在,导致应用易受 CSRF 攻击。所以必须对这个安全问题重视起来。-phpoauth2server
安全是双方的,需要第三方应用和资源服务提供商均要严格遵守安全规范。如 QQ 互联的 OAuth2 API 中,state 参数是强制必选的参数,授权接口是基于 HTTPS 的加密通道等;作为第三方开发者在使用消费这些服务的时候也应该重视注意安全中存在的漏洞。-phpoauth2server