SuperAPI AI 工具集

mapbox-token-security

安全与审计

查看项目

更新于 10-16 00:05

技能介绍

用途:为安全有效地管理 Mapbox 访问令牌提供安全实践指导,适用于创建新令牌、选择公开或密钥令牌、设置令牌限制、实施轮换、调查安全事件、开展安全审计以及审查代码中的令牌泄露。

令牌类型:公开令牌(pk.)可安全用于客户端代码,仅限特定公开作用域并支持 URL 限制,不能访问敏感 API,适用于客户端 Web 应用、移动应用、公开演示和网站内嵌地图;允许作用域包括 styles:tiles、styles:read、fonts:read、datasets:read、vision:read。密钥令牌(sk.)绝不可暴露在客户端代码中,可拥有任意作用域的完整 API 访问,仅限服务端使用,可创建和管理其他令牌,适用于服务端应用、后端服务、CI/CD 流水线和行政任务。临时令牌(tk.*)由密钥令牌创建,最长存活 1 小时,单一用途并自动过期,适用于一次性操作、临时委派访问和短期演示。

主要能力:遵循最小权限原则授予作用域,按用例组合作用域(如公开地图展示用 styles:read、fonts:read、styles:tiles;样式管理用 styles:read、styles:write、styles:list;令牌管理用 tokens:read、tokens:write;只读审计用 styles:list、styles:read、tokens:read)。为公开令牌配置 URL 限制,推荐 https://myapp.com/、https://.myapp.com/、http://localhost: 等模式,避免 * 或 .com/ 等过宽模式,并按生产、预发、开发环境分别创建令牌。服务端密钥令牌应存于环境变量或 AWS Secrets Manager、HashiCorp Vault 等密钥管理服务,加密静态存储,通过 IAM 策略限制访问并记录使用;客户端只使用带 URL 限制的公开令牌。令牌轮换方面,在泄露、人员离职、疑似入侵、服务下线或合规要求时强制轮换,生产环境建议每 90 天、高安全环境每 30 天轮换,可采用零停机流程(新建同作用域令牌、灰度验证、逐步上线、观察 24–48 小时、撤销旧令牌)或应急流程(立即撤销、创建替代、紧急部署、通知团队、调查原因)。监控方面跟踪各令牌请求量、地理分布、错误率、异常峰值和未授权域请求,对异常 IP/地区、流量骤增超过 200%、错误率超过 10%、允许 URL 外请求和异常时段访问设置告警,并执行月度与季度审计。

使用方式:invoke this skill 的典型时机包括创建新令牌、决定公开或密钥令牌、设置令牌限制、实施轮换、调查安全事件、安全审计和团队培训。示例中客户端安全用法为 mapboxgl.accessToken = mapboxToken;(使用带 URL 限制的公开令牌);服务端通过 .env 文件保存 MAPBOX_SECRET_TOKEN=sk.ey...,并在 .gitignore 中包含 .env、.env.local、.env.*.local。

限制与注意事项:绝不将令牌提交到版本控制、硬编码、明文存储或通过邮件与 Slack 分享;密钥令牌不可在客户端代码中暴露;避免使用 styles:、tokens: 等过度宽泛作用域;避免长期不轮换或无 URL 限制的令牌。资料未提供具体 API 调用命令、价格或平台细节,暂未提供。