Swagger 是一种 API 文档生成工具，它可以让开发者更方便地创建和维护 API 文档。同时，Swagger 也提供了一些工具来测试 API，包括 Swagger UI。
swagger-ui-express-oauth2 是一个进行 OAuth2 鉴权的 Swagger UI 中间件，它可以为你的 API 提供 OAuth2 鉴权机制，并且允许用户使用 Swagger UI 来测试受到 OAuth2 保护的 API。下面将介绍如何在 Node.js 项目中使用 swagger-ui-express-oauth2。
安装
首先需要确定你已经在项目中安装了 Swagger UI 和 Swagger UI Express。如果还没有安装，你可以使用下面的命令进行安装：
npm install swagger-ui swagger-ui-express --save
然后，你可以使用下面的命令来安装 swagger-ui-express-oauth2：
npm install swagger-ui-express-oauth2 --save
配置
在使用 swagger-ui-express-oauth2 的过程中，你需要提供一些配置信息，以便它能够正确地进行 OAuth2 鉴权。在项目的入口文件中，你需要添加如下的代码：
-- -------------------- ---- ------- ----- --------- - ------------------------------ ----- --------------- - -------------------------- ----- ------ - ------------------------------------- ----- --- - --------------------- ----- ----------- - - --------- --------------- ------------- ------------------- ------ ----------- -------- -------------- --------------- ---- ------- ----------- ----------- ---------------------------- --- -- -------------------- ----------------- ------------ ------------------
其中，swaggerDocument 是你的 Swagger 文档，oauthConfig 则是进行 OAuth2 鉴权时需要的配置信息。
在上面的示例代码中，我们将 OAuth2 鉴权中间件作为 app.use() 方法的参数进行了配置。
OAuth2 鉴权
现在，你的 API 已经启用了 OAuth2 鉴权。在 Swagger UI 中，用户会被要求输入他们的 OAuth2 凭证，只有在鉴权通过之后，才能使用 Swagger UI 访问受保护的 API。
示例代码
-- -------------------- ---- ------- ----- --------- - ------------------------------ ----- --------------- - -------------------------- ----- ------ - ------------------------------------- ----- --- - --------------------- ----- ----------- - - --------- --------------- ------------- ------------------- ------ ----------- -------- -------------- --------------- ---- ------- ----------- ----------- ---------------------------- --- -- -------------------- ----------------- ------------ ------------------ ---------------- -- -- - ------------------- -- ------- -- ---- -------- ---
学习与指导意义
使用 swagger-ui-express-oauth2 可以极大地简化你的 API 的 OAuth2 鉴权过程。同时，这个 npm 包的源代码也提供了很好的范例，对于理解 OAuth2 的工作原理和实现有一定的帮助。
在使用本文中提到的 npm 包之前，建议先理解 OAuth2 的基本概念和工作流程。如果你还没学习 OAuth2，可以阅读OAuth 2.0 的官方文档。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/600572bf81e8991b448e8d7b