Egg.js构建JWT/OAuth认证服务器：探索更安全、更友好的身份认证方案

2023-10-02 21:19:44

随着互联网的快速发展，Web应用程序的安全性和易用性日益重要。Egg.js作为一款备受推崇的Node.js框架，以其高性能、易扩展、高安全性等特点脱颖而出。为了让您的Web应用程序更上一层楼，本文将指导您使用Egg.js构建一个JWT/OAuth认证服务器，帮助您轻松实现用户认证和授权。

一、JWT/OAuth认证简介

JSON Web Token (JWT)是一种基于JSON的开放标准，它可以安全地传输信息并在各方之间进行验证。JWT认证机制允许您使用数字签名来验证用户身份，而无需在每次请求中都发送密码。这使得JWT认证更加安全、高效。

OAuth是一种授权协议，它允许用户授权第三方应用程序访问其受保护的资源。OAuth认证机制允许您使用授权码或访问令牌来授予第三方应用程序访问权限，而无需泄露用户密码。这使得OAuth认证更加安全、便捷。

二、Egg.js JWT/OAuth认证服务器构建步骤

1. 安装Egg.js

npm install egg-core --save

2. 创建Egg.js项目

egg init my-egg-app

3. 安装Egg.js JWT/OAuth插件

npm install egg-jwt egg-oauth2 --save

4. 配置Egg.js JWT/OAuth插件

// config/plugin.js
exports.jwt = {
  enable: true,
  secret: 'my-secret',
};

exports.oauth2 = {
  enable: true,
  clientID: 'my-client-id',
  clientSecret: 'my-client-secret',
  grants: ['authorization_code', 'password'],
};

5. 编写Egg.js JWT/OAuth认证控制器

// app/controller/auth.js
const Controller = require('egg').Controller;

class AuthController extends Controller {
  async login() {
    const { username, password } = this.ctx.request.body;
    const user = await this.ctx.service.user.login(username, password);
    if (!user) {
      this.ctx.body = {
        code: 401,
        message: '用户名或密码错误',
      };
      return;
    }

    const token = this.app.jwt.sign({ id: user.id, username: user.username });
    this.ctx.body = {
      code: 200,
      message: '登录成功',
      token,
    };
  }

  async oauth() {
    const { code } = this.ctx.request.query;
    const token = await this.ctx.oauth2.getToken(code);
    if (!token) {
      this.ctx.body = {
        code: 401,
        message: '获取Token失败',
      };
      return;
    }

    const user = await this.ctx.service.user.findByOAuth(token.accessToken);
    if (!user) {
      user = await this.ctx.service.user.createByOAuth(token.accessToken);
    }

    const jwtToken = this.app.jwt.sign({ id: user.id, username: user.username });
    this.ctx.body = {
      code: 200,
      message: '登录成功',
      token: jwtToken,
    };
  }
}

module.exports = AuthController;

6. 编写Egg.js JWT/OAuth认证服务

// app/service/user.js
const Service = require('egg').Service;

class UserService extends Service {
  async login(username, password) {
    const user = await this.ctx.model.User.findOne({
      where: {
        username,
        password,
      },
    });
    return user;
  }

  async findByOAuth(accessToken) {
    const user = await this.ctx.model.User.findOne({
      where: {
        oauthAccessToken: accessToken,
      },
    });
    return user;
  }

  async createByOAuth(accessToken) {
    const user = await this.ctx.model.User.create({
      oauthAccessToken: accessToken,
    });
    return user;
  }
}

module.exports = UserService;

7. 编写Egg.js JWT/OAuth认证路由

// config/router.js
exports.router = {
  '/login': {
    controller: 'auth',
    method: 'post',
  },
  '/oauth': {
    controller: 'auth',
    method: 'get',
  },
};