通过 JSON Web Token (JWT) 进行身份验证广泛用于保护 API 并确保只有授权用户才能访问某些数据。在这篇文章中，我们将向您展示如何使用 Node.js 在后端配置 JWT，并使用 TypeScript 在 ReactJS 前端配置 JWT，从令牌生成到安全用户会话管理。

使用 Node.js 配置后端

首先，让我们使用 Node.js、Express 和 TypeScript 创建一个 API，用于生成和验证 JWT 令牌。

步骤一：配置环境

创建一个新项目并安装主要依赖项：

npm init -y
npm install express jsonwebtoken bcryptjs dotenv
npm install -D typescript @types/node @types/express @types/jsonwebtoken @types/bcryptjs ts-node

为 TypeScript 配置创建 tsconfig.json 文件：

{
  "compilerOptions": {
    "target": "es6",
    "module": "commonjs",
    "outDir": "./dist",
    "strict": true,
    "esModuleInterop": true
  },
  "include": ["src/**/*.ts"],
  "exclude": ["node_modules"]
}

第 2 步：构建后端

创建一个简单的结构，从 server.ts 文件和路由文件夹开始来组织身份验证路由。

服务器.ts

import express, { Application } from 'express';
import dotenv from 'dotenv';
import authRoutes from './routes/authRoutes';

dotenv.config();

const app: Application = express();
app.use(express.json());

app.use('/api/auth', authRoutes);

const PORT = process.env.PORT || 5000;
app.listen(PORT, () => console.log(`Servidor rodando na porta ${PORT}`));

路线/authRoutes.ts

创建身份验证路由文件。这里我们将有一个登录路由来验证用户并返回 JWT 令牌。

import express, { Request, Response } from 'express';
import jwt from 'jsonwebtoken';
import bcrypt from 'bcryptjs';

const router = express.Router();

// Simulação de banco de dados
const users = [{ username: 'usuario', password: 'senha123' }];

router.post('/login', async (req: Request, res: Response) => {
    const { username, password } = req.body;
    const user = users.find(u => u.username === username);

    if (!user || !(await bcrypt.compare(password, user.password))) {
        return res.status(401).json({ message: 'Credenciais inválidas' });
    }

    const token = jwt.sign({ username }, process.env.JWT_SECRET as string, { expiresIn: '1h' });
    res.json({ token });
});

export default router;

第 3 步：使用中间件保护路由

添加中间件以保护需要身份验证的路由。

中间件/authMiddleware.ts

import { Request, Response, NextFunction } from 'express';
import jwt from 'jsonwebtoken';

interface JwtPayload {
    username: string;
}

export const authMiddleware = (req: Request, res: Response, next: NextFunction): void => {
    const token = req.headers['authorization'];
    if (!token) {
        res.status(403).json({ message: 'Token não fornecido' });
        return;
    }

    jwt.verify(token, process.env.JWT_SECRET as string, (err, decoded) => {
        if (err) {
            res.status(401).json({ message: 'Token inválido' });
            return;
        }
        req.user = decoded as JwtPayload;
        next();
    });
};

使用 ReactJS 配置前端

在前端，我们将使用 React 来处理身份验证、发送凭证和存储 JWT 令牌。

步骤1：配置登录界面

首先，创建一个 Login.tsx 组件来捕获用户的凭据并向后端发送登录请求。

登录.tsx

import React, { useState } from 'react';
import axios from 'axios';

const Login: React.FC = () => {
    const [username, setUsername] = useState('');
    const [password, setPassword] = useState('');
    const [error, setError] = useState('');

    const handleLogin = async (e: React.FormEvent) => {
        e.preventDefault();
        try {
            const response = await axios.post('/api/auth/login', { username, password });
            localStorage.setItem('token', response.data.token);
            window.location.href = '/dashboard';
        } catch (err) {
            setError('Credenciais inválidas');
        }
    };

    return (
        

             setUsername(e.target.value)}
            />
             setPassword(e.target.value)}
            />
            Login
            {error && 
{error}
}
        
    );
};

export default Login;

第 2 步：保护前端的路由

为受保护的路由创建一个函数，使用 JWT 令牌访问 API。

私有路由.tsx

import React from 'react';
import { Route, Redirect, RouteProps } from 'react-router-dom';

interface PrivateRouteProps extends RouteProps {
    component: React.ComponentType;
}

const PrivateRoute: React.FC = ({ component: Component, ...rest }) => (
    
            localStorage.getItem('token') ? (
                
            ) : (
                
            )
        }
    />
);

export default PrivateRoute;

步骤 3：在请求中发送 JWT 令牌

配置 axios 自动在受保护的请求中包含 JWT 令牌。

axiosConfig.ts

import axios from 'axios';

const token = localStorage.getItem('token');
if (token) {
    axios.defaults.headers.common['Authorization'] = token;
}

export default axios;

步骤 4：受保护路由的使用示例

现在，创建一个需要令牌才能访问的受保护页面的示例。

仪表板.tsx

import React, { useEffect, useState } from 'react';
import axios from './axiosConfig';

const Dashboard: React.FC = () => {
    const [data, setData] = useState('');

    useEffect(() => {
        const fetchData = async () => {
            try {
                const response = await axios.get('/api/protected');
                setData(response.data.message);
            } catch (error) {
                console.error(error);
            }
        };
        fetchData();
    }, []);

    return 
{data || 'Carregando...'}
;
};

export default Dashboard;

结论

通过这些步骤，我们在 TypeScript 中为一个在后端使用 Node.js 并在前端使用 React 的项目设置了完整的 JWT 身份验证。这种方法高度安全、高效，并被广泛采用来保护现代应用程序。