Web应用程序的安全优先开发实践。将每个外部输入视为恶意输入，每个密钥视为神圣不可侵犯，每次授权检查视为强制性的。安全不是一个阶段——它是对每一行涉及用户数据、身份验证或外部系统的代码的约束。

没有威胁模型就硬加上去的控制措施只是猜测。在加固之前，花五分钟像攻击者一样思考：

Spoofing（欺骗） 有人能冒充用户/服务吗？ 身份验证、签名验证

Tampering（篡改） 数据能在传输中或静态时被更改吗？ 完整性检查、参数化查询、HTTPS

Repudiation（抵赖） 某个操作之后能被否认吗？ 安全事件的审计日志

Information disclosure（信息泄露） 数据会泄露吗？ 加密、字段白名单、通用错误

Denial of service（拒绝服务） 会被压垮吗？ 速率限制、输入大小上限、超时

Elevation of privilege（权限提升） 用户能获得他们不应拥有的权利吗？ 授权检查、最小权限

如果您无法为一个功能命名信任边界，您就没有准备好保护它。这是OWASP A04: 不安全设计——大多数漏洞始于设计，而非代码。

这些是防护模式，不是排名。关于2021年的排序，请参阅 references/security-checklist.md 中的快速参考表。

注入（SQL、NoSQL、操作系统命令）

// 错误：通过字符串拼接导致SQL注入
const query = `SELECT * FROM users WHERE id = '${userId}'`;

// 正确：参数化查询
const user = await db.query('SELECT * FROM users WHERE id = $1', [userId]);

// 正确：带参数化输入的ORM
const user = await prisma.user.findUnique({ where: { id: userId } });

// 密码哈希
import { hash, compare } from 'bcrypt';

const SALT_ROUNDS = 12;
const hashedPassword = await hash(plaintext, SALT_ROUNDS);
const isValid = await compare(plaintext, hashedPassword);

// 会话管理
app.use(session({
  secret: process.env.SESSION_SECRET,  // 来自环境变量，而非代码
  resave: false,
  saveUninitialized: false,
  cookie: {
    httpOnly: true,     // JavaScript无法访问
    secure: true,       // 仅HTTPS
    sameSite: 'lax',    // CSRF防护
    maxAge: 24 * 60 * 60 * 1000,  // 24小时
  },
}));

// 错误：将用户输入渲染为HTML
element.innerHTML = userInput;

// 正确：使用框架自动转义（React默认这样做）
return <div>{userInput}</div>;

// 如果必须渲染HTML，先进行消毒
import DOMPurify from 'dompurify';
const clean = DOMPurify.sanitize(userInput);

// 始终检查授权，而不仅仅是身份验证
app.patch('/api/tasks/:id', authenticate, async (req, res) => {
  const task = await taskService.findById(req.params.id);

  // 检查已认证用户是否拥有此资源
  if (task.ownerId !== req.user.id) {
    return res.status(403).json({
      error: { code: 'FORBIDDEN', message: 'Not authorized to modify this task' }
    });
  }

  // 继续更新
  const updated = await taskService.update(req.params.id, req.body);
  return res.json(updated);
});

// 安全头（对Express使用helmet）
import helmet from 'helmet';
app.use(helmet());

// 内容安全策略
app.use(helmet.contentSecurityPolicy({
  directives: {
    defaultSrc: ["'self'"],
    scriptSrc: ["'self'"],
    styleSrc: ["'self'", "'unsafe-inline'"],  // 如有可能请收紧
    imgSrc: ["'self'", 'data:', 'https:'],
    connectSrc: ["'self'"],
  },
}));

// CORS — 限制为已知来源
app.use(cors({
  origin: process.env.ALLOWED_ORIGINS?.split(',') || 'http://localhost:3000',
  credentials: true,
}));

// 绝不在API响应中返回敏感字段
function sanitizeUser(user: UserRecord): PublicUser {
  const { passwordHash, resetToken, ...publicFields } = user;
  return publicFields;
}

// 对环境变量中的密钥使用
const API_KEY = process.env.STRIPE_API_KEY;
if (!API_KEY) throw new Error('STRIPE_API_KEY not configured');

任何时候服务器获取用户影响的URL——Webhook、"从URL导入"、图片代理、链接预览——攻击者都可以将其指向内部服务（云元数据、localhost、私有IP）。

// 错误：获取用户给你的任何内容
await fetch(req.body.webhookUrl);

