## 新增功能 ### 1. 屏幕阅读器兼容性增强(a11y) - 无障碍工具库:src/shared/lib/a11y.ts - aria-live Hook:src/shared/hooks/use-aria-live.ts - a11y 组件:skip-link/visually-hidden/focus-trap/aria-status - 增强 UI:table.tsx 系统性 ARIA role,dialog.tsx aria-modal - 审计文档:docs/accessibility/a11y-audit.md(WCAG 2.1 AA 清单) ### 2. 视觉回归测试 - 测试套件:tests/visual/(homepage + 3 个 dashboard) - 3 视口(desktop/tablet/mobile)× 2 主题(light/dark) - 动态元素遮罩,避免误报 - playwright.config.ts 新增 visual-chromium 项目 - 文档:docs/testing/visual-regression.md ### 3. 短信/微信推送渠道集成 - 新模块:src/modules/notifications/ - 4 个渠道:SMS(阿里云/腾讯云)、WeChat(公众号)、Email(SMTP)、In-App - 分发器按用户偏好并行多渠道发送 - 外部 SDK 动态 import,Mock 模式开发可用 - 文档:docs/notifications/channels.md ### 4. 漏洞扫描 CI 集成 - CI security-scan job:npm audit + Snyk + Trivy FS + OWASP ZAP - 独立工作流 security.yml:每周一深度扫描 + 容器镜像扫描 - 配置:suppressions.json + .trivyignore - 本地脚本:security-scan.sh/ps1 - 文档:docs/security/scanning.md(SLA 分级) ### 5. 灾备方案 - 脚本:backup-verify/backup-offsite-sync/dr-drill/failover/health-check - CI 增强:备份后校验+异地同步,每周灾备演练 - 独立工作流 dr-drill.yml:每周一凌晨 4 点自动演练 - 文档:docs/dr/dr-plan.md(RTO 4h/RPO 24h)+ dr-runbook.md(6 故障场景) ## 验证 - npx tsc --noEmit:0 错误 - npm run lint:0 错误 0 警告
164 lines
6.3 KiB
YAML
164 lines
6.3 KiB
YAML
name: Security
|
|
|
|
# 独立安全扫描工作流:深度安全扫描
|
|
# - 定时:每周一凌晨 3 点执行
|
|
# - 手动触发:workflow_dispatch(可指定扫描目标)
|
|
on:
|
|
schedule:
|
|
- cron: "0 3 * * 1" # 每周一凌晨 3 点
|
|
workflow_dispatch:
|
|
inputs:
|
|
target_url:
|
|
description: "DAST 扫描目标 URL(留空则使用 NEXTAUTH_URL secret 或 localhost:8015)"
|
|
required: false
|
|
default: ""
|
|
skip_dast:
|
|
description: "跳过 DAST 扫描"
|
|
type: boolean
|
|
required: false
|
|
default: false
|
|
|
|
jobs:
|
|
deep-security-scan:
|
|
runs-on: ubuntu-latest
|
|
steps:
|
|
- uses: actions/checkout@v4
|
|
|
|
- uses: actions/setup-node@v4
|
|
with:
|
|
node-version: 20
|
|
|
|
- name: Install dependencies
|
|
run: npm ci
|
|
|
|
# 1. 依赖扫描:npm audit
|
|
- name: Dependency scan (npm audit)
|
|
run: |
|
|
echo "::group::npm audit"
|
|
npm audit --audit-level=moderate || true
|
|
npm audit --json > audit-report.json || true
|
|
echo "::endgroup::"
|
|
continue-on-error: true
|
|
|
|
# 2. 深度依赖分析 + 静态分析:Snyk
|
|
- name: Snyk dependency & code scan
|
|
uses: snyk/actions/node@master
|
|
env:
|
|
SNYK_TOKEN: ${{ secrets.SNYK_TOKEN }}
|
|
with:
|
|
args: --severity-threshold=medium --sarif-file-output=snyk.sarif
|
|
continue-on-error: true
|
|
|
|
# 3. 文件系统扫描:Trivy FS(代码 + 依赖)
|
|
- name: Trivy filesystem scan
|
|
run: |
|
|
echo "::group::Trivy FS scan"
|
|
trivy fs --format json --output trivy-fs-report.json --exit-code 0 .
|
|
trivy fs --format table --exit-code 0 .
|
|
echo "::endgroup::"
|
|
continue-on-error: true
|
|
|
|
# 4. 容器镜像扫描:构建 nextjs-app 镜像并扫描
|
|
- name: Build & scan container image
|
|
run: |
|
|
echo "::group::Build Next.js standalone"
|
|
SKIP_ENV_VALIDATION=1 NEXT_TELEMETRY_DISABLED=1 npm run build
|
|
mkdir -p .next/standalone/public
|
|
mkdir -p .next/standalone/.next/static
|
|
cp -r public/* .next/standalone/public/ || true
|
|
cp -r .next/static/* .next/standalone/.next/static/ || true
|
|
cp Dockerfile .next/standalone/Dockerfile
|
|
echo "::endgroup::"
|
|
|
|
echo "::group::Build Docker image"
|
|
docker build -t nextjs-app:scan .next/standalone
|
|
echo "::endgroup::"
|
|
|
|
echo "::group::Trivy image scan"
|
|
trivy image --format json --output trivy-image-report.json --exit-code 0 nextjs-app:scan
|
|
trivy image --format table --exit-code 0 nextjs-app:scan
|
|
echo "::endgroup::"
|
|
continue-on-error: true
|
|
|
|
# 5. DAST:OWASP ZAP 基线扫描
|
|
- name: OWASP ZAP Baseline Scan (DAST)
|
|
if: ${{ github.event.inputs.skip_dast != 'true' }}
|
|
uses: zaproxy/action-baseline@v0.10.0
|
|
with:
|
|
target: ${{ github.event.inputs.target_url || secrets.NEXTAUTH_URL || 'http://localhost:8015' }}
|
|
cmd_options: '-a -j'
|
|
continue-on-error: true
|
|
|
|
# 6. 生成汇总报告
|
|
- name: Generate summary report
|
|
if: always()
|
|
run: |
|
|
echo "# 安全扫描汇总报告" > security-summary.md
|
|
echo "" >> security-summary.md
|
|
echo "- 扫描时间: $(date -u '+%Y-%m-%d %H:%M:%S UTC')" >> security-summary.md
|
|
echo "- 触发方式: ${{ github.event_name }}" >> security-summary.md
|
|
echo "- 运行编号: ${{ github.run_id }}" >> security-summary.md
|
|
echo "" >> security-summary.md
|
|
|
|
echo "## 扫描结果" >> security-summary.md
|
|
echo "" >> security-summary.md
|
|
echo "| 扫描类型 | 状态 | 详情 |" >> security-summary.md
|
|
echo "|---------|------|------|" >> security-summary.md
|
|
|
|
# npm audit 汇总
|
|
if [ -f audit-report.json ]; then
|
|
AUDIT_SUMMARY=$(jq -r '.metadata.vulnerabilities | "critical:\(.critical) high:\(.high) moderate:\(.moderate) low:\(.low) info:\(.info)"' audit-report.json 2>/dev/null || echo "解析失败")
|
|
echo "| npm audit | 完成 | ${AUDIT_SUMMARY} |" >> security-summary.md
|
|
else
|
|
echo "| npm audit | 未生成报告 | - |" >> security-summary.md
|
|
fi
|
|
|
|
# Trivy FS 汇总
|
|
if [ -f trivy-fs-report.json ]; then
|
|
FS_COUNT=$(jq -r '[.Results[]?.Vulnerabilities[]?] | length' trivy-fs-report.json 2>/dev/null || echo "0")
|
|
echo "| Trivy FS | 完成 | 漏洞数: ${FS_COUNT} |" >> security-summary.md
|
|
else
|
|
echo "| Trivy FS | 未生成报告 | - |" >> security-summary.md
|
|
fi
|
|
|
|
# Trivy Image 汇总
|
|
if [ -f trivy-image-report.json ]; then
|
|
IMG_COUNT=$(jq -r '[.Results[]?.Vulnerabilities[]?] | length' trivy-image-report.json 2>/dev/null || echo "0")
|
|
echo "| Trivy Image | 完成 | 漏洞数: ${IMG_COUNT} |" >> security-summary.md
|
|
else
|
|
echo "| Trivy Image | 未生成报告 | - |" >> security-summary.md
|
|
fi
|
|
|
|
# Snyk 汇总
|
|
if [ -f snyk.sarif ]; then
|
|
SNYK_COUNT=$(jq -r '[.runs[]?.results[]?] | length' snyk.sarif 2>/dev/null || echo "0")
|
|
echo "| Snyk | 完成 | 问题数: ${SNYK_COUNT} |" >> security-summary.md
|
|
else
|
|
echo "| Snyk | 未生成报告(可能缺少 SNYK_TOKEN) | - |" >> security-summary.md
|
|
fi
|
|
|
|
echo "" >> security-summary.md
|
|
echo "## 处理建议" >> security-summary.md
|
|
echo "" >> security-summary.md
|
|
echo "- **Critical**: 24 小时内修复或缓解" >> security-summary.md
|
|
echo "- **High**: 7 天内修复" >> security-summary.md
|
|
echo "- **Medium**: 30 天内修复" >> security-summary.md
|
|
echo "- **Low**: 90 天内评估处理" >> security-summary.md
|
|
echo "" >> security-summary.md
|
|
echo "详细报告见 artifact: security-reports-full" >> security-summary.md
|
|
|
|
echo "::notice::安全扫描汇总报告已生成"
|
|
cat security-summary.md
|
|
|
|
# 7. 上传所有报告
|
|
- uses: actions/upload-artifact@v3
|
|
if: always()
|
|
with:
|
|
name: security-reports-full
|
|
path: |
|
|
audit-report.json
|
|
trivy-fs-report.json
|
|
trivy-image-report.json
|
|
snyk.sarif
|
|
security-summary.md
|