介绍
@arve.knudsen/hapi-auth-cookie 是基于 Hapi 框架的一个 Cookie 身份验证插件。它提供了一种简单且安全的方式来管理用户的身份验证信息，使其更易于保护应用程序的安全性。
@arve.knudsen/hapi-auth-cookie 实现了 Session 的概念，服务器会将包含用户身份验证信息的 Cookie 存储起来，并在后续用户请求时对其进行验证，以确保访问请求来自已经登录的用户。
安装
在安装之前，请确保本地已经安装了 Node.js 及 npm 。
要安装 @arve.knudsen/hapi-auth-cookie ，可以运行以下命令：
npm install --save @arve.knudsen/hapi-auth-cookie
用法
引入 @arve.knudsen/hapi-auth-cookie
在使用前需要先引入 @arve.knudsen/hapi-auth-cookie，可以使用如下代码：
const HapiAuthCookie = require('@arve.knudsen/hapi-auth-cookie');注册插件
在 Hapi 服务器实例上注册插件：
await server.register(HapiAuthCookie);
配置
注册插件时可以通过 options 参数进行配置：
-- -------------------- ---- -------
----- -----------------
------- ---------------
-------- -
------- -
----- ----------
--------- ----------------------------------------
--------- ------
---- -- - -- - -- - -----
----- ----
----------- ------
----------- ---------
------------- -----
------------- ----
--
----------- ---------
----------- -----
-------------- ------
-
---cookie.name：Cookie 名称，默认为sid。cookie.password：Cookie 密码，必须设置，建议设置为要求强度的密码。cookie.isSecure：是否只限 HTTPS 使用，默认为true。cookie.ttl：Cookie 有效期，单位为毫秒，默认为null。cookie.path：Cookie 作用域路径，默认为/。cookie.isSameSite：是否为同站点 Cookie，默认为Lax。cookie.redirectTo：重定向目标路由路径，默认为/login。cookie.clearInvalid：是否清除未验证的 Cookie，默认为false。cookie.strictHeader：是否启用严格的 Cookie 头，默认为true。redirectTo：重定向目标路由路径，覆盖cookie.redirectTo默认值。appendNext：是否为重定向目标路径附加next查询参数，默认为false。redirectOnTry：是否在第一次验证失败后重定向到登录页面，默认为false。
用户验证
定义一个用于验证用户身份的策略：
-- -------------------- ---- -------
------------------------------- --------- -
------- -
----- -----------------
--------- ----------------------------------------
--------- ------
---- -- - -- - -- - ----
--
----------- ---------
----------- -----
-------------- ------
------------- ----- --------- -------- -- -
----- ------- - ----- -------------- --- ---------- ---
-- ---------- -
------ - ------ ----- --
-
------ - ------ ----- ------------ ------- --
-
---其中：
strategyName：用于区分不同的身份验证策略，需要与路由配置中的auth属性对应。cookie：Cookie 配置项。validateFunc：用户身份验证回调函数，用于验证请求是否来自已经登录的用户。函数应该执行以下步骤：- 检查 session 是否有效，如果有效则返回
{ valid: true, credentials: session }。 - 如果 session 无效，则返回
{ valid: false }。
- 检查 session 是否有效，如果有效则返回
路由配置
在路由配置中使用定义好的身份验证策略：
-- -------------------- ---- -------
--------------
------- ------
----- ----
------- -
----- --------- -- -- ------- --------
--
-------- --------- -- -- -
-- ----------
------ -
----------- ----
-------- -------
--
-
---示例代码
以下是一个完整的示例代码：
-- -------------------- ---- -------
----- ---- - ----------------------
----- -------------- - ------------------------------------------
----- ------ - --- -------------
----- ------------
----- ----
---
-- ----
----- -----------------
------- ---------------
-------- -
------- -
----- ----------
--------- ----------------------------------------
--------- ------
---- -- - -- - -- - -----
----- ----
----------- ------
----------- ---------
------------- -----
------------- ----
--
----------- ---------
----------- -----
-------------- ------
-
---
-- ----
------------------------------- --------- -
------- -
----- -----------------
--------- ----------------------------------------
--------- ------
---- -- - -- - -- - ----
--
----------- ---------
----------- -----
-------------- ------
------------- ----- --------- -------- -- -
----- ------- - ----- -------------- --- ---------- ---
-- ---------- -
------ - ------ ----- --
-
------ - ------ ----- ------------ ------- --
-
---
-- ----
--------------
------- ------
----- ----
------- -
----- ---------
--
-------- --------- -- -- -
-- ----------
------ -
----------- ----
-------- -------
--
-
---
----- ---------------
------------------- ------- -- ---- -----------------结论
@arve.knudsen/hapi-auth-cookie 是一个非常有用的 Cookie 身份验证插件，它可以帮助我们轻松地实现安全的用户身份验证系统。本篇文章中，我们详细介绍了 @arve.knudsen/hapi-auth-cookie 的安装、使用和配置，希望本文对你的学习和实践有所帮助。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/6005678f81e8991b448e3ec3