// 正确：白名单方案+主机，如果任何解析出的IP是私有的则拒绝，禁止重定向
import { lookup } from 'node:dns/promises';
import ipaddr from 'ipaddr.js';

const ALLOWED_HOSTS = new Set(['hooks.example.com']);

async function assertSafeUrl(raw: string): Promise<URL> {
  const url = new URL(raw);
  if (url.protocol !== 'https:') throw new Error('https only');
  if (!ALLOWED_HOSTS.has(url.hostname)) throw new Error('host not allowed');
  // 解析所有记录；单个私有/保留地址即检查失败。
  const addrs = await lookup(url.hostname, { all: true });
  if (addrs.some((a) => ipaddr.parse(a.address).range() !== 'unicast')) {
    throw new Error('private/reserved IP');
  }
  return url;
}

await fetch(await assertSafeUrl(req.body.webhookUrl), { redirect: 'error' });

range() !== 'unicast' 检查覆盖回环、链路本地 169.254.169.254（云元数据，SSRF的第一大目标）、私有和唯一本地范围，涵盖IPv4和IPv6。

注意事项——这仍然存在TOCTOU缺口。 fetch 在检查之后会再次解析DNS，因此使用短TTL记录的攻击者可以在验证和连接之间重新绑定到内部IP。对于高风险面，解析一次并连接到固定的IP，或者在前面放置一个过滤代理（request-filtering-agent / ssrf-req-filter）。

import { z } from 'zod';

const CreateTaskSchema = z.object({
  title: z.string().min(1).max(200).trim(),
  description: z.string().max(2000).optional(),
  priority: z.enum(['low', 'medium', 'high']).default('medium'),
  dueDate: z.string().datetime().optional(),
});

// 在路由处理器处验证
app.post('/api/tasks', async (req, res) => {
  const result = CreateTaskSchema.safeParse(req.body);
  if (!result.success) {
    return res.status(422).json({
      error: {
        code: 'VALIDATION_ERROR',
        message: 'Invalid input',
        details: result.error.flatten(),
      },
    });
  }
  // result.data 现在是有类型且已验证的
  const task = await taskService.create(result.data);
  return res.status(201).json(task);
});

// 限制文件类型和大小
const ALLOWED_TYPES = ['image/jpeg', 'image/png', 'image/webp'];
const MAX_SIZE = 5 * 1024 * 1024; // 5MB

function validateUpload(file: UploadedFile) {
  if (!ALLOWED_TYPES.includes(file.mimetype)) {
    throw new ValidationError('File type not allowed');
  }
  if (file.size > MAX_SIZE) {
    throw new ValidationError('File too large (max 5MB)');
  }
  // 不要信任文件扩展名——关键时检查魔数
}

并非所有审计发现都需要立即处理。使用此决策树：

npm audit报告一个漏洞
├── 严重性：严重或高
│   ├── 易受攻击的代码在您的应用程序中可达吗？
│   │   ├── 是 --> 立即修复（更新、打补丁或替换依赖）
│   │   └── 否（仅开发依赖、未使用的代码路径）--> 尽快修复，但不是阻塞项
│   └── 有可用的修复吗？
│       ├── 有 --> 更新到已修补的版本
│       └── 无 --> 检查变通方案，考虑替换依赖，或加入白名单并设定审查日期
├── 严重性：中等
│   ├── 在生产环境可达吗？--> 在下一个发布周期修复
│   └── 仅开发环境？--> 方便时修复，在待办事项中跟踪
└── 严重性：低
    └── 在定期依赖更新时跟踪并修复

当您推迟修复时，记录原因并设定审查日期。

npm audit 捕获已知CVE；它无法捕获恶意或仿冒（typosquatted）包。此外：

import rateLimit from 'express-rate-limit';

// 通用API速率限制
app.use('/api/', rateLimit({
  windowMs: 15 * 60 * 1000, // 15分钟
  max: 100,                   // 每个窗口100个请求
  standardHeaders: true,
  legacyHeaders: false,
}));

// 对认证端点使用更严格的限制
app.use('/api/auth/', rateLimit({
  windowMs: 15 * 60 * 1000,
  max: 10,  // 每15分钟10次尝试
}));

.env文件：
  ├── .env.example  → 提交（带占位值的模板）
  ├── .env          → 不提交（包含真实密钥）
  └── .env.local    → 不提交（本地覆盖）

.gitignore必须包含：
  .env
  .env.local
  .env.*.local
  *.pem
  *.key

