简介
koa-jwt-wong 是一个基于 Koa2 和 jsonwebtoken 的 JWT（JSON Web Token）中间件。它提供了一种简单方便的方式来验证和解析 JWT，以保护你的应用程序。
该中间件建立在 koa-jwt 的基础之上，并进行了一些扩展，包括更易于使用的选项配置，更细粒度的错误处理等。
本文将介绍 koa-jwt-wong 的使用方法，包括安装、配置、中间件的调用和示例代码。
安装
使用 npm 安装 koa-jwt-wong：
npm install koa-jwt-wong --save
配置
koa-jwt-wong 可以通过一个配置对象来设置自定义的选项，包括以下内容：
secret：JWT 的密钥，需要和签发 JWT 的密钥相同。必填项。key：JWT 的签发者（issuer）。可选项。audience：JWT 的接收者（audience）。可选项。algorithm：JWT 的签名算法（HS256、HS384、HS512、RS256、RS384、RS512）。默认为 HS256。cookie：解析 JWT 的 cookie 名称。可选项，默认为 'jwt'。getToken：从请求对象中获取 JWT 的方法。可选项，默认从请求头中获取。isRevoked：用于决定是否要拒绝某个 JWT 的解析。可选项。
我们可以创建一个配置文件，比如 jwtConfig.js，来组织这些选项：
-- -------------------- ---- -------
-------------- - -
------- ----------------
---- --------------
--------- --------------
---------- --------
------- ------
--------- --- -- -----------------------
---------- ----- ------------- ------ -- -
-- ----------------- - ---------- - ----- -
-- -- --- ------- --- ---
------ -----
-
------ ------
--
--中间件的调用
接下来，在应用程序中使用该中间件。
-- -------------------- ---- ------- ----- --- - --------------- ----- ---------- - ------------------------ ----- ------ - ----------------------- ----- --- - --- ------ -- -------- --- --- ---------------------------- -- --------- ------------- ----- ----- -- - -- ----------- --- ---------------------------- -------- - - -------- ------- ------- -- --- -----------------
在上述示例代码中，我们首先引入了 koa、koa-jwt-wong 和配置文件 jwtConfig.js。我们还创建了一个 Koa 应用程序，并在应用程序中使用了 koa-jwt-wong 中间件，并将 jwtConfig 作为参数传递给中间件。
在添加了该中间件之后，我们可以在需要进行身份验证的路由中通过 ctx.state.user 访问解析出的 JWT。
示例代码
本示例代码演示了如何在 HTTP 头中发送 JWT。
服务器端代码
-- -------------------- ---- -------
----- --- - ---------------
----- ------ - ----------------------
----- ---------- - ------------------------
----- ------------ - ------------------------
----- ------ - -----------------------
----- --- - --- ------
----- ------ - --- ---------
-- -------- ------------ ---
----------------------------
-- ------ --- ---
--------------------- ----- ----- ----- -- -
----- - ----- -------- - - -----------------
-- ----- --- ------- -- -------- --- --------- -
-- -- ---
----- ----- - ------------------- ---- -- -------------- - ---------- ---- ---
------------------------------ ------ - --------- ---- ---
-------- - - -------- ----- ----- --
- ---- -
-------- - - -------- ------ -------- --------------- ------- --
-
---
-- ------------
------------------------ ----- ----- ----- -- -
-------- - -
-------- -----
-------- ------- ------------------------
--
---
-------------------------
---------------------------------
---------------- -- -- ------------------- ------- -- --------------------------客户端代码
-- -------------------- ---- -------
--------- -----
------
------
---------- ---------------
-------
------
--------------
----- --------------- --------------
------------------------------- ----------- ------------------
----------------------------------- --------------- ----------------------
----------------------
-------
------------- ---------
---- ------------------
--------
----- ---- - --------------------------------------
----- ------ - ----------------------------------
------------------------------- ----- ------- -- -
-----------------------
----- ---- - -------------------------
----- -------- - -----------------------------
--- -
-- ------- ---
----- -------- - ----- --------------- -
------- -------
-------- - --------------- ------------------ --
----- ---------------- ----- -------- --
---
----- ---- - ----- ----------------
-- --------------- -
----------------------------
---------------- - -----------------------------
-------
-
-- - ---- ---- ---
----- ------- - - -------------- ------- -------------- --
---------------------- ------------------
-- ---------- --------------------
----- --------- - ----------------------------------
-- ----------- -
--------------- - ----------
-
-- --------
----- ----------------- - ----- ------------------- - ------- ---
----- ------------- - ----- -------------------------
---------------- - --------------------------------------
- ----- ------- -
---------------------
---------------- - ------------------------------
-
---
---------
-------
-------运行该示例代码，访问 http://localhost:3000/ 可以看到一个简单的登陆页面。在该页面中输入用户名和密码，并点击“登录”按钮，将在后台自动生成一个 JWT，并将其保存在 Cookie 中，然后跳转到受保护的页面 /protected。
在该页面中我们通过发送 HTTP 请求，在 HTTP 头中添加 JWT。服务器端会解析该 JWT 并进行身份验证。
该示例代码演示了如何使用 koa-jwt-wong 轻松地进行 JWT 认证和保护 Web 服务。通过该库，我们可以轻松地构建安全的 Web 应用程序，大大降低了开发人员的开发难度和工作量。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/6005609781e8991b448dece7