Fastify 是一个快速且低开销的 Web 框架，它可以帮助我们构建高效的 Node.js 服务器。在实际项目中，安全是 Web 应用程序设计的一个重要组成部分。为了保护用户信息和数据安全，我们通常需要对客户进行身份认证。本文将介绍如何使用 fastify-auth 插件来实现用户身份验证。
安装和配置 fastify-auth
和 Fastify 的其他插件一样，我们需要先安装 fastify-auth，可以通过 npm 安装：
npm install fastify-auth
安装插件之后，我们需要将其注册到 Fastify 实例中。下面是一个例子：
const fastify = require('fastify')()
const authPlugin = require('fastify-auth')
fastify.register(authPlugin)在注册完 fastify-auth 插件之后，我们可以定义我们的身份验证策略。
定义认证策略
fastify-auth 提供了一个 authenticate 函数，可以用来定义身份验证策略。该函数接受一个字符串作为策略的名称，和一个实现了 StrategyOptions 接口的对象作为参数。
fastify.decorate('authenticate', async function (request, reply) {
try {
await request.jwtVerify()
} catch (err) {
reply.send(err)
}
})上述示例代码定义了一个名为“jwt”的身份验证策略。该策略使用 JSON Web Token（JWT）来验证用户的身份。它将在请求处理程序之前被调用，并在请求处理程序成功完成之前等待身份验证。
接下来，我们需要将该策略与特定路由或 URL 匹配。下面是一个示例：
fastify.route({
method: 'POST',
url: '/login',
handler: async (request, reply) => {
// 省略身份验证代码
reply.send({ token })
}
}).authenticate('jwt')上述示例代码定义了一个 POST /login 路由，它使用“jwt”身份验证策略进行保护。如果客户端在请求头中不带有有效的 JWT，则 Fastify 会自动回复 401 未授权状态。
集成第三方身份验证服务
除了使用 JWT 之外，我们还可以将 fastify-auth 插件与第三方身份验证服务集成。例如，我们可以使用 GitHub 的 OAuth2 服务来保护我们的路由。
下面是一个使用 GitHub OAuth2 服务的示例：
-- -------------------- ---- -------
----- ---------- - -----------------------
----- ------- - --------------------
----- ------------- - -------------------------
----- ------------------ - -------------------------------
----- -------------------- - ---------------------------------
-------------------------------
------------------------------------ - ------- --- --------- --- --------- --- ------------- ----
-------------------------------------- - ------- -------------- ------ ---- -- -- ----- -- ---------- ------ --
----------------------------
--------------------------------- ----- -------- --------- ------ -
----- -------------------
--
--------
------- -------
---- ---------
-------- ----- --------- ------ -- -
----- - ----------- - - ----- --------------------------------
----- ------- - - ----------- -
----------------------------
------------ ------ ----- ------------------ ------- -- - ---------- ----- -- --
-
----------------------上述示例代码将 fastify-auth 插件与 fastify-auth0-verify 插件（集成 Auth0）和 fastify-secure-session 插件（用于保护 session）一起使用。它定义了 POST /login 路由，并在处理程序中使用 GitHub 的 OAuth2 服务进行身份验证。如果身份验证成功，Fastify 将在响应头中发送包含 JWT 的授权令牌。
总结
本文介绍了如何使用 fastify-auth 插件实现用户身份验证，并提供了一些示例代码来帮助您入门。Fastify 提供了丰富的功能和扩展性，因此可以与不同类型的身份验证服务集成。不管您使用何种身份验证策略，安全总是 Web 应用程序设计中不可忽视的重要组成部分。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/6492b33148841e98940801fc