|
; o, Y$ Q8 T% G" y
1用户认证需求分析1.1用户认证与授权截至目前,项目已经完成了在线学习功能,用户通过在线学习页面点播视频进行学习如何去记录学生的学习过程 呢?要想掌握学生的学习情况就需要知道用户的身份信息,记录哪个用户在什么时间学习什么课程;如果用户要购 买课程也需要知道用户的身份信息。 # H! v4 t. T9 W, S4 `( _3 _
所以,去管理学生的学习过程最基本的要实现用户的身份认证什么是用户身份认证?用户身份认证即用户去访问系统资源时系统要求验证用户的身份信息,身份合法方可继续访问常见的用户身份认 证表现形式有:用户名密码登录,指纹打卡等方式。
* b0 z% k) F! c; X; f' a 什么是用户授权?用户认证通过后去访问系统的资源,系统会判断用户是否拥有访问资源的权限,只允许访问有权限的系统资源,没 有权限的资源将无法访问,这个过程叫用户授权1.2单点登录需求本项目包括多个子项目,如:学习系统,教学管理中心、系统管理中心等,为了提高用户体验性需要实现用户只认 证一次便可以在多个拥有访问权限的系统中访问,这个功能叫做单点登录。
) `1 C. W3 V9 V! A" K4 g, ` 引用百度百科:单点登录(Single Sign On),简称为 SSO,是目前比较流行的企业业务整合的解决方案之一SSO的定义是在多个应用系统中,用户只需要登录一次就可以访问所有相互信任的应用系统下图是SSO的示意图,用户登录学成网一次即可访问多个系统。 8 @- C. B/ @7 C! G- `; d0 {- U3 w
1.3第三方认证需求作为互联网项目难免需要访问外部系统的资源,同样本系统也要访问第三方系统的资源接口,一个场景如下:一个微信用户没有在学成在线注册,本系统可以通过请求微信系统来验证该用户的身份,验证通过后该用户便可在 本系统学习,它的基本流程如下:
( }( W2 ~, `- Q% c2 a8 O6 Z3 b 从上图可以看出,微信不属于本系统,本系统并没有存储微信用户的账号、密码等信息,本系统如果要获取该用户 的基本信息则需要首先通过微信的认证系统(微信认证)进行认证,微信认证通过后本系统便可获取该微信用户的 基本信息,从而在本系统将该微信用户的头像、昵称等信息显示出来,该用户便不用在本系统注册却可以直接学 习。
, M* C) W: ~7 | 什么是第三方认证(跨平台认证)?当需要访问第三方系统的资源时需要首先通过第三方系统的认证(例如:微信认证),由第三方系统对用户认证通 过,并授权资源的访问权限。
" V+ t9 A; o' M- N9 \! v+ t! X 2用户认证技术方案2.1单点登录技术方案分布式系统要实现单点登录,通常将认证系统独立抽取出来,并且将用户身份信息存储在单独的存储介质,比如:MySQL、Redis,考虑性能要求,通常存储在Redis中,如下图
! @7 K+ g0 F3 {& i 单点登录的特点是:1、认证系统为独立的系统2、各子系统通过Http或其它协议与认证系统通信,完成用户认证3、用户身份信息存储在Redis集群Java中有很多用户认证的框架都可以实现单点登录:1、Apache Shiro.。
3 C) h2 M$ y2 F0 [3 T2 c! F/ i 2、CAS3、Spring security CAS2.2Oauth2认证单点登录的特点是:1、认证系统为独立的系统2、各子系统通过Http或其它协议与认证系统通信,完成用户认证3、用户身份信息存储在Redis集群。
1 c+ h9 y' `& r Java中有很多用户认证的框架都可以实现单点登录: 1、Apache Shiro.2、CAS3、Spring security CAS2.2Oauth2认证2.2.1Oauth2认证流程第三方认证技术方案最主要是解决认证协议的通用标准 问题,因为要实现 跨系统认证,各系统之间要遵循一定的接口协议。
$ S" k% x8 Y; s* h, N% M OAUTH协议为用户资源的授权提供了一个安全的、开放而又简易的标准同时,任何第三方都可以使用OAUTH认证服务,任何服务提供商都可以实现自身的OAUTH认证服务,因而OAUTH是开放的业界提供了OAUTH的多种实现如PHP、JavaScript,Java,Ruby等各种语言开发包,大大节约了程序员的时间,因而OAUTH是简易的。
; x. h, r4 B( j9 ~0 K, \ 互联网很多服务如Open API,很多大公司如Google,Yahoo,Microsoft等都提供了OAUTH认证服务,这些都足以说明OAUTH标准逐渐成为开放资源授权的标准Oauth协议目前发展到2.0版本,1.0版本过于复杂,2.0版本已得到广泛应用。 0 i% i; {/ O6 D6 n: K/ |
参考:https://baike.baidu.com/item/oAuth/7153134?fr=aladdinOauth协议:https://tools.ietf.org/html/rfc6749下边分析一个Oauth2认证的例子,黑马程序员网站使用微信认证的过程: 3 ^/ G/ @1 T; W: m* @0 m9 C7 L
第三方认证技术方案最主要是解决认证协议的通用标准 问题,因为要实现 跨系统认证,各系统之间要遵循一定的接口协议OAUTH协议为用户资源的授权提供了一个安全的、开放而又简易的标准同时,任何第三方都可以使用OAUTH认证服务,任何服务提供商都可以实现自身的OAUTH认证服务,因而OAUTH是开放的。
; i K1 D. H- @# H( P& W4 ^ 业界提供了OAUTH的多种实现如PHP、JavaScript,Java,Ruby等各种语言开发包,大大节约了程序员的时间,因而OAUTH是简易的互联网很多服务如Open API,很多大公司如Google,Yahoo,Microsoft等都提供了OAUTH认证服务,这些都足以说明OAUTH标准逐渐成为开放资源授权的标准。 X# D/ x0 z. d. {% b% ^
Oauth协议目前发展到2.0版本,1.0版本过于复杂,2.0版本已得到广泛应用 参考:https://baike.baidu.com/item/oAuth/7153134?fr=aladdinOauth协议:。 9 K, u# s1 N1 r" G& K8 n; X5 v
https://tools.ietf.org/html/rfc6749下边分析一个Oauth2认证的例子,黑马程序员网站使用微信认证的过程:: $ c4 b3 [8 ?0 V1 g' a, {! }& w) K' `
1、客户端请求第三方授权用户进入黑马程序的登录页面,点击微信的图标以微信账号登录系统,用户是自己在微信里信息的资源拥有者。 - H% K& K& [" `$ s( U. ~, t
点击“微信”出现一个二维码,此时用户扫描二维码,开始给黑马程序员授权。 6 g) U2 q3 m/ `3 H
2、资源拥有者同意给客户端授权资源拥有者扫描二维码表示资源拥有者同意给客户端授权,微信会对资源拥有者的身份进行验证, 验证通过后,微信会询问用户是否给授权黑马程序员访问自己的微信数据,用户点击“确认登录”表示同意授权,微信认证服务器会 颁发一个授权码,并重定向到黑马程序员的网站。
$ Y; ^4 R) J( p7 w% H 3、客户端获取到授权码,请求认证服务器申请令牌此过程用户看不到,客户端应用程序请求认证服务器,请求携带授权码4、认证服务器向客户端响应令牌认证服务器验证了客户端请求的授权码,如果合法则给客户端颁发令牌,令牌是客户端访问资源的通行证。 7 _9 @3 N5 _' w: ^1 ^
此交互过程用户看不到,当客户端拿到令牌后,用户在黑马程序员看到已经登录成功5、客户端请求资源服务器的资源客户端携带令牌访问资源服务器的资源黑马程序员网站携带令牌请求访问微信服务器获取用户的基本信息6、资源服务器返回受保护资源
0 r3 b% ~) \. S' D. i 资源服务器校验令牌的合法性,如果合法则向用户响应资源信息内容注意:资源服务器和认证服务器可以是一个服务也可以分开的服务,如果是分开的服务资源服务器通常要请求认证 服务器来校验令牌的合法性Oauth2.0认证流程如下:。
. E5 j, s2 D T. `. P$ {) g 引自Oauth2.0协议rfc6749 https://tools.ietf.org/html/rfc6749
6 W2 H% H' X9 @. H1 U9 L Oauth2包括以下角色:1、客户端本身不存储资源,需要通过资源拥有者的授权去请求资源服务器的资源,比如:学成在线Android客户端、学成在线Web客户端(浏览器端)、微信客户端等2、资源拥有者通常为用户,也可以是应用程序,即该资源的拥有者。
, A g% i5 I, ]5 D 3、授权服务器(也称认证服务器)用来对资源拥有的身份进行认证、对访问资源进行授权客户端要想访问资源需要通过认证服务器由资源拥有者授 权后方可访问4、资源服务器存储资源的服务器,比如,学成网用户管理服务器存储了学成网的用户信息,学成网学习服务器存储了学生的学习 信息,微信的资源服务存储了微信的用户信息等。 # O0 t( S* C' k7 q# _
客户端最终访问资源服务器获取资源信息2.2.2Oauth2在本项目的应用Oauth2是一个标准的开放的授权协议,应用程序可以根据自己的要求去使用Oauth2,本项目使用Oauth2实现如下目标:1、学成在线访问第三方系统的资源
% ]% H5 O% Q6 \1 B5 |2 N 2、外部系统访问学成在线的资源3、学成在线前端(客户端) 访问学成在线微服务的资源4、学成在线微服务之间访问资源,例如:微服务A访问微服务B的资源,B访问A的资源2.3Spring security Oauth2认证解决方案。
( o+ c& V" M/ ]4 @ 本项目采用 Spring security + Oauth2完成用户认证及用户授权,Spring security 是一个强大的和高度可定制的身份验证和访问控制框架,Spring security 框架集成了Oauth2协议,下图是项目认证架构图:
9 d0 `7 t# u+ \3 o/ _/ w& `$ H 1、用户请求认证服务完成认证2、认证服务下发用户身份令牌,拥有身份令牌表示身份合法3、用户携带令牌请求资源服务,请求资源服务必先经过网关4、网关校验用户身份令牌的合法,不合法表示用户没有登录,如果合法则放行继续访问。
' U. a: s, V2 d, W% t- F( u" W 5、资源服务获取令牌,根据令牌完成授权6、资源服务完成授权则响应资源信3Spring Security Oauth2研究3.1目标本项目认证服务基于Spring Security Oauth2进行构建,并在其基础上作了一些扩展,采用JWT令牌机制,并自定义了用户身份信息的内容。
+ [" y0 y3 F$ F+ l 本教程的主要目标是学习在项目中集成Spring Security Oauth2的方法和流程,通过spring Security Oauth2的研究需要达到以下目标:1、理解Oauth2的授权码认证流程及密码认证的流程。 * U# z( n' ]( ^2 _
2、理解spring Security Oauth2的工作流程3、掌握资源服务集成spring Security框架完成Oauth2认证的流程3.2搭建认证服务器息3.2.1导入基础工程导入“资料”目录下的 xc-service-ucenter-auth工程,该工程是基于Spring Security Oauth2的一个二次封装的工程,导入此工程研究Oauth2认证流程。
5 Y7 P+ E" F: z6 t! n9 t 3.2.2创建数据库导入资料目录下的 xc_user.sql,创建用户数据库
% `& X e, I& W" ?0 [& T 以“oauth_”开头的表都是spring Security 自带的表。本项目中spring Security 主要使用oauth_client_details表:
6 r$ H) r1 ?6 q" d { A+ e, U client_id: 客 户 端 id resource_ids:资源id(暂时不用) client_secret:客户端密码scope:范围access_token_validity:访问token的有效期(秒) refresh_token_validity:刷新token的有效期(秒)
3 D3 a/ d% D+ N* |; s" X authorized_grant_type:授权类型,authorization_code,password,refresh_token,client_credentials3.3Oauth2授权码模式 4 P q* H* |; k% j6 v* Y3 [) i
3.3.1Oauth2授权模式Oauth2有以下授权模式:授权码模式(Authorization Code)隐式授权模式(Implicit)密码模式(Resource Owner Password Credentials)
: S- o3 G6 B2 B1 `6 q- @1 I 客户端模式(Client Credentials)其中授权码模式和密码模式应用较多,本小节介绍授权码模式3.3.2授权码授权流程上边例举的黑马程序员网站使用微信认证的过程就是授权码模式,流程如下:1、客户端请求第三方授权 2、用户(资源拥有者)同意给客户端授权 3、客户端获取到授权码,请求认证服务器申请令牌 4、认证服务器向客户端响应令牌 5、客户端请求资源服务器的资源,资源服务校验令牌合法性,完成授权。 $ R: ?7 W/ r, S
6、资源服务器返回受保护资源3.3.2申请授权码请求认证服务获取授权码:Get请求:localhost:40400/auth/oauth/authorize? client_id=XcWebApp&response_type=code&scop=app&redirect_uri=http://localhost
7 |6 a$ P$ I, y5 f4 v : R9 Z W1 o. A
参数列表如下:client_id:客户端id,和授权配置类中设置的客户端id一致response_type:授权码模式固定为codescop:客户端范围,和授权配置类中设置的scop一致redirect_uri:跳转uri,当授权码申请成功后会跳转到此地址,并在后边带上code参数(授权码)。
) c7 ~* A" }# z+ M6 k0 e# D 首先跳转到登录页面:
) ?: w* w! M0 m 输入账号和密码,点击LoginSpring Security接收到请求会调用UserDetailsService接口的loadUserByUsername方法查询用户正确的密码当前导入的基础工程中将正确的密码硬编码为“123”,所以这里账号随意输入,密码输入123即可认证通过。 b, q) d7 o2 L$ K$ {4 q" O* n6 ^
点击“同意”。接下来返回授权码:认证服务携带授权码跳转redirect_uri 0 y" @" b) t! X# o( g
3.3.3申请令牌拿到授权码后,申请令牌Post请求:http://localhost:40400/auth/oauth/token参数如下:grant_type:授权类型,填写authorization_code,表示授权码模式。
* H) ^8 C* A) x: f( d code:授权码,就是刚刚获取的授权码,注意:授权码只使用一次就无效了,需要重新申请redirect_uri:申请授权码时的跳转url,一定和申请授权码时用的redirect_uri一致此链接需要使用 http Basic认证。
/ M |( k9 E, v" h$ E& n0 Z 什么是http Basic认证?http协议定义的一种认证方式,将客户端id和客户端密码按照“客户端ID:客户端密码”的格式拼接,并用base64编 码,放在header中请求服务端,一个例子:Authorization:Basic WGNXZWJBcHA6WGNXZWJBcHA=
7 r* L) c5 Y* r& G' D: T WGNXZWJBcHA6WGNXZWJBcHA= 是用户名:密码的base64编码。认证失败服务端返回 401 Unauthorized以上测试使用postman完成:http basic认证: - W) ^6 x& S9 `. D: H9 [6 Q
客户端Id和客户端密码会匹配数据库oauth_client_details表中的客户端id及客户端密码。Post请求参数:
( g+ b2 X$ r; ^ 点击发送:申请令牌成功:
2 W4 g5 O9 u" h( G0 u access_token:访问令牌,携带此令牌访问资源token_type:有MAC Token与Bearer Token两种类型,两种的校验算法不同,RFC 6750建议Oauth2采用 Bearer Token(http://www.rfcreader.com/#rfc6750)。 % f5 a. d0 Y% F$ ~0 M
refresh_token:刷新令牌,使用此令牌可以延长访问令牌的过期时间expires_in:过期时间,单位为秒scope:范围,与定义的客户端范围一致3.3.4资源服务授权3.3.4.1资源服务授权流程。 8 i$ S9 @$ `3 k: q% s" S
资源服务拥有要访问的受保护资源,客户端携带令牌访问资源服务,如果令牌合法则可成功访问资源服务中的资 源,如下图:
( Q2 h! F$ R- @; U 上图的业务流程如下:1、客户端请求认证服务申请令牌2、认证服务生成令牌认证服务采用非对称加密算法,使用私钥生成令牌3、客户端携带令牌访问资源服务客户端在Http header 中添加: Authorization:Bearer 令牌。
5 p4 V8 T3 `2 s) E1 H5 y8 D6 L 4、资源服务请求认证服务校验令牌的有效性资源服务接收到令牌,使用公钥校验令牌的合法性5、令牌有效,资源服务向客户端响应资源信息3.3.4.2资源服务授权配置基本上所有微服务都是资源服务,这里我们在课程管理服务上配置授权控制,当配置了授权控制后如要访问课程信 息则必须提供令牌。
! ~* U& Z' J: S! h6 c 1、配置公钥认证服务生成令牌采用非对称加密算法,认证服务采用私钥加密生成令牌,对外向资源服务提供公钥,资源服务使 用公钥 来校验令牌的合法性将公钥拷贝到 publickey.txt文件中,将此文件拷贝到资源服务工程的classpath下。
0 p, M; H/ y8 C" S0 c! Q( T5 Y 2、添加依赖 : M8 j( g5 L4 Q* i. d4 q% G+ b$ Q
2、添加依赖" u2 t9 [9 g5 C* a* b
org.springframework.cloud+ v8 W2 R2 \) W; q0 {! r3 b
spring‐cloud‐starter‐oauth2/ K. C* h, f& C6 K$ G4 C; I/ V( N
$ t' _0 C6 \- ~3 R; p; Z& \" L& K2 C
) j( A6 W) m7 K4 O! K. k7 ` 4、在config包下创建ResourceServerConfig类:@Configuration @EnableResourceServer@EnableGlobalMethodSecurity(prePostEnabled = true, securedEnabled = true)//激活方法上的
+ `9 {; F& e. F S PreAuthorize注解public class ResourceServerConfig extends ResourceServerConfigurerAdapter {//公钥private static final String PUBLIC_KEY = "publickey.txt"; 4 r. ]: b1 k7 J' M
//定义JwtTokenStore,使用jwt令牌@Beanpublic TokenStore tokenStore(JwtAccessTokenConverter jwtAccessTokenConverter) { return new JwtTokenStore(jwtAccessTokenConverter); , A! U' R$ z. {7 o
}//定义JJwtAccessTokenConverter,使用jwt令牌@Beanpublic JwtAccessTokenConverter jwtAccessTokenConverter() { JwtAccessTokenConverter converter = new JwtAccessTokenConverter(); converter.setVerifierKey(getPubKey());
! A- c. W% I; a0 x5 @' c' E- I1 V; A return converter;}/***获取非对称加密公钥 Key*@return 公 钥 Key*/private String getPubKey() {Resource resource = new ClassPathResource(PUBLIC_KEY); try { , F; l9 S- @0 {1 f, Y
InputStreamReader inputStreamReader = new InputStreamReader(resource.getInputStream());BufferedReader br = new BufferedReader(inputStreamReader); return br.lines().collect(Collectors.joining("\n"));
8 t& n: Y. j( R. u7 k& o: G6 h% l3 h } catch (IOException ioe) { return null;}}//Http安全配置,对每个到达系统的http请求链接进行校验@Overridepublic void configure(HttpSecurity http) throws Exception { 8 g, U8 ?3 b% C4 X. y$ |% Y! @
//所有请求必须认证通过http.authorizeRequests().anyRequest().authenticated();}}3.3.4.3资源服务授权测试这里我们测试课程图片查询get http://localhost:31200/course/coursepic/list/4028e58161bd3b380161bd3bcd2f0000 5 a& @9 m4 V5 S/ ^1 v
请求时没有携带令牌则报错:{
( N5 W7 W' x0 S( A" e5 a' Y "error": "unauthorized",
: Y+ R/ V. s- d; d2 h9 Z/ d* h- |. b "error_description": "Full authentication is required to access this resource"5 L0 N1 [: p+ \1 b6 f# z0 y
}
) R, F2 L1 Z. Z( Z2 q, C 7 [5 ~2 R8 B/ R& Q1 O* w
请求时携带令牌:在http header中添加 Authorization: Bearer 令牌 6 R+ M1 w! R& g
当输入错误的令牌也无法正常访问资源。
+ m9 x8 X1 Q1 G' [: r+ h" Z1 ] 3.3.4.4解决swagger-ui无法访问当课程管理加了授权之后再访问swagger-ui则报错:
; ~0 u7 V5 o6 @ 修改授权配置类ResourceServerConfig的configure方法: 针对swagger-ui的请求路径进行放行://Http安全配置,对每个到达系统的http请求链接进行校验@Override
+ Q J0 w/ `' ]4 J% S+ L) h# t public void configure(HttpSecurity http) throws Exception {; {/ V4 n# N* H
//所有请求必须认证通过http.authorizeRequests()# A# [, r( g/ q
//下边的路径放行5 f- a0 w F9 u; o9 [
.antMatchers("/v2/api‐docs", "/swagger‐resources/configuration/ui", "/swagger‐resources","/swagger‐resources/configuration/security", "/swagger‐ui.html","/webjars/**").permitAll()
% c2 Q" v' i; W .anyRequest().authenticated();
# E) o3 k I" R. v# O }9 d3 L& i( [$ h# U
* _2 H2 x5 s" B- I* e4 J; |% u
注意:通过上边的配置虽然可以访问swagger-ui,但是无法进行单元测试,除非去掉认证的配置或在上边配置中添加所有请求均放行("/**")3.4Oauth2密码模式授权密码模式(Resource Owner Password Credentials)与授权码模式的区别是申请令牌不再使用授权码,而是直接通过用户名和密码即可申请令牌。 4 M. w4 W2 [; t
测试如下:Post请求:http://localhost:40400/auth/oauth/token参数:grant_type:密码模式授权填写password username:账号password:密码 ' i9 |! Z/ T7 g' P; b
并且此链接需要使用 http Basic认证。
4 C( d! {6 l' H* | 上边参数使用x-www-form-urlencoded方式传输,使用postman测试如下: ( w' L1 [$ u. i6 y
注意:当令牌没有过期时同一个用户再次申请令牌则不再颁发新令牌3.5校验令牌Spring Security Oauth2提供校验令牌的端点,如下:Get: http://localhost:40400/auth/oauth/check_token?token=。
/ F4 W: v9 V7 C- M- v( G8 X. M 参数:token:令牌使用postman测试如下: # ~: P0 k5 `9 ?* r. H
结果如下:{6 n3 a1 j* ~2 ^4 h+ L
"companyId": null,
$ }: |' c% e1 O! Q, J } "userpic": null, "user_name": "mrt", "scope": [
# x; |& I5 s1 A& C: ~! Y- j4 t% _) _ "app"
- E. ^" n" E5 b# b# W ],
9 C% {2 I/ g5 Z2 [, g3 V "name": null,' b. u& \! g4 a( q
"utype": null,7 E z' n8 V7 U. a2 n, m
"id": null,3 Q' @' u2 O/ n( `
"exp": 1531254828,
1 l. A6 x: \8 C! d' s) j "jti": "6a00f227‐4c30‐47dc‐a959‐c0c147806462", "client_id": "XcWebApp"
. D3 K- e& O) i3 O& m' J }
3 u0 o6 {; [" F3 n: Q9 ~
# U# h# P2 u( K) i exp:过期时间,long类型,距离1970年的秒数(new Date().getTime()可得到当前时间距离1970年的毫秒数)user_name: 用户名client_id:客户端Id,在oauth_client_details中配置scope:客户端范围,在oauth_client_details表中配置jti:与令牌对应的唯一标识。 * S$ w$ ]! j1 h6 q8 o) }
companyId、userpic、name、utype、id:这些字段是本认证服务在Spring Security基础上扩展的用户身份信息3.5刷新令牌刷新令牌是当令牌快过期时重新生成一个令牌,它于授权码授权和密码授权生成令牌不同,刷新令牌不需要授权码 也不需要账号和密码,只需要一个刷新令牌、客户端id和客户端密码。
* H. f: h+ Q% @2 o( t4 d O 测 试 如 下 : Post:http://localhost:40400/auth/oauth/token 参数:grant_type: 固定为 refresh_tokenrefresh_token:刷新令牌(注意不是access_token,而是refresh_token)
& e& ~; X: v5 m4 M; N 刷新令牌成功,会重新生成新的访问令牌和刷新令牌,令牌的有效期也比旧令牌长 刷新令牌通常是在令牌快过期时进行刷新3.6JWT研究3.6.1JWT介绍在介绍JWT之前先看一下传统校验令牌的方法,如下图: - b4 p' r4 K, d4 Y7 z
问题:传统授权方法的问题是用户每次请求资源服务,资源服务都需要携带令牌访问认证服务去校验令牌的合法性,并根 据令牌获取用户的相关信息,性能低下解决:使用JWT的思路是,用户认证通过会得到一个JWT令牌,JWT令牌中已经包括了用户相关的信息,客户端只需要携带JWT访问资源服务,资源服务根据事先约定的算法自行完成令牌校验,无需每次都请求认证服务完成授权。
; e$ B3 N e3 o% n4 O2 j JWT令牌授权过程如下图:
) _( x0 E# o! X: F3 W; x" b 什么是JWT?JSON Web Token(JWT)是一个开放的行业标准(RFC 7519),它定义了一种简介的、自包含的协议格式,用于在通信双方传递json对象,传递的信息经过数字签名可以被验证和信任。 " }( B6 H* \$ y# B
JWT可以使用HMAC算法或使用RSA的公钥/私钥对来签名,防止被篡改官网:https://jwt.io/标准:https://tools.ietf.org/html/rfc7519JWT令牌的优点:1、jwt基于json,非常方便解析。
( H2 H3 x8 n. D- q8 H 2、可以在令牌中自定义丰富的内容,易扩展3、通过非对称加密算法及数字签名技术,JWT防止篡改,安全性高4、资源服务使用JWT可不依赖认证服务即可完成授权缺点:1、JWT令牌较长,占存储空间比较大3.6.1.1令牌结构 0 n3 Q& E+ z c( {& G2 O
通过学习JWT令牌结构为自定义jwt令牌打好基础JWT令牌由三部分组成,每部分中间使用点(.)分隔,比如:xxxxx.yyyyy.zzzzz Header头部包括令牌的类型(即JWT)及使用的哈希算法(如HMAC SHA256或RSA)。 0 p% N2 _. k) c- T6 t, H
一个例子如下:下边是Header部分的内容{3 {! r5 d( E4 S) D5 r/ s- j
"alg": "HS256",
4 i+ v7 q$ l: L "typ": "JWT"1 u/ x7 S6 i! E& U
}
2 G, q8 `# t% N2 ]+ G* t. S: |8 b 将上边的内容使用Base64Url编码,得到一个字符串就是JWT令牌的第一部分Payload第二部分是负载,内容也是一个json对象,它是存放有效信息的地方,它可以存放jwt提供的现成字段,比如:iss(签发者),exp(过期时间戳), sub(面向的用户)等,也可自定义字段。 # D6 U1 d1 M) c, {5 H
此部分不建议存放敏感信息,因为此部分可以解码还原原始内容最后将第二部分负载使用Base64Url编码,得到一个字符串就是JWT令牌的第二部分一个例子:{" B# l R2 A, H1 n! Q
"sub": "1234567890",! M: u0 ~" D- `9 k* X( H- k
"name": "456", "admin": true
! A5 ]% N" N$ S# V+ C4 G( x }1 l! y5 J e$ P
。
* n4 S4 q6 D: G+ [9 `1 X Signature第三部分是签名,此部分用于防止jwt内容被篡改这个部分使用base64url将前两部分进行编码,编码后使用点(.)连接组成字符串,最后使用header中声明签名算法进行签名一个例子:HMACSHA256(6 x8 _* [" ^4 C* p
base64UrlEncode(header) + "." + base64UrlEncode(payload), secret)
% I. _! V- A% T+ f + X9 k0 Y* j+ W. [) Q( [
base64UrlEncode(header):jwt令牌的第一部分base64UrlEncode(payload):jwt令牌的第二部分secret:签名所使用的密钥3.6.3JWT入门Spring Security 提供对JWT的支持,本节我们使用Spring Security 提供的JwtHelper来创建JWT令牌,校验JWT令牌等操作。 - q! g; w4 t( }2 X
3.6.3.1生成私钥和公钥JWT令牌生成采用非对称加密算法1、生成密钥证书下边命令生成密钥证书,采用RSA 算法每个证书包含公钥和私钥keytool -genkeypair -alias xckey -keyalg RSA -keypass xuecheng -keystore xc.keystore -storepass xuechengkeystore
5 N( Y) b" f# B1 k% F Keytool 是一个java提供的证书管理工具-alias:密钥的别名-keyalg:使用的hash算法-keypass:密钥的访问密码-keystore:密钥库文件名,xc.keystore保存了生成的证书
0 M+ D# c3 y. S' u7 W0 R K -storepass:密钥库的访问密码查询证书信息:keytool -list -keystore xc.keystore删除别名keytool -delete -alias xckey -keystore xc.keystore . ~0 k. Z9 M3 m
2、导出公钥openssl是一个加解密工具包,这里使用openssl来导出公钥信息安装 openssl:http://slproweb.com/products/Win32OpenSSL.html安装资料目录下的Win64OpenSSL-1_1_0g.exe。
! x2 a2 b/ c5 a ~! F- c& L; s 配置openssl的path环境变量,本教程配置在D:\OpenSSL-Win64\bin cmd进入xc.keystore文件所在目录执行如下命令:keytool ‐list ‐rfc ‐‐keystore xc.keystore | openssl x509 ‐inform pem ‐pubkey
6 k* X" t; A( Y4 K5 g% a
% k1 ^. B( t3 K 输入密钥库密码:
8 `: S; d6 ~0 h. U+ N) g 下边这一段就是公钥内容:-----BEGIN PUBLIC KEY-----MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAijyxMdq4S6L1Af1rtB8SjCZHNgsQG8JTfGy55eYvzG0B
( k4 r' Q$ h y! L! K2 K /E4AudR2prSRBvF7NYPL47scRCNPgLnvbQczBHbBug6uOr78qnWsYxHlW6Aa5dI5NsmOD4DLtSw8eX0hFyK5F j6ScYOSFBz9cd1nNTvx2+oIv0lJDcpQdQhsfgsEr1ntvWterZt/8r7xNN83gHYuZ6TM5MYvjQNBc5qC7Krs9wM7U oQuL+s0X6RlOib7/mcLn/lFLsLDdYQAZkSDx/6+t+1oHdMarChIPYT1sx9Dwj2j2mvFNDTKKKKAq0cv14Vrhz67Vj mz2yMJePDqUi0JYS2r0iIo7n8vN7s83v5uOQIDAQAB-----END PUBLIC KEY----- $ v3 Q! P* w9 ], h5 Z3 B/ w
将上边的公钥拷贝到文本文件中,合并为一行3.6.3.2生成jwt令牌在认证工程创建测试类,测试jwt令牌的生成与验证//生成一个jwt令牌@Test1 x& [8 J0 J: f3 N6 D) c$ v" {* O
public void testCreateJwt(){
# F/ r* Y) B5 q: O( M: @ //证书文件
) ]; t+ u% G/ U" W String key_location = "xc.keystore";
[$ l# `/ O3 J0 Y2 J; D- y, S //密钥库密码
5 {# t7 A' s1 H6 E String keystore_password = "xuechengkeystore";- R3 i1 h+ n9 s$ b6 J
//访问证书路径4 h' a `. S Q
ClassPathResource resource = new ClassPathResource(key_location);
. m* B) R" A4 \8 W$ K8 H$ T //密钥工厂
% w' I# S! }9 T: r" k0 v4 ? KeyStoreKeyFactory keyStoreKeyFactory = new KeyStoreKeyFactory(resource, keystore_password.toCharArray());
6 Q J) x' Y+ ?5 Z5 I //密钥的密码,此密码和别名要匹配
% x8 p/ a( t6 K, ^ String keypassword = "xuecheng";
4 J4 [1 R4 q; y& Z) E" I //密钥别名2 ?+ x# n4 F6 F F/ b
String alias = "xckey";; x! b; M) {/ {% D, i
//密钥对(密钥和公钥)7 P, j5 U4 O- U4 M9 T1 { o
KeyPair keyPair = keyStoreKeyFactory.getKeyPair(alias,keypassword.toCharArray());1 D5 }8 x" V4 e: p9 }
//私钥8 R: k+ a' o$ F" t f5 @6 a
RSAPrivateKey aPrivate = (RSAPrivateKey) keyPair.getPrivate();3 U" Z, U8 \9 V+ R4 f8 @, m
//定义payload信息/ _( K1 Q5 y9 j: |/ A; A
Map tokenMap = new HashMap<>(); tokenMap.put("id", "123");% z* f( S5 V6 m2 `% L
tokenMap.put("name", "mrt");4 }9 R5 _3 t5 A0 ]# t$ z5 ]' @2 E
tokenMap.put("roles", "r01,r02");" s/ N: g' j' g
tokenMap.put("ext", "1");/ p l. b8 A+ F% X2 ~4 E3 V% S
//生成jwt令牌
& T" f) f% w8 v7 d- e# U Jwt jwt = JwtHelper.encode(JSON.toJSONString(tokenMap), new RsaSigner(aPrivate));7 S. P$ p+ [1 q. o
//取出jwt令牌
; @/ `8 P5 Z# h1 o/ e% w9 t String token = jwt.getEncoded();
* C7 C9 l4 b2 f. A) `7 m System.out.println("token="+token);
; a! y1 @1 h$ t2 f9 S" G( j }
! r6 T' K5 w8 e; X! U 。 ( {% Z, k& f- E7 J' L+ k9 N2 u
3.6.3.3验证jwt令牌//资源服务使用公钥验证jwt的合法性,并对jwt解码@Testpublic void testVerify(){//jwt令牌String token="eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJleHQiOiIxIiwicm9sZXMiOiJyMDEscjAyIiwibmFtZSI6Im1ydCIsI mlkIjoiMTIzIn0.KK7_67N5d1Dthd1PgDHMsbi0UlmjGRcm_XJUUwseJ2eZyJJWoPP2IcEZgAU3tUaaKEHUf9wSRwaDgwhrw fyIcSHbs8oy3zOQEL8j5AOjzBBs7vnRmB7DbSaQD7eJiQVJOXO1QpdmEFgjhc_IBCVTJCVWgZw60IEW1_Lg5tqaLvCiIl26K 48pJB5f‐le2zgYMzqR1L2LyTFkq39rG57VOqqSCi3dapsZQd4ctq95SJCXgGdrUDWtD52rp5o6_0uq‐ mrbRdRxkrQfsa1j8C5IW2‐T4eUmiN3f9wF9JxUK1 XC1OQkOn‐ZTBCdqwWIygDFbU7sf6KzfHJTm5vfjp6NIA"; / x2 v; Y& O% x" [# k% V1 i
//公钥String publickey = "‐‐‐‐‐BEGIN PUBLIC KEY‐‐‐‐‐ MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAijyxMdq4S6L1Af1rtB8SjCZHNgsQG8JTfGy55eYvzG0B/E4AudR2 prSRBvF7NYPL47scRCNPgLnvbQczBHbBug6uOr78qnWsYxHlW6Aa5dI5NsmOD4DLtSw8eX0hFyK5Fj6ScYOSFBz9cd1nNTvx 2+oIv0lJDcpQdQhsfgsEr1ntvWterZt/8r7xNN83gHYuZ6TM5MYvjQNBc5qC7Krs9wM7UoQuL+s0X6RlOib7/mcLn/lFLsLD dYQAZkSDx/6+t+1oHdMarChIPYT1sx9Dwj2j2mvFNDTKKKKAq0cv14Vrhz67Vjmz2yMJePDqUi0JYS2r0iIo7n8vN7s83v5u OQIDAQAB‐‐‐‐‐END PUBLIC KEY‐‐‐‐‐";
3 t* N. A6 f" {1 i5 Z) g3 B //校验jwtJwt jwt = JwtHelper.decodeAndVerify(token, new RsaVerifier(publickey));//获取jwt原始内容String claims = jwt.getClaims();
9 x5 P) ?0 Q) ]7 m7 k6 z- f //jwt令牌String encoded = jwt.getEncoded(); System.out.println(encoded);}4认证接口开发4.1需求分析用户登录的流程图如下:
: i7 J* N$ l) E% E 执行流程:1、用户登录,请求认证服务2、认证服务认证通过,生成jwt令牌,将jwt令牌及相关信息写入Redis,并且将身份令牌写入cookie3、用户访问资源页面,带着cookie到网关4、网关从cookie获取token,并查询Redis校验token,如果token不存在则拒绝访问,否则放行 / C; P+ {8 N4 g! \
5、用户退出,请求认证服务,清除redis中的token,并且删除cookie中的token使用redis存储用户的身份令牌有以下作用:1、实现用户退出注销功能,服务端清除令牌后,即使客户端请求携带token也是无效的。
- T6 v9 w5 E. j5 J! [ 2、由于jwt令牌过长,不宜存储在cookie中,所以将jwt令牌存储在redis,由客户端请求服务端获取并在客户端存 储4.2Redis配置4.2.1安装Redis1、安装Redis服务下载Windows版本的redis:。 ! I0 Q9 B- n3 L
https://github.com/MicrosoftArchive/redis/tags 下载Redis-x64-3.2.100版本,解压Redis-x64-3.2.100.zip进入cmd命令行,进入Redis-x64-3.2.100目录。 " a, b. c' S0 i# C
运行:redis‐server redis.windows.conf2 S4 X4 J3 H/ A+ ?
出现 下图说明 redis启动成功: ' M, B* O [, y
注册为服务:redis‐server ‐‐service‐install redis.windows‐service.conf ‐‐loglevel verbose
' v3 M" v) z5 @$ x 刷新服务,会看到多了一个redis服务。 / b5 K$ }/ W. u8 H9 D
常用的redis服务命令如下: 进入redis安装目录:卸载服务:redis-server.exe --service-uninstall开启服务:redis-server.exe --service-start ) |) Q! c( J- |- y6 |
停止服务:redis-server.exe --service-stop2、redis-desktop-manager下载windows版本的redis客户端:https://redisdesktop.com/download 下载 8 Q& j, ]3 T- d6 z
redis-desktop-manager-0.9.2.806.exe安装后启动redis客户端: 配置redis链接:
9 ?# E {! Z* O k3 P 连接成功:
/ K* s3 s- n) S1 ^0 z 4.2.2redis连接配置在认证服务的application.yml文件中添加如下配置:spring:
; V3 a8 X5 I2 w* n5 z application:7 d6 p' D2 `- e4 {! e7 g
name: xc‐service‐ucenter‐auth redis:4 [) X2 i: Q' v# o9 c
host: ${REDIS_HOST:127.0.0.1} port: ${REDIS_PORT:6379}
( \# ~4 W8 w! {: V$ T timeout: 5000 #连接超时 毫秒, V, Z; [! G( \
jedis:( `, P/ v3 `1 T* Z
pool:
6 E& j- A* v L5 ^ maxActive: 3! z( a# r Z# y$ q! ]
maxIdle: 31 C X, ?. p7 v0 [, g' r- K
minIdle: 1* Y$ s5 X! x& \
maxWait: ‐1 #连接池最大等行时间 ‐1没有限制
2 w9 e( ?% K* d. C$ I + R) E1 K6 N" @+ a9 u2 [
4.2.3测试@SpringBootTest @RunWith(SpringRunner.class) public class RedisTest {
5 S1 `8 D) |& h. \8 p$ v @Autowired9 |! D2 c2 z: P) T$ |
private StringRedisTemplate stringRedisTemplate; @Test
" g# Q# U" G6 r1 \% L% e7 a public void testRedis(){
0 ^" N# {" P5 M- } //定义key _, @) v: W' d2 |$ n
String key = "user_token:9734b68f‐cf5e‐456f‐9bd6‐df578c711390";# n5 z. E+ x8 s& e5 O0 Z0 F% |
//定义Map
. M" u+ P1 @* Z6 o: w# N$ j Map mapValue = new HashMap<>(); mapValue.put("id","101"); mapValue.put("username","itcast");: S. ~: l- y( J y
String value = JSON.toJSONString(mapValue);0 G% @$ _8 v4 s9 v
// 向 redis 中 存 储 字 符 串 stringRedisTemplate.boundValueOps(key).set(value,60, TimeUnit.SECONDS);5 |% G" s2 q* S' ~# Y R* b* l8 M2 }
//读取过期时间,已过期返回‐2! g+ ^" R& d* `
Long expire = stringRedisTemplate.getExpire(key);& t4 {, O/ x1 s+ t x. h
//根据key获取value9 ~: b& f4 w2 \9 ~
String s = stringRedisTemplate.opsForValue().get(key); System.out.println(s);5 v" [/ m L$ ]$ \6 k0 S3 s
}0 f' p9 }! D; U3 H
}
3 u l8 t4 a; Z: x5 _" S. V2 }& ~ * |4 Q; G2 Z' d1 n
4.3认证服务4.3.1需求分析认证服务需要实现的功能如下:1、登录接口前端post提交账号、密码等,用户身份校验通过,生成令牌,并将令牌存储到redis将令牌写入cookie2、退出接口校验当前用户的身份为合法并且为已登录状态。
! g3 ` W' ?5 h/ b6 } 将令牌从redis删除删除cookie中的令牌。业务流程如下: ' W, p( g/ V( n: o8 m& Y
4.3.2Api接口@Api(value = "用户认证",description = "用户认证接口") public interface AuthControllerApi {( r! [6 r' _( S) b
@ApiOperation("登录")8 ~! ]4 F/ z* x- D4 ?
public LoginResult login(LoginRequest loginRequest);: N! a q. Z9 n- Q; V. v7 t1 ^0 B/ T. Y
@ApiOperation("退出")
3 M: R9 q) h* v' _& m& g- [! C public ResponseResult logout();
{7 q! T/ S! F. ?; N }
' a" y- `; P3 n4 @- O
1 ]+ B8 d+ E8 L. t2 a# m 4.3.3配置参数在application.yml中配置参数auth:
/ C: ^! K+ ~+ d( f* }+ m3 G tokenValiditySeconds: 1200 #token存储到redis的过期时间clientId: XcWebApp
- T8 @. S0 _; E9 E clientSecret: XcWebApp cookieDomain: localhost cookieMaxAge: ‐1' L2 M7 j7 N3 c% s- q! C( m! l
4 r0 A+ Z$ K S$ F$ r 4.3.4申请令牌测试为了不破坏Spring Security的代码,我们在Service方法中通过RestTemplate请求Spring Security所暴露的申请令牌接口来申请令牌,下边是测试代码: % K% y) [6 H! V( c7 `7 Q
@SpringBootTest @RunWith(SpringRunner.class) public class TestClient {
( y! m0 R* K- r2 {/ [% a5 E$ \ @Autowired8 P9 ^4 Z# ?5 U. G
LoadBalancerClient loadBalancerClient;% z* p: z8 ^+ ^! h0 y
@Autowired/ Q/ {6 P! H3 V) Y" r
RestTemplate restTemplate;
; Z- O7 k4 R& X" c @Test
* H$ h3 r4 W0 d" g public void testClient(){
$ b$ E# \8 b9 @& s) [/ c s+ p1 c //采用客户端负载均衡,从eureka获取认证服务的ip 和端口
, |9 Q' ] z" N, t ` ServiceInstance serviceInstance = loadBalancerClient.choose(XcServiceList.XC_SERVICE_UCENTER_AUTH);- ~! t, c: ~0 a) U6 V8 _) _
URI uri = serviceInstance.getUri(); S+ n8 Q. @+ z; L }& t
String authUrl = uri+"/auth/oauth/token";
+ `2 H. {2 u: k6 w. R3 H, x# J @SpringBootTest @RunWith(SpringRunner.class) public class TestClient {
5 x' u" v; Y* V& I; J" A8 A @Autowired
8 `4 \ n8 E! {! @* r9 q. ? LoadBalancerClient loadBalancerClient;% s( ~# R1 k+ n; v9 x2 c! w/ ~; r
@Autowired
1 v X2 ?9 f& ~( N8 s$ l$ b RestTemplate restTemplate; h1 L7 }9 X) M5 q( r& o9 F$ u: B
@Test2 w. b, g% u/ O: _8 d! M C5 Q: Y
public void testClient(){
2 ~# Z$ K r- C0 J* U //采用客户端负载均衡,从eureka获取认证服务的ip 和端口% T7 j2 b9 q5 b0 V& G
ServiceInstance serviceInstance = loadBalancerClient.choose(XcServiceList.XC_SERVICE_UCENTER_AUTH);
3 g7 m3 k# J$ K4 D( T3 F7 q URI uri = serviceInstance.getUri();+ o6 ^( ?1 E7 L9 e
String authUrl = uri+"/auth/oauth/token";
/ r4 J2 @7 O7 K - ~( z2 g$ u; R0 n3 g% M/ w, U* \
4.3.4Dao暂时使用静态数据,待用户登录调通再连接数据库校验用户信息4.3.5Service调用认证服务申请令牌,并将令牌存储到 redis1、AuthToken创建 AuthToken模型类,存储申请的令牌,包括身份令牌、刷新令牌、jwt令牌身份令牌:用于校验用户是否认证。
' _8 W- [: v5 m# c 刷新令牌:jwt令牌快过期时执行刷新令牌jwt令牌:用于授权@Data @ToString
$ `$ j) G! h ?1 H* x @NoArgsConstructor public class AuthToken {
/ P4 l! w$ c/ G! S8 {9 B% ` String access_token;//身份token# N2 O5 r$ ^: B* L- X+ d5 Z
String refresh_token;//刷新token String jwt_token;//jwt令牌
: d. p' i" b+ j0 S! O }
9 z6 Y8 d f, a8 N' r5 l1 | , }7 X/ n6 h) A1 Z4 k9 E
申请令牌的service方法如下:@Service5 C& k/ d, {3 ~( Y, w
public class AuthService {7 L' U, t: I# w
private static final Logger LOGGER = LoggerFactory.getLogger(AuthService.class); @Value("${auth.tokenValiditySeconds}")) e" y. D- F7 Y' _. k8 M- @/ e
int tokenValiditySeconds;
3 c' l A B, Z* l @Autowired- z* L+ x3 m9 }) I& s; x; Y5 @
RestTemplate restTemplate; @Autowired g8 I7 N8 b" g7 b7 O% A9 b" S
LoadBalancerClient loadBalancerClient; @Autowired/ y/ |8 f* i7 q
StringRedisTemplate stringRedisTemplate;
, j( l0 P9 o, l# N7 ]5 ^ //认证方法
6 M( k P) {+ C public AuthToken login(String username,String password,String clientId,String clientSecret){
3 z4 C+ X' c# P //申请令牌0 v2 b- H( o% S! _
AuthToken authToken = applyToken(username,password,clientId, clientSecret); if(authToken == null){4 j4 d0 q9 a+ ` q1 P
ExceptionCast.cast(AuthCode.AUTH_LOGIN_APPLYTOKEN_FAIL);
/ a! b z2 {; h& d }3 \# j, e z" i/ H+ W
//将 token存储到redis
6 H+ p5 E( _* V ^4 U' } String access_token = authToken.getAccess_token(); String content = JSON.toJSONString(authToken);
/ z& _& i. ? q boolean saveTokenResult = saveToken(access_token, content, tokenValiditySeconds);
4 d7 T0 G, k. B( l8 W: Y) u if(!saveTokenResult){
. ]; x. E4 x! U/ z- q) B1 n" L. f4 p ExceptionCast.cast(AuthCode.AUTH_LOGIN_TOKEN_SAVEFAIL);
( f- o4 c' s) E2 U }
1 R- D* m8 G& x, V; n: [0 p, T return authToken;
5 S* t* ^* F. \$ k, V# T- t }
' _! Y1 e& h) ~% {1 G9 W. M( G //存储令牌到redis4 ]0 x" X; i& {! I6 K+ F$ G! j% l4 q
private boolean saveToken(String access_token,String content,long ttl){4 K. z' p! Q# m9 p1 G
//令牌名称
' q1 W, h/ E& N9 F* i String name = "user_token:" + access_token;- [! c8 h5 }+ S
//保存到令牌到redis
; n: L8 ^: }6 h) _! R! p stringRedisTemplate.boundValueOps(name).set(content,ttl, TimeUnit.SECONDS);! T! |: {- Y# c* g8 w& j h8 N8 Y
//获取过期时间1 k" `. Z1 c6 D; Y
Long expire = stringRedisTemplate.getExpire(name); return expire>0;
( B2 ]$ @4 ?+ Y6 l; ` }8 e- Q# J ?) a
//认证方法
( x2 ]* r( i. \ private AuthToken applyToken(String username,String password,String clientId,String clientSecret){
4 R, a# F1 k- e0 l3 ^ //选中认证服务的地址) @" u+ L4 P. X! r0 c
ServiceInstance serviceInstance = loadBalancerClient.choose(XcServiceList.XC_SERVICE_UCENTER_AUTH);
2 E0 g/ F' @. G" G( n if (serviceInstance == null) { LOGGER.error("choose an auth instance fail");
' e# v9 \8 X# Z+ i1 d' q/ N" C* y) n ExceptionCast.cast(AuthCode.AUTH_LOGIN_AUTHSERVER_NOTFOUND);
' R$ Y# ]8 m% w/ E9 H }/ ?% g( r( H* [0 S- G0 {
//获取令牌的url; v+ g+ {1 C% c) p& P
String path = serviceInstance.getUri().toString()+"/auth/oauth/token";6 @" |7 o- l9 J
//定义body/ z: [0 A3 s* `8 D4 d% [/ y5 t
MultiValueMap formData = new LinkedMultiValueMap<>();# s& U' F3 I$ M! ?6 Y! b
//授权方式; A; H: F! h& f$ M B
formData.add("grant_type", "password");
& z" W( [+ Q6 S //账号formData.add("username",username);0 i: y/ r1 d* v
//密码, ^3 X6 \! ~) |- o0 P
formData.add("password", password);
! n* C2 a$ `/ V% T! a1 @1 D! q //定义头) g% j2 q D+ A, Y, p
MultiValueMap header = new LinkedMultiValueMap<>(); header.add("Authorization", httpbasic(clientId,clientSecret));/ q% s0 l* G9 ~! ?0 [. m5 j0 l
//指定 restTemplate当遇到400或401响应时候也不要抛出异常,也要正常返回值
4 N$ f1 U$ X0 p- V' M' i- Y restTemplate.setErrorHandler(new DefaultResponseErrorHandler(){
* E3 D/ w Y% z) j$ [ W6 _ @Override' X% C' E' R3 H8 C0 L2 J+ S6 |
public void handleError(ClientHttpResponse response) throws IOException {
) ^" H% d- D6 f) P2 S& W7 c //当响应的值为400或401时候也要正常响应,不要抛出异常if(response.getRawStatusCode()!=400 && response.getRawStatusCode()!=401){
# v4 ?5 \1 ?5 q9 J' K super.handleError(response);
0 G0 v8 e, }- I2 r }! M/ t# x: i$ x, x
}
4 Y# H: A0 m' C/ [: V8 y" t; ?; x });
; {2 C( T9 ], W$ Z Map map = null; try {* Q G7 L7 }! G: a& ` @- t
//http请求spring security的申请令牌接口
8 H8 d& W- l& j+ K7 q# Z% O9 S1 m ResponseEntity mapResponseEntity = restTemplate.exchange(path, HttpMethod.POST,
2 n3 W/ U5 O( t. s new HttpEntity(formData, header), Map.class); map = mapResponseEntity.getBody();
- S$ F% v4 e3 m1 C, l- Q i } catch (RestClientException e) { e.printStackTrace();3 M3 v0 w( i5 Z! I% W; X
LOGGER.error("request oauth_token_password error: {}",e.getMessage()); e.printStackTrace(); ExceptionCast.cast(AuthCode.AUTH_LOGIN_APPLYTOKEN_FAIL);7 o$ A7 N) t! N) m7 H1 I D! Z% Z
}! E9 S! ^) c9 _, Y' T! _: p
if(map == null ||
1 x. I, l* P# T2 r/ ?. ~ map.get("access_token") == null || map.get("refresh_token") == null ||7 t: ]$ P* I. E
map.get("jti") == null){//jti是jwt令牌的唯一标识作为用户身份令牌! l! @# c; c; d& t( M# W
ExceptionCast.cast(AuthCode.AUTH_LOGIN_APPLYTOKEN_FAIL);
- n/ Y; [1 F9 P' m2 Q6 X } U, n7 k& N# c8 s5 D' q
AuthToken authToken = new AuthToken();% } O7 g- R9 q( f
//访问令牌(jwt)
" C6 c; U; r' c1 \8 k* X, x' V String jwt_token = (String) map.get("access_token");
0 H/ Q) C( Y) I7 R //刷新令牌(jwt), G f" ]1 }5 y6 c
String refresh_token = (String) map.get("refresh_token");; p) P1 }8 s; h7 J1 e: F# m
//jti,作为用户的身份标识) Y7 r3 _) m4 z4 _2 o; O
String access_token = (String) map.get("jti"); authToken.setJwt_token(jwt_token); authToken.setAccess_token(access_token); authToken.setRefresh_token(refresh_token); return authToken;4 c" Y2 l1 s# m- S/ g5 T
}6 g: p' e; i& d4 `8 u1 I0 l( T
//获取httpbasic认证串( K( M* f1 I/ ]7 \
private String httpbasic(String clientId,String clientSecret){5 E0 ]. Z3 z' O, x5 n7 J a1 P
//将客户端id和客户端密码拼接,按“客户端id:客户端密码” String string = clientId+":"+clientSecret;! T5 e+ k8 _8 C2 h( I
//进行base64编码
/ y* q$ s# M: C9 J2 I4 v6 @# g byte[] encode = Base64.encode(string.getBytes()); return "Basic "+new String(encode);
1 {$ u: B; a9 `2 k/ A }
& k$ v; F( U1 _& X }
0 s- Q. e) P7 v' ^$ e3 r4 F8 Z" T% N: h
. K% `+ F- l$ ?2 c5 y. ] 4.3.6ControllerAuthController代码如下:@RestController
8 S. K9 [$ a" @% f: H public class AuthController implements AuthControllerApi { @Value("${auth.clientId}")
% o- I7 q- P" g$ H& A String clientId; @Value("${auth.clientSecret}")
# I6 w+ }/ Q7 F, }$ `. i( H String clientSecret;1 O% M" n8 k* Y* a6 X( P
@Value("${auth.cookieDomain}") String cookieDomain; @Value("${auth.cookieMaxAge}") int cookieMaxAge;
9 w1 W7 V, e* } @Value("${auth.tokenValiditySeconds}") int tokenValiditySeconds;
# W$ V7 u( M7 `5 [ @Autowired" C- ?" G9 H! |6 z0 m
AuthService authService;
/ t" E' y( L# y7 E2 X9 k @Override @PostMapping("/userlogin")+ h6 [/ H2 q# s$ q8 E9 L
public LoginResult login(LoginRequest loginRequest) {: ]6 I2 F! i/ _2 Z1 Y+ d: X
//校验账号是否输入! |6 P- A. C5 R0 Q$ ]% B& u
if(loginRequest == null || StringUtils.isEmpty(loginRequest.getUsername())){ ExceptionCast.cast(AuthCode.AUTH_USERNAME_NONE);
1 A1 l% x! P. P& t, m }
; G" Q5 d) Y2 L' T- X+ C& _ //校验密码是否输入if(StringUtils.isEmpty(loginRequest.getPassword())){
, x5 Y2 ~4 C8 n3 b; k/ | ExceptionCast.cast(AuthCode.AUTH_PASSWORD_NONE);
. A3 q4 F( m# {) Y* x }0 R9 b$ f3 A0 ^3 k
AuthToken authToken = authService.login(loginRequest.getUsername(), loginRequest.getPassword(), clientId, clientSecret);# G& v) ], J) p
//将令牌写入cookie" d- b! z/ [3 h& M, c$ o) Z; c
//访问token
$ [2 q2 `5 ?2 Z' J String access_token = authToken.getAccess_token();
l# _, d8 s$ N# j4 ]- n //将访问令牌存储到cookie saveCookie(access_token);
; ~' g( z1 [$ @( E return new LoginResult(CommonCode.SUCCESS,access_token);+ a: _" k2 L( J6 T+ v* C
}0 M- x; S+ y0 p9 k5 p) }3 W
//将令牌保存到cookie/ o" C7 U$ e$ G
private void saveCookie(String token){
% E, J3 j' L6 ^* L$ A% \ HttpServletResponse response = ((ServletRequestAttributes) RequestContextHolder.getRequestAttributes()).getResponse();- p: J1 J7 A5 R
//添加cookie 认证令牌,最后一个参数设置为false,表示允许浏览器获取2 W Z7 B( H: N$ ?4 @
CookieUtil.addCookie(response, cookieDomain, "/", "uid", token, cookieMaxAge, false);. N( l* L0 w/ C" g; r/ x
}
2 Y* x8 T6 U g- v2 w' |9 r) \ @Override @PostMapping("/userlogout") public ResponseResult logout() {% J# |- E* c" s- I
return null;( ?6 J% H; Y0 r* o
}% p* P o5 J6 }$ E+ g" B; f9 n# z1 L
} R% A( e: e& M+ S$ b/ V8 Q
A# V+ |3 ~& z4 Y1 {6 k$ q 4.3.7登录url放行认证服务默认都要校验用户的身份信息,这里需要将登录url放行在WebSecurityConfig类中重写 configure(WebSecurity web)方法,如下:@Override
+ l& T! j4 i1 [& T1 j public void configure(WebSecurity web) throws Exception { web.ignoring().antMatchers("/userlogin");
6 e6 X2 K# @( E' Q }* q( N2 u: |$ A
。
6 e2 z% e& H3 T' i5 p1 J4 I 4.3.8测试认证接口使用postman测试:Post请求:http://localhost:40400/auth/userlogin
& e5 N, q, `% z- r7 g 4.3.9测试写入Cookiecookie最终会写到xuecheng.com域名下,可通过nginx代理进行认证,测试cookie是否写成功1、配置nginx代理在ucenter.xuecheng.com下配置代理路径。
9 N, ?- o/ j: h) ^; C! S" { #认证
& c" m/ D" r& D* Z6 V7 A+ ]" P location ^~ /openapi/auth/ {: Z0 K V u! A4 e& C
proxy_pass http://auth_server_pool/auth/;( C& \6 {) P9 D2 l* Y
}
8 P9 n5 L1 W! ^" @9 G* Y 添加:#认证服务% W- I" m8 H K* ^
upstream auth_server_pool{
' w0 Q3 ~. G: `; W; B server 127.0.0.1:40400 weight=10;2 N5 F' x; t" d6 u
}. r& Q3 C4 B1 n4 S
" d, N8 v ]0 {& |
2、请求:http://ucenter.xuecheng.com/openapi/auth/userlogin观察cookie写入结果 - [% M7 z( c4 F9 @ P: `! m+ }! O
' l( O* P0 U9 l0 o/ M
; h$ V/ _7 o, N" Y! k, F& v0 Q4 \, L# f- O! i9 @0 I
! _: _0 X9 o! D/ t" J |