Merge branch 'main' into login_page
This commit is contained in:
@@ -0,0 +1,207 @@
|
||||
/**
|
||||
* 安全工具类 - 防止 XSS 攻击
|
||||
*/
|
||||
|
||||
import DOMPurify from 'dompurify';
|
||||
|
||||
// 配置 DOMPurify 的安全策略
|
||||
const DOMPurifyConfig = {
|
||||
// 允许的标签
|
||||
ALLOWED_TAGS: [
|
||||
'p', 'br', 'strong', 'em', 'u', 's', 'del', 'ins',
|
||||
'h1', 'h2', 'h3', 'h4', 'h5', 'h6',
|
||||
'ul', 'ol', 'li', 'blockquote', 'pre', 'code',
|
||||
'a', 'img', 'table', 'thead', 'tbody', 'tr', 'th', 'td',
|
||||
'div', 'span', 'figure', 'figcaption'
|
||||
],
|
||||
// 允许的属性
|
||||
ALLOWED_ATTR: [
|
||||
'href', 'title', 'alt', 'src', 'class', 'id', 'style',
|
||||
'target', 'rel', 'width', 'height'
|
||||
],
|
||||
// 允许的协议
|
||||
ALLOWED_URI_REGEXP: /^(?:(?:(?:f|ht)tps?|mailto|tel|callto|cid|xmpp):|[^a-z]|[a-z+.\-]+(?:[^a-z+.\-:]|$))/i,
|
||||
// 禁止的标签和属性
|
||||
FORBID_TAGS: ['script', 'object', 'embed', 'form', 'input', 'button'],
|
||||
FORBID_ATTR: ['onerror', 'onload', 'onclick', 'onmouseover', 'onfocus', 'onblur'],
|
||||
// 其他安全配置
|
||||
KEEP_CONTENT: true,
|
||||
RETURN_DOM: false,
|
||||
RETURN_DOM_FRAGMENT: false,
|
||||
RETURN_DOM_IMPORT: false,
|
||||
SANITIZE_DOM: true,
|
||||
SANITIZE_NAMED_PROPS: true,
|
||||
WHOLE_DOCUMENT: false,
|
||||
// 自定义钩子函数
|
||||
HOOKS: {
|
||||
// 在清理前处理
|
||||
beforeSanitizeElements: (currentNode: Element) => {
|
||||
// 移除所有 script 标签
|
||||
if (currentNode.tagName === 'SCRIPT') {
|
||||
currentNode.remove();
|
||||
return null;
|
||||
}
|
||||
// 移除所有事件处理器
|
||||
const eventAttrs = ['onclick', 'onload', 'onerror', 'onmouseover', 'onfocus', 'onblur'];
|
||||
eventAttrs.forEach(attr => {
|
||||
if (currentNode.hasAttribute(attr)) {
|
||||
currentNode.removeAttribute(attr);
|
||||
}
|
||||
});
|
||||
},
|
||||
// 在清理后处理
|
||||
afterSanitizeElements: (currentNode: Element) => {
|
||||
// 确保所有链接都有 rel="noopener noreferrer"
|
||||
if (currentNode.tagName === 'A') {
|
||||
const href = currentNode.getAttribute('href');
|
||||
if (href && href.startsWith('http')) {
|
||||
currentNode.setAttribute('rel', 'noopener noreferrer');
|
||||
currentNode.setAttribute('target', '_blank');
|
||||
}
|
||||
}
|
||||
// 确保所有图片都有 alt 属性
|
||||
if (currentNode.tagName === 'IMG') {
|
||||
if (!currentNode.getAttribute('alt')) {
|
||||
currentNode.setAttribute('alt', '');
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
};
|
||||
|
||||
/**
|
||||
* 安全地清理 HTML 内容
|
||||
* @param html 需要清理的 HTML 字符串
|
||||
* @returns 清理后的安全 HTML 字符串
|
||||
*/
|
||||
export function sanitizeHTML(html: string): string {
|
||||
if (!html || typeof html !== 'string') {
|
||||
return '';
|
||||
}
|
||||
|
||||
try {
|
||||
return DOMPurify.sanitize(html, DOMPurifyConfig);
|
||||
} catch (error) {
|
||||
console.error('HTML sanitization failed:', error);
|
||||
// 如果清理失败,返回转义的纯文本
|
||||
return escapeHTML(html);
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* 转义 HTML 特殊字符
|
||||
* @param text 需要转义的文本
|
||||
* @returns 转义后的文本
|
||||
*/
|
||||
export function escapeHTML(text: string): string {
|
||||
if (!text || typeof text !== 'string') {
|
||||
return '';
|
||||
}
|
||||
|
||||
const map: { [key: string]: string } = {
|
||||
'&': '&',
|
||||
'<': '<',
|
||||
'>': '>',
|
||||
'"': '"',
|
||||
"'": ''',
|
||||
'/': '/',
|
||||
'`': '`',
|
||||
'=': '='
|
||||
};
|
||||
|
||||
return text.replace(/[&<>"'`=\/]/g, (s) => map[s]);
|
||||
}
|
||||
|
||||
/**
|
||||
* 验证 URL 是否安全
|
||||
* @param url 需要验证的 URL
|
||||
* @returns 是否为安全 URL
|
||||
*/
|
||||
export function isValidURL(url: string): boolean {
|
||||
if (!url || typeof url !== 'string') {
|
||||
return false;
|
||||
}
|
||||
|
||||
try {
|
||||
const urlObj = new URL(url);
|
||||
// 只允许 http 和 https 协议
|
||||
return ['http:', 'https:'].includes(urlObj.protocol);
|
||||
} catch {
|
||||
return false;
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* 安全地处理 Markdown 内容
|
||||
* @param markdown Markdown 文本
|
||||
* @returns 安全的 HTML 字符串
|
||||
*/
|
||||
export function safeMarkdownToHTML(markdown: string): string {
|
||||
if (!markdown || typeof markdown !== 'string') {
|
||||
return '';
|
||||
}
|
||||
|
||||
// 首先转义可能的 HTML 标签
|
||||
const escapedMarkdown = markdown
|
||||
.replace(/<script\b[^<]*(?:(?!<\/script>)<[^<]*)*<\/script>/gi, '')
|
||||
.replace(/<iframe\b[^<]*(?:(?!<\/iframe>)<[^<]*)*<\/iframe>/gi, '')
|
||||
.replace(/<object\b[^<]*(?:(?!<\/object>)<[^<]*)*<\/object>/gi, '')
|
||||
.replace(/<embed\b[^<]*(?:(?!<\/embed>)<[^<]*)*<\/embed>/gi, '');
|
||||
|
||||
return escapedMarkdown;
|
||||
}
|
||||
|
||||
/**
|
||||
* 清理用户输入
|
||||
* @param input 用户输入
|
||||
* @returns 清理后的安全输入
|
||||
*/
|
||||
export function sanitizeUserInput(input: string): string {
|
||||
if (!input || typeof input !== 'string') {
|
||||
return '';
|
||||
}
|
||||
|
||||
// 移除控制字符
|
||||
let cleaned = input.replace(/[\x00-\x1F\x7F-\x9F]/g, '');
|
||||
|
||||
// 限制长度
|
||||
if (cleaned.length > 10000) {
|
||||
cleaned = cleaned.substring(0, 10000);
|
||||
}
|
||||
|
||||
return cleaned.trim();
|
||||
}
|
||||
|
||||
/**
|
||||
* 验证图片 URL 是否安全
|
||||
* @param url 图片 URL
|
||||
* @returns 是否为安全的图片 URL
|
||||
*/
|
||||
export function isValidImageURL(url: string): boolean {
|
||||
if (!isValidURL(url)) {
|
||||
return false;
|
||||
}
|
||||
|
||||
// 检查是否为图片文件
|
||||
const imageExtensions = /\.(jpg|jpeg|png|gif|webp|svg|bmp|ico)(\?.*)?$/i;
|
||||
return imageExtensions.test(url);
|
||||
}
|
||||
|
||||
/**
|
||||
* 创建安全的图片元素
|
||||
* @param src 图片源
|
||||
* @param alt 替代文本
|
||||
* @param title 标题
|
||||
* @returns 安全的图片 HTML
|
||||
*/
|
||||
export function createSafeImage(src: string, alt: string = '', title: string = ''): string {
|
||||
if (!isValidImageURL(src)) {
|
||||
return '';
|
||||
}
|
||||
|
||||
const safeSrc = escapeHTML(src);
|
||||
const safeAlt = escapeHTML(alt);
|
||||
const safeTitle = escapeHTML(title);
|
||||
|
||||
return `<img src="${safeSrc}" alt="${safeAlt}" title="${safeTitle}" class="markdown-image" style="max-width: 100%; height: auto;">`;
|
||||
}
|
||||
Reference in New Issue
Block a user