Node.js中JWT实现身份验证的详细步骤_Node.js

在开始之前，我假设你已经在你的机器上安装了node.js、mongodb和vs code，并且你知道如何创建mongodb数据库和基本的restful api。

让我们开始吧！

什么是jwt认证？

jwt身份验证依赖json web令牌来确认web应用中用户的身份。json web令牌是使用密钥进行数字签名。

简而言之，jwt身份为网站提供一个密码。一旦你登录，你就得到了这个密码。

json web token由三个部分组成，由点.分开:

header
payload
signature

下面是jwt的基本结构：

xxxx.yyyy.zzzz

header： 这部分包含有关令牌的信息，如其类型和如何保护。
payload： 这部分包含关于用户的声明，如用户名或角色。
signature： 确保令牌的完整性，并验证它没有被更改，这可以确保代码安全。

现在，让我们看看在node.js项目中进行jwt身份验证的步骤。

步骤1：设置项目

首先，创建一个新目录：

mkdir nodejs-jwt-auth
cd nodejs-jwt-auth

在终端中运行以下命令初始化项目：

npm init -y

接下来，通过以下命令安装必要的依赖项：

npm install express mongoose jsonwebtoken dotenv

上面的命令将安装：

express：用于构建web服务器。
mongoose：mongodb的odm（对象数据建模）库。
jsonwebtoken：生成和验证json web令牌（jwt）以进行身份验证。
dotenv：从.env文件加载环境变量。

此时，您的package.json文件应该如下所示：

步骤2：获取mongodb连接字符串

要获取mongodb连接字符串，请查看以下链接。

9 steps to build a restful api with node.js, mongodb, and express

步骤3：创建.env文件

为了保护mongodb连接信息，让我们在根目录中创建一个名为.env的新文件。

将以下代码添加到.env文件中。

mongodb_url=<your mongodb connection string>
secret_key="your_secret_key_here"

将 <your mongodb connection string> 替换为您从mongodb atlas获得的连接字符串。

mongodb_url='mongodb+srv://shefali:********@cluster0.sscvg.mongodb.net/nodejs-jwt-auth'
secret_key="thisismysecretkey"

最后，在mongodb_url中，我添加了nodejs-jwt-auth，这是我们的数据库名称。

步骤4：设置express应用程序

在根目录下创建一个名为index.js的文件，并将以下代码添加到该文件中。

const express = require("express");
const mongoose = require("mongoose");

require("dotenv").config(); //for using variables from .env file.

const app = express();
const port = 3000;

//middleware provided by express to parse incoming json requests.
app.use(express.json()); 

mongoose.connect(process.env.mongodb_url).then(() => {
  console.log("mongodb is connected!");
});

app.get("/", (req, res) => {
  res.send("hello world!");
});

app.listen(port, () => {
  console.log(`server is listening on port ${port}`);
});

现在，让我们通过以下命令运行服务器。

node index.js

输出如下图所示：

通过使用命令node index.js，必须在每次更改文件时重新启动服务器。为了避免这种情况，您可以使用以下命令安装nodemon。

npm install -g nodemon

现在使用下面的命令运行服务器，它会在每次更改文件时重新启动服务器。

nodemon index.js

步骤5：创建用户模型

在根目录下创建一个名为“models”的新目录，并在其中创建一个名为“user.js”的新文件。

将以下代码添加到user.js文件中：

const mongoose = require("mongoose");

const userschema = new mongoose.schema({
  username: {
    type: string,
    required: true,
    unique: true,
  },
  password: {
    type: string,
    required: true,
  },
});

module.exports = mongoose.model("user", userschema);

步骤6：实现身份验证路由

在根目录中，创建一个名为“routes”的新目录，并在其中创建一个名为“auth.js”的文件。

现在，将以下代码添加到该文件中：

const express = require("express");
const jwt = require("jsonwebtoken");
const user = require("../models/user");
const router = express.router();

// signup route
router.post("/signup", async (req, res) => {
  try {
    const { username, password } = req.body;
    const user = new user({ username, password });
    await user.save();
    res.status(201).json({ message: "new user registered successfully" });
  } catch (error) {
    res.status(500).json({ message: "internal server error" });
  }
});

// login route
router.post("/login", async (req, res) => {
  const { username, password } = req.body;
  try {
    const user = await user.findone({ username });

    if (!user) {
      return res.status(401).json({ message: "invalid username or password" });
    }
    if (user.password !== password) {
      return res.status(401).json({ message: 'invalid username or password' });
    }
    // generate jwt token
    const token = jwt.sign(
      { id: user._id, username: user.username },
      process.env.secret_key
    );
    res.json({ token });
  } catch (error) {
    res.status(500).json({ message: "internal server error" });
  }
});

module.exports = router;

步骤7：使用中间件保护路由

在根目录中，创建一个名为middleware.js的新文件，并将以下代码添加到该文件中。

const jwt = require("jsonwebtoken");

function verifyjwt(req, res, next) {
  const token = req.headers["authorization"];

  if (!token) {
    return res.status(401).json({ message: "access denied" });
  }

  jwt.verify(token, process.env.secret_key, (err, data) => {
    if (err) {
      return res.status(401).json({ message: "failed to authenticate token" });
    }
    req.user = data;
    next();
  });
}

module.exports = verifyjwt;

代码是一个中间件函数，用于在应用程序中验证json web令牌（jwt）。

步骤8：解码细节

现在要解码详细信息，请修改index.js，如下所示：

const express = require('express');
const authrouter = require('./routes/auth');
const mongoose = require("mongoose");
const verifyjwt = require("./middleware")

require("dotenv").config(); //for using variables from .env file.

const app = express();
const port = 3000;

mongoose.connect(process.env.mongodb_url).then(() => {
    console.log("mongodb is connected!");
});
app.use(express.json());

//authentication route
app.use('/auth', authrouter);

//decodedetails route
app.get('/decodedetails', verifyjwt, (req, res) => {
  const { username } = req.user;
  res.json({ username });
});

app.listen(port, () => {
  console.log(`server is running on port ${port}`);
});

/auth路由由authrouter处理，用于用户身份验证。

app.get('/decodedetails', verifyjwt, (req, res) => {
  const { username } = req.user;
  res.json({ username });
});

当向/decodedetails发出请求时，verifyjwt中间件验证jwt令牌。

步骤9：测试api

为了测试api，使用了名为thunder client的vs code扩展。

注册

向 http://localhost:3000/auth/signup 发送一个post请求，其中包含headers content-type : application/json 和以下json主体：

{
    "username": "shefali",
    "password": "12345678"
}

在响应中，您将看到消息“新用户注册成功”。

decodedetails

向 http://localhost:3000/decodedetails 发送一个get请求，并带有令牌值的authorization头。

在响应中，您将获得用户名。

您已经在node.js应用程序中成功实现了jwt身份验证。这种方法提供了一种安全有效的方式，来验证web应用程序中的用户。

以上就是node.js中jwt实现身份验证的详细步骤的详细内容，更多关于node.js jwt身份验证的资料请关注代码网其它相关文章！

Node.js中JWT实现身份验证的详细步骤

2025年02月13日 • Node.js •我要评论