sails-auth-it 是一个在 Sails 框架中使用的 npm 包，用于实现用户认证和授权功能。在开发 Web 应用程序时，实现用户认证和授权是非常常见的需求，并且常常耗费不少的时间和精力。使用 sails-auth-it 包可以大大简化这个过程，并提高开发效率。
本文将介绍如何使用 sails-auth-it 包来实现用户认证和授权功能。
安装 sails-auth-it 包
在开始之前，首先需要安装 sails-auth-it 包。可以通过 npm 命令行工具来进行安装：
npm install sails-auth-it --save
用户认证
首先，我们来看一下如何使用 sails-auth-it 进行用户认证。用户认证是验证用户身份的过程。在本例中，我们将使用密码认证来验证用户身份。
配置 sails-auth-it
首先，在 Sails 应用程序目录下的 config 目录中创建一个 auth.js 文件并配置作为我们应用程序的身份验证配置。这个文件应该包含以下内容：
-- -------------------- ---- -------
------------------- - -
---- -
------- --------
--
--------- -
------- ---------
----------- -----
------- ---
------- --------
-
--这个配置将使用 JWT（JSON Web Token）和密码哈希来进行用户认证。请注意，这里的密码哈希使用了加盐（pepper）技术，使用 SHA-512 算法进行散列，并迭代计算 4096 次。
Hook sails-auth-it
在我们的 Sails 应用程序中，我们需要在 config 目录下的 http.js 文件中启用钩子（hook）来使用 sails-auth-it 包。为了使用这个包，需要在 http.js 中进行如下配置：
-- -------------------- ---- -------
------------------- - -
----------- -
------------- ---------------------------------
---------------- ------------------------------
----- -------------------------------
----------------- --------
----------------- -----------
---------- -------
---------------------- --------
--
-
--这里启用了以下钩子：
passportInit：初始化 Passport 身份验证模块。passportSession：使用 Passport 会话插件。auth：使用 sails-auth-it 包来进行用户认证。
当用户请求应用程序时，我们需要使用 auth 钩子进行身份验证。需要确保用户在请求头中包含一个有效的 JWT，以便将其传递给身份验证中间件。
创建 User 模型
为了实现身份验证，我们需要创建一个用户模型。在 Sails 应用程序的 api/ 目录下创建一个新的 User.js 文件，用于定义用户模型。以下是一个简单的示例：
-- -------------------- ---- -------
---
- -------
-
- ------------ -- ---------- - ---- -- --- ------
--
-------------- - -
----------- -
------ -
----- ---------
--------- -----
------- ----
--
--------- -
----- ---------
--------- ----
-
-
--在这里，我们只定义了 email 和 password 两个属性。
创建控制器方法
现在我们已经创建了用户模型，我们需要在控制器中创建方法来处理用户身份验证请求。以下是一个简单的身份验证控制器的示例，它包含了注册、登录和注销方法：
-- -------------------- ---- -------
---
- --------------
-
- ------------ -- ----------- ----- --- -------- --------------
--
----- -------- - --------------------
-------------- - -
--------- ----- -------- ----- ---- -
--- -
----- ---- - ----- ------------------------------
-------------
- ----- ----- -
---------------------
-
--
------ ----- -------- ----- ---- ----- -
------------------------------ ----- -------- ----- ----- ----- -
--- -
-- ----- ----- ----
-- ------- -
------ ----------------
-------- -------- ----- -- ---------
---
-
--------------- ----- -------- ----- -
-- ----- ----- ----
----- ----- - ----- ------------------------------
------ --------
-----
-----
---
---
- ----- ----- -
------ ---------------------
-
------- ---- ------
--
------- ----- -------- ----- ---- -
--- -
-------------
------ --------
-------- ------- -----------
---
- ----- ----- -
------ ---------------------
-
-
--这个控制器非常简单明了，我们使用 passport-local 策略（这个是 passport 身份验证模块的一个策略）来进行用户身份验证。我们通过调用实现授权的 AuthService.createToken() 方法来创建 JWT 令牌并将其作为响应发送给客户端。
用户授权
接下来，我们将介绍如何使用 sails-auth-it 进行用户授权。用户授权是保护 Web 应用程序的措施，并按所需的方式控制用户对其资源的访问。在本例中，我们将使用基于角色的访问控制（RBAC）来实现用户授权。
创建 Role 模型
在 api/ 目录下创建一个新的模型文件 Role.js，用于定义角色模型。以下是一个简单的示例：
-- -------------------- ---- -------
---
- -------
-
- ------------ -- ---------- - ---- -- --- ------
--
-------------- - -
----------- -
----- -
----- ---------
--------- -----
------- ----
-
-
--创建 UserRole 模型
在 api/ 目录下创建 UserRole.js 文件，用于定义用户和角色之间关系的模型。
-- -------------------- ---- -------
---
- -----------
-
- ------------ -- ---------- - ------- ------- - ---- --- - ----
--
-------------- - -
----------- -
-------- -
------ -------
--------- ----
--
-------- -
------ -------
--------- ----
-
-
--Hook sails-auth-it
我们需要在中间件中加载 sails-auth-it，这样就可以使用 authorize 钩子在路由层面进行用户授权。我们需要在 http.js 文件中启用钩子并配置以下内容：
-- -------------------- ---- -------
------------------- - -
----------- -
------------- ---------------------------------
---------------- ------------------------------
----- -------------------------------
----------------- --------
----------------- -----------
---------- -------
---------------------- --------
---
---------- ------------------------------------
----------------- -------
----------------- --------
---------- -------
----------------- --------
---------- -------
-------------- -----------
------------ ------
--
-
--这里启用了以下钩子：
passportInit：初始化 Passport 身份验证模块。passportSession：使用 Passport 会话插件。auth：使用 sails-auth-it 包进行用户认证。authorize：使用 sails-auth-it 包对用户进行授权。
定义角色
在 Sails 应用程序运行时，需要将应用程序中所有的角色定义存储在数据库中。以下是一个简单的角色定义示例：
// api/services/RoleService.js
module.exports = {
async createRoles() {
await Role.findOrCreate({
name: 'admin'
});
}
};可以在 Sails 启动文件中使用 RoleService.createRoles() 来创建角色，这样所有角色都将存储在数据库中并始终可用于访问控制。
创建授权中间件
我们需要编写一个中间件来确保用户具有所需的角色。以下是一个简单的实现：
-- -------------------- ---- -------
-- ----------------------
-------------- - -------- -------------- -
------ ----- -------- ----- ---- ----- -
--- -
----- ----- - ----- --------------------------------------------
-- -------- ----- --- ----------- --- --------
----- --------- - ----------------- -- --------
-- ----------------------------------- -
------ ---------------
-------- ---- --- --- ---------- -- ------- ---- -------
---
-
------ -------
- ----- ----- -
------ -------------------
-
-
--中间件将返回一个函数，该函数将接收所需的角色并返回一个异步处理函数。该函数将从请求对象中获取用户 ID，然后使用 populate 方法获取用户在数据库中存储的角色。如果所需角色不在用户角色列表中，将返回 403 Forbidden 错误让用户知道他们没有权限执行所请求的操作。
使用授权中间件
现在，我们已经写好了授权中间件，我们需要在需要进行用户授权的路由中使用它。我们将指定所需的角色作为中间件的参数。以下示例代码展示了如何使用授权中间件：
-- -------------------- ---- -------
-- ---------------------------------
-------------- - -
---
- ------- - --------- ---------
--
----- ----- -------- ----- ---- -
--------
------- ---- --- ------ -----
---
--
---
- ------- - ---- --------- ---------
--
-------------- --------------- ----- -------- ----- ---- -
--------
------- ---- --- ------ -----
---
--
--在这里，我们将 Role('admin') 用作中间件。这将限制访问此 API 的用户必须拥有 admin 角色。
结论
使用 sails-auth-it 包，实现用户认证和授权是非常容易的。本文提供了一个简单的示例，介绍了如何使用 JWT 和基于角色的访问控制来实现身份验证和授权功能。希望通过本文的学习，您可以更好地了解如何使用 sails-auth-it 包来简化身份验证和授权过程。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/60056f7081e8991b448e7a26