详解Node.js使用token进行认证的简单示例

下面我将为你详细讲解“详解Node.js使用token进行认证的简单示例”的完整攻略。

简介

在构建Web应用程序时，身份验证是非常重要的。一种常见的方法是使用基于token的身份验证。本文将介绍如何使用Node.js和JSON Web Tokens（JWT）实现基于token的身份验证。我们将创建一个简单的Express应用程序，并使用JWT生成和验证token。

步骤

第1步：安装依赖

我们将使用以下npm包来构建应用程序：

• express - 用于创建应用程序和路由
• body-parser - 用于解析HTTP请求正文中的JSON数据
• jsonwebtoken - 用于生成和验证JWT

在命令行中运行以下命令来安装这些npm包：

npm install express body-parser jsonwebtoken

第2步：设置路由和控制器

我们将创建两个路由：

• /authenticate - 用于生成token
• /dashboard - 要求token进行身份验证

首先，我们将创建一个名为 routes/auth.js 的文件，并添加以下代码：

const express = require('express');
const router = express.Router();
const jwt = require('jsonwebtoken');

router.post('/authenticate', (req, res) => {
    const user = {
        id: 1,
        username: 'john.doe',
        email: '[e-mail]'
    }

    jwt.sign({ user }, 'secretkey', { expiresIn: '30s' }, (err, token) => {
        res.json({ token });
    });
});

module.exports = router;

上面的代码创建了一个POST路由 /authenticate，用于生成包含用户名和过期时间的JWT。在这个示例中，我们使用固定的用户信息和密钥（secretkey）。在实际应用程序中，您可以从数据库中检索有关用户的信息并使用更安全的密钥。

接下来，我们将创建一个名为 routes/dashboard.js 的文件，并添加以下代码：

const express = require('express');
const router = express.Router();
const jwt = require('jsonwebtoken');

function verifyToken(req, res, next) {
    const token = req.header('Authorization').split(' ')[1];

    if (!token) return res.status(401).send('Access Denied');

    try {
        const decoded = jwt.verify(token, 'secretkey');
        req.user = decoded.user;
        next();
    } catch (err) {
        res.status(400).send('Invalid Token');
    }
}

router.get('/', verifyToken, (req, res) => {
    res.send(`Welcome ${req.user.username}!`);
});

module.exports = router;

上面的代码创建了一个GET路由 /dashboard，它要求在请求头中传递包含JWT的Authorization字段。该路由使用 verifyToken 中间件进行身份验证，该中间件会对JWT进行验证，并在验证无误后将用户信息添加到请求对象中。如果JWT无效，则中间件将返回“Invalid Token”错误消息。如果JWT有效，则路由将响应“Welcome [username]!”消息。

第3步：设置应用程序

首先，我们需要将所需的依赖项导入应用程序。打开 index.js 文件，并按照以下方式编辑：

const express = require('express');
const bodyParser = require('body-parser');
const app = express();

const authRoute = require('./routes/auth');
const dashboardRoute = require('./routes/dashboard');

app.use(bodyParser.json());

app.use('/auth', authRoute);
app.use('/dashboard', dashboardRoute);

app.listen(3000, () => console.log('Server started on port 3000'));

上面的代码将 routes/auth.js 和 routes/dashboard.js 导入应用程序，并将它们分别设置为 /auth 和 /dashboard 的路由。应用程序还使用 body-parser 解析请求正文中的JSON数据，并在http://localhost:3000 上启动服务器。

第4步：测试应用程序

现在我们已经设置好了应用程序，让我们使用POSTman测试该应用程序。首先，我们将向 /authenticate 发送POST请求，以获取包含JWT的响应消息。接下来，我们将向 /dashboard 发送GET请求，并在请求头中传递Authorization字段，其中包含JWT。

第一条测试示例

• 打开POSTman
• 创建POST请求，URL为 http://localhost:3000/auth/authenticate
• 在请求主体中添加以下JSON数据：

{
    "username": "john.doe",
    "password": "mysecret"
}

• 发送请求并复制响应主体中的JWT值
• 创建GET请求，URL为 http://localhost:3000/dashboard
• 在请求标头中添加Authorization键，并将其值设置为Bearer [JWT]
• 发送请求并检查响应主体中的消息，它应该输出：Welcome john.doe!

第二条测试示例

• 打开POSTman
• 创建POST请求，URL为 http://localhost:3000/auth/authenticate
• 在请求主体中添加以下JSON数据：

{
    "username": "jane.doe",
    "password": "mysecret"
}

• 发送请求并复制响应主体中的JWT值
• 创建GET请求，URL为 http://localhost:3000/dashboard
• 在请求标头中添加Authorization键，并将其值设置为Bearer [JWT]
• 发送请求并检查响应，它应该返回“Invalid Token”错误消息。

结论

这就是使用Node.js和JSON Web Tokens进行基于token的身份验证的简单示例。我们创建了两个路由，一个用于生成JWT，一个用于要求JWT进行身份验证。我们还使用了 jsonwebtoken npm包来生成和验证JWT。如果你想进一步了解JWT和Node.js的身份验证，请查看相关的官方文档。