视频1 视频21 视频41 视频61 视频文章1 视频文章21 视频文章41 视频文章61 推荐1 推荐3 推荐5 推荐7 推荐9 推荐11 推荐13 推荐15 推荐17 推荐19 推荐21 推荐23 推荐25 推荐27 推荐29 推荐31 推荐33 推荐35 推荐37 推荐39 推荐41 推荐43 推荐45 推荐47 推荐49 关键词1 关键词101 关键词201 关键词301 关键词401 关键词501 关键词601 关键词701 关键词801 关键词901 关键词1001 关键词1101 关键词1201 关键词1301 关键词1401 关键词1501 关键词1601 关键词1701 关键词1801 关键词1901 视频扩展1 视频扩展6 视频扩展11 视频扩展16 文章1 文章201 文章401 文章601 文章801 文章1001 资讯1 资讯501 资讯1001 资讯1501 标签1 标签501 标签1001 关键词1 关键词501 关键词1001 关键词1501 专题2001
在Angular中使用JWT认证方法示例
2020-11-27 22:08:02 责编:小采
文档

签名

签名由base编码后的头、base编码后的荷载和secret组成。

例如,将上面的两个编码后的字符串都用句号 . 连接在一起(头部在前),就形成了:

ewogICJhbGciOiAiSFMyNTYiLAogICJ0eXAiOiAiSldUIgp9.ewogICJzdWIiOiAiMTIzNDU2Nzg5MCIsCiAgIm5hbWUiOiAidGM5MDExIiwKICAiYWRtaW4iOiB0cnVlLAogICJleHAiOiAxNDQxNTk0NzIyCn0=

然后,将上面拼接完的字符串用secret作为秘钥进行HS256加密。

HMACSHA256(
 baseUrlEncode(header) + "." +
 baseUrlEncode(payload),
 secret)

使用JWT

一般在会在请求头中加入 Authorization ,并加上 Bearer 进行标注:

fetch('api/v1/user/1', {
 headers: {
 'Authorization': 'Bearer ' + token
 }
})

服务端会验证token,如果验证通过就会返回相应的资源。

不过要注意,因为荷载是base编码,这种编码可以对称解密,所以在荷载中不应该存放用户的敏感信息,比如密码。所以一般JWT用来向Web传递一些非敏感信息,例如用户名、所属部门等。

在Angular中使用JWT

这里我们以Angular6和koa2(使用TypeScript)为例,介绍一下如何在你的Angular应用中使用JWT。

服务端

首先在jwt.io 官网上找到node的JWT的库: jsonwebtoken 。

可以看到官网把这个库对标准注册声明字段的支持情况以及加密方式的支持情况都列出来了。除了这个库,还需要使用koa一个中间件: koa-jwt ,用来对HTTP请求进行JWT认证。你可以通过下面命令安装这两个库:

npm i koa-jwt jsonwebtoken --save

app.ts 中:

import * as jwt from 'koa-jwt';

app.use(jwt({
 secret: Secret
 }).unless({
 path: [/\/register/, /\/login/, /\/groups/],
 }));

这里的secret就是你自己定义的秘钥, unless 方法用来排除一些不需要进行JWT认证的api。koa-jwt中间件需要放在路由中间件之前,这样就可以对所有路由(除了 unless 中设置的路由外)进行JWT的检查。只有正确之后才能正确的访问。

除此之外,你还要自定义一个401错误处理的中间件,如果没有token,或者token失效,该中间件会给出对应的错误信息。如果没有自定义中间件的话,会直接将 koa-jwt 暴露的错误信息直接返回给用户。

export const errorHandle = (ctx, next) => {
 return next().catch((err) => {
 if (err.status === 401) {
 ctx.status = 401;
 handleError({ctx, message: '登录过期,请重新登录', err: err.originalError ? err.originalError.message : err.message});
 } else {
 throw err;
 }
 });
};

然后把这个中间件放在koa-jwt之前:

app.use(errorHandle);

app.use(jwt({
 secret: Secret
}).unless({
 path: [/\/register/, /\/login/, /\/groups/],
}));

在用户登陆时候,生成token,返回给客户端:

// 生成 token 返回给客户端
const token = jsonwebtoken.sign({
 user: {
 workNumber: user.workNumber,
 realName: user.realName,
 group: user.group,
 role: user.role
 },

 // 设置 token 过期时间
 exp: Math.floor(Date.now() / 1000) + (60 * 60 * 24), // 1天
}, Secret);

handleSuccess({
 ctx,
 message: '登陆成功!',
 response: {
 token,
 lifeTime: Math.floor(Date.now() / 1000) + (60 * 60 * 24) // 1天
 }
});

需要注意的是,在使用 jsonwebtoken.sign() 时,需要传入的 secret 参数,这里的 secret 必须要与 前面设置 jwt() 中的 secret 一致。

客户端

在Angular中,我们需要使用 @auth0/angular2-jwt 这个库来帮助我们在Angular中处理JWT:

npm install @auth0/angular-jwt --save

app.module.ts 中引入 JwtModule 这个模块(注意,引入该模块的同时也要引入 HttpClientModule 模块):

import { JwtModule } from '@auth0/angular-jwt';
import { HttpClientModule } from '@angular/common/http';

export function tokenGetter(){
 return localStorage.getItem('token');
}

