前言
在现代 Web 开发中，安全性是不可或缺的一部分。@nodefony/security-bundle 是一个用于 Node.js 和 Webpack 的包，提供了许多关于安全性的功能和工具，如身份验证和授权等。
在本文中，我们将详细介绍如何使用 @nodefony/security-bundle 这个 npm 包，包括安装、配置以及使用示例。这篇文章适合于已经具有一定 Node.js 基础和 Web 开发经验的读者。
安装和配置
安装
使用 npm 安装 @nodefony/security-bundle：
npm install @nodefony/security-bundle --save
安装完毕后就可以在项目中使用 @nodefony/security-bundle 了。
配置
在配置之前，你需要了解以下两个概念：
- User Provider：用户信息提供者，用于获取用户信息。
- Security Firewall：安全防火墙，用于拦截并处理用户的请求。
下面是一个简单的配置示例：
-- -------------------- ---- -------
----- -------------- - -------------------------------------
----------------
-------------- -
-
----- ------------
------ -
-
--------- --------
--------- ---------
------ --------------
--
-
--------- -------
--------- -----------
------ -------------
-
-
-
--
---------- -
----- -
-------- --------------------------
---------- -----
----------- --
-
--
--------------- -- ----- ----------- ------ -------------- --
---以上示例中，我们定义了一个名为 in_memory 的用户信息提供者，其中包含了两个用户。接下来，我们定义了一个名为 main 的安全防火墙，它会匹配所有以 /, /login 和 /logout 开头的请求，并在未登录的情况下允许匿名访问。最后，我们定义了一个权限控制规则，限制了访问 /admin 的用户必须拥有 ROLE_ADMIN 角色。
使用教程
创建一个 Express app
我们首先需要创建一个 Express app，在这个 app 中使用 @nodefony/security-bundle 提供的功能。
-- -------------------- ---- -------
----- ------- - -------------------
----- ---------- - -----------------------
----- ------- - ---------------------------
----- -------------- - -------------------------------------
----- --- - ----------
---------------------------
------------------------------- --------- ---- ----
--------
---------
------- ----------------
------- ------
------------------ ----
--
--
----------------
-------------- -
-
----- ------------
------ -
-
--------- --------
--------- ---------
------ --------------
--
-
--------- -------
--------- -----------
------ -------------
-
-
-
--
---------- -
----- -
-------- --------------------------
---------- -----
----------- --
-
--
--------------- -- ----- ----------- ------ -------------- --
---
---------------- -- -- -
------------------- -- ------- -- ---- -------
---添加路由
接下来，我们需要添加一些路由，用于测试 @nodefony/security-bundle 提供的功能。
-- -------------------- ---- -------
------------ ----- ---- -- -
--------------- ---------
---
----------------- ----- ---- -- -
----------
------
------
----- ------------- ----------------
-----
------------------------
------ ----------- ----------------
------
-----
------------------------
------ --------------- ----------------
------
-----
------ ------------- --------------
------
-------
-------
-------
---
---
------------------ ----- ---- -- -
-- ------------------- -- ------------------- -
----------------------------- ----------
-------
-
----------- --------- ------------------ --------- ----------------- -- --- -- -
-- ----- -
-------------------------------------
-------
-
------------------
---
---
------------------ ----- ---- -- -
-------------
------------------
---
----------------- ----- ---- -- -
--------------- ---------
---以上代码中，我们添加了以下几个路由：
- /：返回 "Hello World!"。
- /login：返回一个 HTML 表单，用户可以使用该表单进行登录。
- /login (POST)：使用用户名和密码进行登录。如果登录成功，则重定向到 /。
- /logout：注销当前用户并重定向到 /。
- /admin：只有拥有 ROLE_ADMIN 角色的用户才能访问的路径。
实现登录和注销
现在，我们需要实现 @nodefony/security-bundle 提供的 req.login 和 req.logout 方法，以便于我们在 app 中管理用户的登录状态。
-- -------------------- ---- -------
----- -------------------- - ------------------------------------------------------------
------------- ---- ----- -- -
--------- - ----- ---- -- -
----- - --------- -------- - - -----
----- ---- - ----- --------------------------------------------------
-- ------- -
----- --- -------------- -------- -- -----------
-
----- ----- - ----- ---------------------------------------- ----------
-- -------- -
----- --- -------------- -------- -- -----------
-
---------------- - -----
------ -----
--
---------- - -- -- -
---------------- - -----
--
-------
---以上代码实现了 req.login 和 req.logout 方法，具体实现细节可以参考注释。由于我们简单地使用了 session 作为用户信息的存储方式，所以在使用 req.login 和 req.logout 时会直接操作 session。
添加用户认证中间件
最后，我们需要添加一个用于验证用户身份的中间件，以确保用户访问受限的路径时必须已经登录且具备对应的角色。
-- -------------------- ---- -------
------------- ----- ---- ----- -- -
----- - ---- - - ----
----- ----- - -------------------------------------------------------
----- --------- - ----- ---------------------------- - ---- ---
-- ------------ -
---------------------------- ---------
-------
-
-------
---以上代码中，我们使用 @nodefony/security-bundle 提供的 voter 工厂获取了一个名为 access_control 的 voter，并调用了它的 vote 方法，验证了当前用户是否允许访问当前路径。
总结
在本文中，我们介绍了 @nodefony/security-bundle 这个 npm 包，学习了如何安装、配置和使用它。我们通过一个示例项目演示了如何使用 @nodefony/security-bundle 来提供 Web 应用的安全性能。我们希望本文对于已经具有一定 Node.js 基础和 Web 开发经验的读者能够有所启示，并能够应用到自己的项目中。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/5eedbe31b5cbfe1ea0611b40