在 Express.js 中实现 OAuth 2.0 认证的方法

阅读时长 20 分钟读完

OAuth 2.0 是一种常用的认证和授权协议,它允许用户授权第三方应用程序访问其受保护的资源。在本文中,我们将介绍如何在 Express.js 中实现 OAuth 2.0 认证的方法。

OAuth 2.0 认证流程

OAuth 2.0 认证流程包括以下几个步骤:

  1. 应用程序发送认证请求到认证服务器。
  2. 认证服务器展示认证页面并等待用户授权。
  3. 用户同意授权并输入用户名和密码。
  4. 认证服务器验证用户身份并向应用程序发送访问令牌。
  5. 应用程序使用访问令牌向资源服务器发送请求并获取访问资源的权限。

在 Express.js 中实现 OAuth 2.0 认证,我们可以使用 oauth2-server 模块,它是一个基于 Node.js 的 OAuth 2.0 服务器实现。

安装 oauth2-server 模块

在终端中执行以下命令安装 oauth2-server 模块:

创建认证服务器

在 Express.js 应用程序中,需要创建一个认证服务器。我们可以使用 oauth2-server 模块的 OAuth2Server 类创建一个基本的 OAuth 2.0 认证服务器。

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

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

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

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

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

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

在上面的代码中,我们创建了一个命名为 oauth2OAuth2Server 实例,并将其绑定到 Express.js 应用程序的 app 对象上。然后,我们在应用程序中使用 app.use 方法将中间件 app.oauth.token() 添加到 /oauth/token 路由上,该中间件用于生成 OAuth 2.0 的令牌。

配置模型对象

在上面的代码中,我们传递了一个空对象作为配置 oauth2-server 的模型对象。我们需要配置模型对象来授权,验证和存储令牌,客户端和用户的相关信息。

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

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

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

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

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

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

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

在上面的代码中,我们在 model 属性中传递了一个新的 OAuth2Model 对象,该对象使用 Mongoose 模块连接 MongoDB 数据库来存储和检索 OAuth 2.0 中所需的相关数据。

实现 OAuth 2.0 流程

在实现 OAuth 2.0 的完整流程之前,我们需要定义 OAuth 2.0 的客户端和用户模型。

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

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

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

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

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

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

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

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

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

在上面的代码中,我们创建了一个客户端模型和用户模型。客户端模型定义了以下属性:

  • name:客户端名称。
  • clientId:客户端的唯一标识符。
  • clientSecret:客户端的密钥,用于认证请求并获取访问令牌。

用户模型定义了以下属性:

  • username:用户名。
  • password:密码,存储加密后的密码。

我们将客户端和用户模型传递给 OAuth2Model 实例,以便 oauth2-server 模块能够访问这些模型。

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

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

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

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

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

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

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

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

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

在上面的代码中,我们定义了一个 OAuth2Model 子类 MongooseOAuth2Model,该子类从 OAuth2Model 继承并实现一些方法:

  • getClient(clientId, clientSecret):根据客户端 ID 和客户端密钥从 MongoDB 中获取客户端对象。
  • getUser(username, password):根据用户名和密码从 MongoDB 中获取用户对象。
  • saveToken(token, client, user):将令牌,客户端和用户对象保存到 MongoDB 中。
  • getAccessToken(accessToken):根据访问令牌从 MongoDB 中获取令牌对象。
  • getRefreshToken(refreshToken):根据刷新令牌从 MongoDB 中获取令牌对象。
  • revokeToken(token):根据访问令牌从 MongoDB 中删除令牌对象。

客户端授权

在 OAuth 2.0 流程中,客户端需要获得授权来访问用户资源。因此,我们需要在客户端界面上提供一个授权页面,让用户选择是否授权客户端访问其受保护的资源。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

在上面的代码中,我们在 app.js 文件中设置了一个 isLoggedIn 中间件,用于检查用户是否已经登录。我们使用 passport 模块和 Google Oauth2.0 策略来实现 Google 登录功能。我们使用 express-session 模块来管理用户会话,并使用 OAuth2Server 类来实现 OAuth 2.0 认证服务器。

当用户成功登录并访问主页时,我们展示一个授权列表,其中列出了用户已经授权访问的客户端。在用户登录后,我们使用 req.user._id 属性来获取用户 ID 并使用 oauth2.model.getTokens 方法获取与该用户关联的访问令牌,然后将 authorizedClients 传递给模板引擎。

在登录后,用户可以按下“授权”按钮来授权客户端访问其受保护的资源。我们定义了一个 POST /oauth/authorize 路由来处理授权请求。如果用户点击授权按钮,则会生成一个授权代码并重定向回客户端。如果用户点击拒绝按钮,则会向客户端返回错误响应。

使用访问令牌访问资源

在 OAuth 2.0 认证服务器授权成功后,客户端可以使用访问令牌来访问用户受保护的资源。我们在 Express.js 应用程序中实现了一个受保护的 API,该 API 仅通过有效的访问令牌进行授权访问。

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

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

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

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

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

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

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

以上代码中,我们在 Express.js 应用程序中创建了一个 /api 路由,并使用 app.oauth.authenticate() 方法将路由添加到 OAuth 2.0 认证服务器中。如果客户端提供的访问令牌有效,则继续访问 API 路由。在路由处理程序中,我们简单地返回一个 JSON 响应,显示“Hello,World!”的消息。

结论

在本文中,我们已经了解了如何在 Express.js 应用程序中实现 OAuth 2.0 认证服务器和客户端。我们实现了 OAuth 2.0 中的客户端授权,授权码流程,访问令牌的生成和验证,以及如何使用 OAuth 2.0 认证访问 API 资源。OAuth 2.0 是一种非常强大的认证和授权协议,它提供了一种简单而有效的方式来保护用户的隐私和安全,同时允许第三方开发者访问其受保护的资源。

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

纠错
反馈