如何使用 Next.js 实现用户身份认证及授权

阅读时长 10 分钟读完

在开发现代 Web 应用程序时,用户身份认证和授权是非常重要的一个方面。它们有助于保障您的应用程序及其数据的安全性,确保用户只能访问他们有权限访问的内容。本文将介绍如何使用 Next.js,一种人气很高的 SSR 框架,来实现用户身份认证和授权。

预备知识

在开始之前,您需要对以下内容有一定的了解:

  • Node.js:一款基于 Chrome V8 引擎的 JavaScript 运行时。
  • React:一个用于构建用户界面的 JavaScript 库。
  • Next.js:一个基于 React 的 SSR 框架。
  • JWT:一种用于在网络中传输声明的开放标准。

用户身份认证

用户身份认证是一个认证用户是否是合法用户的过程。在 Web 应用程序中,身份认证通常是通过用户名和密码来检查用户是否具有访问权限。一旦用户通过身份认证,应用程序可以确定该用户是否有权限访问应用程序中的受限制页面或资源。

为了实现身份认证,您需要创建一个用于处理用户登录的页面和一些用于验证用户身份的逻辑。在 Next.js 环境下,您可以使用中间件来实现此目的。

创建用于处理用户登录的页面

首先,您需要创建一个处理用户登录的页面。您可以使用 Next.js 的 pages 目录来创建此页面。在该页面中,您需要为用户提供输入他们的用户名和密码的表单,并且通过 post 请求将表单数据发送到服务器进行处理。

-- -------------------- ---- -------
------ - -------- - ---- -------
------ - --------- - ---- -------------

------ ------- -------- -------- -
  ----- ---------- ------------ - ------------
  ----- ---------- ------------ - ------------
  ----- ------ - -----------

  ----- ------------ - ----- ------- -- -
    ----------------------

    ----- -------- - ----- -------------------------- -
      ------- -------
      -------- -
        --------------- ------------------
      --
      ----- ---------------- --------- -------- --
    --

    -- ------------- -
      -- -----------
      ----------------
    - ---- -
      -- ------
      ----- ---- - ----- ---------------
      -----------------
    -
  -

  ------ -
    ----- ------------------------
      ------
        -----------
        ----------------
        ----------------- -- --------------------------------
      --
      ------
        ---------------
        ----------------
        ----------------- -- --------------------------------
      --
      ------- ------------------ -----------
    -------
  -
-

创建身份认证逻辑中间件

使用 Next.js,您可以非常容易地编写身份验证逻辑的中间件。中间件是一种函数,它可以具有访问请求和响应对象的能力,并且可以决定是否允许访问受保护的资源。

在以下示例中,我们将使用中间件来实现用户身份认证。该中间件将读取请求标头中的 Authorization 令牌,并使用 JWT 库进行验证。如果令牌有效,则该中间件将允许请求访问受保护的资源。否则,它将返回一个 401 错误。

-- -------------------- ---- -------
------ --- ---- --------------

------ ----- ------------ - --------- -- ----- ----- ---- -- -
  --- -
    ----- ----- - --------------------------------- -----

    ----- - ---- ------ - - ----------------- -----------------------

    ---------- - ------

    ------ ------------ ----
  - ----- ------- -
    --------------------
    ---------------------- ------ -------------- --
  -
-

authenticate 中间件将接收一个处理程序函数作为参数,并返回一个异步函数。其中间件函数将从请求标头中读取 Authorization 令牌并尝试验证该令牌。如果令牌有效,则该中间件将将 userId 放入请求对象中,然后将控制器传递给下一个处理程序。如果令牌无效,则该中间件将返回一个 401 错误响应。

在示例中,我们使用 JWT 库来验证令牌。JWT 是一种简单的、可扩展的、可加密的标准,它用于在网络中传递 JSON 对象。它可以用于身份验证和信息交换,例如在无状态环境中使用 JSON Web Token(JWT)在客户端和服务器之间传递认证信息。

在 Next.js 中使用中间件

在 Next.js 中,您可以使用 getServerSidePropsgetInitialProps 函数,在页面渲染之前运行任意的处理逻辑。这些函数可以返回一个 props 对象,用于初始化组件的状态或渲染页面。

您可以从这些函数中返回一个参数 context,其中包含请求和响应对象。在此示例中,我们将使用 authenticate 中间件来验证身份,并将用户 ID 添加至请求对象中。

