用 Fastify 实现 JWT 授权认证机制-JavaScript中文网-JavaScript教程资源分享门户

在现代 Web 应用程序中，授权认证机制是非常重要的一环。JWT（JSON Web Token）是一种流行的身份验证和授权机制，它可以在客户端和服务器之间传递信息，以便验证用户身份和授权访问资源。在本文中，我们将介绍如何使用 Fastify 框架实现 JWT 授权认证机制。

什么是 Fastify？

Fastify 是一个快速、低开销、可扩展的 Node.js Web 框架，它专注于提供最佳的性能和开发体验。它具有以下特点：

快速：Fastify 的处理速度非常快，它可以处理大量的并发请求。
低开销：Fastify 的内存占用非常小，可以在低端设备上运行。
可扩展：Fastify 的插件系统非常灵活，可以轻松地添加和删除插件。
开发体验：Fastify 提供了很好的开发体验，可以快速构建高质量的 Web 应用。

什么是 JWT？

JWT 是一种开放标准（RFC 7519），它定义了一种在网络上安全地传递声明的方式。JWT 由三部分组成：头部、载荷和签名。头部包含算法和类型信息，载荷包含要传递的声明，签名用于验证 JWT 是否有效。

JWT 的工作流程如下：

用户通过用户名和密码进行身份验证。
服务器验证身份并生成 JWT。
服务器将 JWT 发送给客户端。
客户端将 JWT 存储在本地（例如，localStorage 或 cookie）。
客户端向服务器发送请求时，将 JWT 作为授权令牌发送。
服务器验证 JWT 是否有效，并根据声明授权访问资源。

实现 JWT 授权认证机制

在 Fastify 中实现 JWT 授权认证机制需要使用 fastify-jwt 插件。该插件提供了生成和验证 JWT 的功能。

安装 fastify-jwt

首先，我们需要安装 fastify-jwt 和 jsonwebtoken：

npm install fastify-jwt jsonwebtoken --save

注册插件

在 Fastify 应用程序中注册 fastify-jwt 插件：

const fastify = require('fastify')()

fastify.register(require('fastify-jwt'), {
  secret: 'supersecret'
})

在上面的代码中，我们将 fastify-jwt 注册为 Fastify 的插件，并指定了一个秘密字符串作为密钥。

生成 JWT

我们可以使用 fastify.jwt.sign() 方法生成 JWT：

// javascriptcn.com 代码示例
fastify.post('/login', async (request, reply) => {
  const { username, password } = request.body

  // 验证用户名和密码
  const isValid = await validateCredentials(username, password)

  if (!isValid) {
    reply.status(401).send({ message: 'Invalid credentials' })
    return
  }

  // 生成 JWT
  const token = await fastify.jwt.sign({ username })

  reply.send({ token })
})

在上面的代码中，我们使用了 fastify.jwt.sign() 方法生成 JWT，并将 JWT 发送给客户端。

验证 JWT

在需要授权的路由中，我们可以使用 fastify-jwt 插件提供的 fastify.jwt.verify() 方法验证 JWT：

// javascriptcn.com 代码示例
fastify.get('/protected', {
  preValidation: fastify.authenticate
}, async (request, reply) => {
  reply.send({ message: 'You are authorized' })
})

fastify.decorate('authenticate', async (request, reply) => {
  try {
    await request.jwtVerify()
  } catch (err) {
    reply.status(401).send({ message: 'Unauthorized' })
  }
})

在上面的代码中，我们使用 fastify.authenticate 装饰器将 fastify-jwt.verify() 方法注册为路由的预处理程序。fastify.authenticate() 方法将验证 JWT 是否有效，如果 JWT 无效，则返回 401 错误响应。

示例代码

下面是一个完整的示例代码，它演示了如何在 Fastify 中实现 JWT 授权认证机制：

// javascriptcn.com 代码示例
const fastify = require('fastify')()
const jwt = require('jsonwebtoken')

// 注册 fastify-jwt 插件
fastify.register(require('fastify-jwt'), {
  secret: 'supersecret'
})

// 验证用户名和密码
async function validateCredentials(username, password) {
  // TODO: 在此处实现验证逻辑
  return username === 'admin' && password === 'password'
}

// 登录路由
fastify.post('/login', async (request, reply) => {
  const { username, password } = request.body

  // 验证用户名和密码
  const isValid = await validateCredentials(username, password)

  if (!isValid) {
    reply.status(401).send({ message: 'Invalid credentials' })
    return
  }

  // 生成 JWT
  const token = await fastify.jwt.sign({ username })

  reply.send({ token })
})

// 受保护的路由
fastify.get('/protected', {
  preValidation: fastify.authenticate
}, async (request, reply) => {
  reply.send({ message: 'You are authorized' })
})

// 验证 JWT
fastify.decorate('authenticate', async (request, reply) => {
  try {
    await request.jwtVerify()
  } catch (err) {
    reply.status(401).send({ message: 'Unauthorized' })
  }
})

// 启动服务器
fastify.listen(3000, (err, address) => {
  if (err) {
    console.error(err)
    process.exit(1)
  }
  console.log(`Server listening on ${address}`)
})

总结

在本文中，我们介绍了如何使用 Fastify 框架实现 JWT 授权认证机制。我们演示了如何使用 fastify-jwt 插件生成和验证 JWT。JWT 授权认证机制是现代 Web 应用程序的重要组成部分，它可以帮助我们实现安全、可靠的身份验证和授权。如果您正在构建 Web 应用程序，那么使用 Fastify 框架和 JWT 授权认证机制将是一个不错的选择。

来源：JavaScript中文网，转载请注明来源本文地址：https://www.javascriptcn.com/post/658676b8d2f5e1655d0ec2b9