@NgModule({
 bootstrap: [AppComponent],
 imports: [
 // ...
 HttpClientModule,
 JwtModule.forRoot({
 config: {
 tokenGetter: tokenGetter,
 whitelistedDomains: ['localhost:3001'],
 blacklistedRoutes: ['localhost:3001/auth/']
 }
 })
 ]
})
export class AppModule {}

JwtModuleconfig 中:

tokenGetter :从localStorage中获取token;

whitelistedDomains :允许发送认证的请求的域名;

blacklistedRoutes :你不希望替换header中 Authorization 信息的api列表。

接着创建一个全局的 auth.service.ts 服务,方便在登陆的时候获取用户相关信息及权限,这个服务中有个 login 方法,用来处理登陆后返回的token信息,并把token存到LocalStorage中,这样在token失效前,下次用户登陆时就不需要输入用户名和密码:

login(loginInfo: LoginInfo): Observable<boolean> {
 return this.passportService.postLogin(loginInfo).pipe(map(
 (res: LoginRes) => {
 // 登陆成功后获取token,并存到localStorage
 this.storageService.setLocalStorage('token', res.token);
 const decodedUser = this.decodeUserFromToken(res.token);
 this.setCurrentUser(decodedUser);
 this.msg.success('登录成功!');
 return this.loggedIn;
 }
 )
 );
}

在这个 login 方法中, decodeUserFromToken 封装了 @auth0/angular2-jwt 中提供的 decodeToken 方法,注意 decodeToken 方法解析出来的只是服务端 jsonwebtoken.sign() 中的JSON对象,所以需要通过 . 操作获取 jsonwebtoken.sign() 中定义的 user

decodeUserFromToken(token): User {
 return this.jwtHelperService.decodeToken(token).user;
}

在这个服务中,定义了两个变量 loggedInisAdmin ,用来标识用户是否登录和其相应的权限,方便在Angular路由中控制可以访问的视图。

有登录当然就有登出,登出时只需把token从LocalStorage中移除,并把几个变量重置即可:

logout(): void {
 this.storageService.removeLocalStorage('token');
 this.loggedIn = false;
 this.isAdmin = false;
 this.currentUser = new User();
}

AuthService 的完整代码如下:

import { Injectable, Injector } from '@angular/core';
import { Router } from '@angular/router';

import { JwtHelperService } from '@auth0/angular-jwt';
import { Observable } from 'rxjs';
import { map } from 'rxjs/operators';

import { LoginInfo, LoginRes, User } from '../../views/passport/interfaces/passport';
import { PassportService } from '../../views/passport/services/passport.service';
import { StorageService } from '../storage/storage.service';
import { NzMessageService } from 'ng-zorro-antd';


@Injectable()
export class AuthService {
 public loggedIn = false;
 public isAdmin = false;
 public currentUser: User = new User();

 constructor(private jwtHelperService: JwtHelperService,
 private router: Router,
 private injector: Injector,
 private passportService: PassportService,
 private storageService: StorageService) {
 const token = localStorage.getItem('token');
 if (token) {
 const decodedUser = this.decodeUserFromToken(token);
 this.setCurrentUser(decodedUser);
 }
 }

 get msg(): NzMessageService {
 return this.injector.get(NzMessageService);
 }

 login(loginInfo: LoginInfo): Observable<boolean> {
 return this.passportService.postLogin(loginInfo).pipe(map(
 (res: LoginRes) => {
 this.storageService.setLocalStorage('token', res.token);
 const decodedUser = this.decodeUserFromToken(res.token);
 this.setCurrentUser(decodedUser);
 this.msg.success('登录成功!');
 return this.loggedIn;
 }
 )
 );
 }

 logout(): void {
 this.storageService.removeLocalStorage('token');
 this.loggedIn = false;
 this.isAdmin = false;
 this.currentUser = new User();
 }

 decodeUserFromToken(token): User {
 return this.jwtHelperService.decodeToken(token).user;
 }

 setCurrentUser(decodedUser): void {
 this.loggedIn = true;
 this.currentUser.workNumber = decodedUser.workNumber;
 this.currentUser.realName = decodedUser.realName;
 this.currentUser.group = decodedUser.group;
 this.currentUser.role = decodedUser.role;
 this.isAdmin = decodedUser.role > 10;
 delete decodedUser.role;
 }
}

至此,在你的Angular应用中就引入了JWT认证,当然,你也可以不使用 @auth0/angular2-jwt ,自己手写一个HTTP,手动设置每次请求的header:

@Injectable()
export class AuthInterceptor implements HttpInterceptor {

 intercept(req: HttpRequest<any>,
 next: HttpHandler): Observable<HttpEvent<any>> {

 const token = localStorage.getItem("token");

 if (token) {
 const cloned = req.clone({
 headers: req.headers.set("Authorization",
 "Bearer " + token)
 });

 return next.handle(cloned);
 }
 else {
 return next.handle(req);
 }
 }
}

不过这样的话,token Base解码也需要自己手写,稍微麻烦一点。

总结

JWT因为是基于JSON的,所以通用性很强,很多语言已经存在jwt相关的库。不过使用JWT的时候需要注意以下几点:

  • 保存好secret秘钥,这个秘钥只能在服务端存在
  • 给token设置一个过期时间,因为一旦token生成,它就永远有效,除非token密钥被更改或过期
  • 在payload中只能存储一些业务逻辑所必要的非敏感信息
  • 下载本文
    显示全文
    专题