-- -------------------- ---- -------
------ - --------- - ---- -------
------ - --------- - ---- -------------

------ ------- -------- --------- ------ -- -
  ----- ------ - -----------

  ------------ -- -
    -- --------- -
      ----------------------
    -
  -- ---------

  ------ -
    -----
      ---------- -------------
    ------
  -
-

------ ----- -------- --------------------------- -
  ----- ------- - ----- ----- ---- -- -
    ------ - ------ - ------- ---------- - -
  -

  ------ ----- ---------------------------------- ------------
-

在这个示例中,我们添加了 useEffect 钩子,当 userId 未定义时将用户重定向到登录页面。然后,我们在 getServerSideProps 函数中使用 authenticate 中间件来验证身份,并将 userId 添加到 props 对象中,以便在组件中使用。

用户授权

用户授权是一个决定用户是否有权限访问特定资源的过程。在 Web 应用程序中,用户授权通常是根据用户角色和权限等级来确定哪些资源对用户是可用的。

实现用户授权的一种常见方法是使用访问令牌。访问令牌是一个用于访问受保护资源的字符串,它可以在服务器和客户端之间进行传递。当用户通过身份认证并获得访问令牌时,客户端可以使用该令牌来请求受保护的资源。服务器可以使用访问令牌来验证用户是否有权访问该资源。

生成访问令牌

在以下示例中,我们将使用 jsonwebtoken 库来生成 JWT 访问令牌。我们将在用户登录时生成令牌,并将其存储在客户端的 cookie 中。

-- -------------------- ---- -------
------ --- ---- --------------

------ ----- ---------------- - ----- ---------- --------- -- -
  -- ------------
  ----- ---- - ----- -------------------------------------- ---------

  -- ------- -
    ----- --- -------------- -------- -- ----------
  -

  -- ------- ---
  ----- ----- - ---------- ---- ------- -- -----------------------

  ------ - ----- -
-

在登录逻辑中,我们首先验证用户名和密码。如果用户通过身份验证,则我们使用 jsonwebtoken 库来生成一个 JWT 并将其作为响应之一返回。客户端可以将该令牌存储在本地存储或 cookie 中,以便在以后的请求中使用。

使用访问令牌验证用户授权

在以下示例中,我们将创建一个 withAuthorization 高阶组件,它将验证用户是否具有访问资源的权限。通过调用此函数并传递所需的角色,您可以创建一些受保护的组件。如果用户未经过授权,则该组件将重定向到登录页面。

-- -------------------- ---- -------
------ - --------- - ---- -------
------ - --------- - ---- -------------
------ ------- ---- -----------

------ ----- ----------------- - ------ -- ------------------ -- -
  ----- ------------- - -- -------- -- -- -
    ----- ------ - -----------

    ------------ -- -
      ----- ----- - ------------------------

      ----------------------- -
        -------- -
          -------------- ------- ---------
        -
      --
        ---------------- -- -
          -- -------------- -
            ----- --- ---------------------
          -

          ------ ---------------
        --
        ------------ -- -
          -- ---------------------------- -
            ----------------
          -
        --
        -------------- -- -
          ------------------
          ----------------------
        --
    -- ---

    ------ ----------------- ---------- --
  -

  ------ -------------
-

在此示例中,我们使用 withAuthorization 高阶组件来创建一个可用于受保护资源的受保护组件。该组件将检查客户端 cookie 中的 authToken,并使用 fetch API 将其传递到服务器以进行授权。服务器将验证令牌,并通过返回具有所需权限级别的 JSON 来响应。

如果用户未被授权,则该组件将重定向到登录页面。如果用户经过身份验证且被授权,则该组件将被渲染,并且具有所需的属性和状态。

结论

在本文中,我们介绍了如何使用 Next.js 来实现用户身份认证和授权。我们学习了如何创建用户登录页面、使用 JWT 库生成访问令牌、实现访问令牌的中间件验证和使用高阶组件来保护资源。

Next.js 提供了一种快速且易于使用的方式来创建服务器端呈现的 React 应用程序。了解如何在 Next.js 中实现身份认证和授权非常有用,可以帮助您构建更安全、更有预测性和更互动的应用程序。

来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/66fb4e1c44713626015b22fd

纠错
反馈