用途:该技能提供安全管理和使用 Mapbox 访问令牌的实践指导,帮助在创建、配置、存储和轮换令牌时降低泄露风险。
令牌类型:公共令牌(pk.)可安全用于客户端代码,仅限公共作用域(如 styles:tiles、styles:read、fonts:read、datasets:read、vision:read),可设置 URL 限制;密钥令牌(sk.)绝不可暴露在客户端,拥有完整 API 访问能力,仅限服务端使用,并可创建管理其他令牌(如 styles:write、styles:list、tokens:read、tokens:write);临时令牌(tk.*)由密钥令牌创建,有效期最长 1 小时,适合一次性或临时委派访问。
主要能力:按最小权限原则选择作用域;为公共令牌设置 URL 限制(如 https://myapp.com/、https://.myapp.com/、http://localhost:),避免使用 * 或 .com/ 等过宽模式;按开发、预发布、生产环境分别创建令牌;密钥令牌存储于环境变量或密钥管理服务,不硬编码、不提交版本库;客户端仅使用受 URL 限制的公共令牌,并在构造地图前校验令牌存在且非占位符,避免出现空白地图。
参考文件:references/token-management.md 提供不同打包工具的变量名与访问方式;references/rotation-monitoring.md 提供轮换策略、监控与审计清单;references/incident-response.md 提供事件响应流程与常见错误示例。
适用场景:创建新令牌、选择公共或密钥令牌、设置令牌限制、实施轮换、调查安全事件、开展安全审计、团队培训及代码审查。
限制:资料未提供具体定价、平台覆盖范围或效果数据;文中示例基于 Vite,其他框架的写法需查阅对应参考文件。使用时应避免在单一表达式中混用 import.meta.env 与 process.env,以免在浏览器中触发 ReferenceError。