JWT（JSON Web Token）是一种紧凑且安全的用于在网络应用之间传输信息的方式。在TypeScript编写的服务器端应用程序中实现JWT身份验证，可以确保只有经过授权的用户才能访问特定的路由和资源。本文将详细介绍如何在TypeScript服务器中实现JWT身份验证。
准备工作
在开始之前，请确保已经安装了Node.js和npm。接下来，需要创建一个新的Node.js项目，并初始化package.json文件。可以通过运行以下命令来完成这些步骤：
mkdir my-ts-server
cd my-ts-server
npm init -y
然后，添加所需的依赖项。对于本指南而言，至少需要安装express、jsonwebtoken以及@types/jsonwebtoken库。
npm install express jsonwebtoken @types/jsonwebtoken typescript ts-node --save
创建TypeScript配置文件
使用tsc –init命令生成tsconfig.json配置文件，并根据需要调整其中的设置。例如，设置target为ES6或更高版本，以便利用现代JavaScript特性；设置moduleResolution为node，以支持Node.js模块解析方式。
编写服务器代码
在src目录下创建一个名为server.ts的新文件。首先引入必要的模块并定义基本的Express应用结构：
// 导入所需模块
import express, { Request, Response } from 'express';
import jwt from 'jsonwebtoken';
// 创建Express应用实例
const app = express();
// 设置中间件
app.use(express.json());
// 定义端口号
const PORT = process.env.PORT || 3000;
// 启动服务器监听请求
app.listen(PORT, () => {
console.log(`Server is running on port ${PORT}`);
});
生成Token
当用户成功登录后，我们需要为他们生成一个JWT令牌。这通常是在处理登录请求时完成的。假设我们有一个简单的登录接口，它接受用户名和密码作为参数：
// 假设这是验证用户凭据的方法
function authenticateUser(username: string, password: string): boolean {
// 这里应该连接数据库进行实际的身份验证逻辑
return username === 'admin' && password === 'password';
}
// 登录接口
app.post('/login', (req: Request, res: Response) => {
const { username, password } = req.body;
if (!authenticateUser(username, password)) { return res.status(401).json({ message: 'Invalid credentials' });
}
// 如果验证通过，则创建一个token
const token = jwt.sign({ username }, 'your_secret_key', { expiresIn: '1h' });
// 返回token给客户端
res.json({ token });
});
请注意，在上面的例子中，为了简化演示，直接硬编码了用户名和密码。实际上应该使用更安全的方式存储用户信息，并在真实环境中避免将密钥硬编码在源代码中。
保护路由
为了确保某些路由只能由持有有效JWT令牌的用户访问，可以在这些路由之前添加一个中间件来进行令牌验证：
// 中间件：检查JWT令牌
function verifyToken(req: Request, res: Response, next: Function) {
const authHeader = req.headers.authorization;
if (!authHeader) { return res.sendStatus(401);
}
const token = authHeader.split(' ')[1];
try { const decoded = jwt.verify(token, 'your_secret_key'); req.user = decoded; next();
} catch (err) { return res.sendStatus(403);
}
}
// 受保护的路由示例
app.get('/protected', verifyToken, (req: Request, res: Response) => {
res.send(`Hello, ${req.user.username}!`);
});
上述代码中的verifyToken函数会检查请求头中的Authorization字段是否存在有效的JWT令牌。如果验证通过，则继续执行下一个中间件或路由处理器；否则返回相应的错误状态码。
通过以上步骤，你已经在TypeScript编写的服务器端应用程序中实现了基本的JWT身份验证机制。这只是一个起点，在实际开发过程中可能还需要考虑更多方面，如刷新令牌、多因素认证等。但无论如何，掌握这一基础技能将有助于构建更加安全可靠的应用程序。