# 检查意外暂存的密钥
git diff --cached | grep -i "password\|secret\|api_key\|token"

如果密钥曾被提交，请轮换它。 删除该行或重写历史是不够的——它到达远程的那一刻就假设它已泄露。首先撤销并重新签发密钥，然后将其从历史中清除。

如果您的应用调用LLM——聊天机器人、摘要器、代理、RAG——它就继承了一个新的攻击面。将其映射到LLM应用OWASP Top 10（2025）：

// 错误：将模型输出视为命令或标记
const sql = await llm.generate(`Write SQL for: ${userQuestion}`);
await db.query(sql);                                   // 任意查询执行
container.innerHTML = await llm.reply(userMessage);   // 通过模型实现的存储型XSS

// 正确：模型输出是数据——防御性解析，然后验证，然后编码
let intent;
try {
  intent = CommandSchema.parse(JSON.parse(await llm.replyJson(userMessage)));
} catch {
  throw new ValidationError('unexpected model output'); // JSON.parse或schema失败
}
await runAllowlistedAction(intent.action, intent.params);
container.textContent = await llm.reply(userMessage);

### 身份验证
- [ ] 密码使用bcrypt/scrypt/argon2哈希（盐轮数 ≥ 12）
- [ ] 会话令牌是httpOnly、secure、sameSite
- [ ] 登录有速率限制
- [ ] 密码重置令牌会过期

### 授权
- [ ] 每个端点都检查用户权限
- [ ] 用户只能访问自己的资源
- [ ] 管理操作需要管理员角色验证

### 输入
- [ ] 所有用户输入在边界处验证
- [ ] SQL查询已参数化
- [ ] HTML输出已编码/转义
- [ ] 服务端URL获取已白名单化（无指向内部服务的SSRF）

### 数据
- [ ] 代码或版本控制中没有密钥
- [ ] 敏感字段从API响应中排除
- [ ] PII静态加密（如适用）

### 基础设施
- [ ] 已配置安全头（CSP、HSTS等）
- [ ] CORS限制为已知来源
- [ ] 依赖已审计漏洞
- [ ] 错误消息不暴露内部信息

### 供应链
- [ ] Lockfile已提交；CI使用 `npm ci` 安装
- [ ] 新依赖已审查（维护、下载量、postinstall脚本）

### AI / LLM（如果使用）
- [ ] 模型输出被视为不可信（无eval/SQL/innerHTML/shell）
- [ ] 密钥和其他用户的数据排除在提示词之外
- [ ] 工具/代理权限已约束；破坏性操作需要确认

有关详细的安全检查清单和预提交验证步骤，请参阅 references/security-checklist.md。

"这是内部工具，安全无关紧要" 内部工具也会被攻破。攻击者瞄准最薄弱的环节。

"我们以后再加安全" 安全改造比一开始就构建难10倍。现在就加上。

"没人会试图利用这个" 自动化扫描器会发现它。通过隐藏实现安全不是安全。

"框架处理安全问题" 框架提供工具，而非保证。您仍然需要正确使用它们。

"这只是个原型" 原型会变成生产环境。从第一天起就养成安全习惯。

"这里做威胁建模是小题大做" 花五分钟思考"我会如何攻击这个？"能防止后续任何控制措施都无法修补的设计缺陷。

"这只是LLM输出，只是文本" 那个"文本"可能是一条SQL语句、一个script标签或一条shell命令。像对待任何不可信输入一样对待它。

来源说明：本文内容整理自开源项目 agentic-awesome-skills（中文翻译版），遵循 CC BY 4.0（知识共享署名 4.0 国际）许可协议，此处作为中文资料整理分享，版权归原作者所有。

Security And Hardening 实用指南

加固代码以抵御漏洞。在处理用户输入、身份验证、数据存储或外部集成时使用。在构建任何接受不可信数据、管理用户会话或与第三方服务交互的功能时使用。

人工智能

聊天机器人

消息队列

身份验证

数据存储

内容安全

敏感数据

密钥管理

数据泄露

数据库

服务器

路由

NoSQL

Agent

ReAct 

JSON

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

腾讯云开发者社区是腾讯云官方开发者社区，致力于打造开发者的技术分享型社区。提供专栏,问答，沙龙等产品和服务，汇聚海量精品云计算使用和开发经验，致力于帮助开发者快速成长与发展，营造开放的云计算技术生态圈。

Security And Hardening 实用指南

Security And Hardening 实用指南

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