配置环境、来源白名单与密钥
配置环境、来源白名单与密钥
1. 选择环境
进入项目后,在左侧项目选择器下方选择 production、staging 或 development。接入指南显示的地址、密钥状态和客户端应用都属于当前环境。
操作路径:项目 → 接入指南。先核对页面标题中的项目名和环境,再复制参数。
官方托管环境使用:
Collector: https://collector.entmesh.mliev.com
Browser SDK: https://static.1ms.run/entmesh/sdk-js/v0.7.0/entmesh.umd.js
Go Module: cnb.cool/mliev/entmesh/sdk-go2. 配置 Browser 来源
打开“项目 → 项目设置”,在当前环境的“来源白名单”中填写 Browser SDK 所在站点的 Origin:
https://shop.example.com
https://www.example.comOrigin 只能包含协议、主机和可选端口,不要填写路径、查询参数或结尾通配符。保存后 Collector 最多需要 60 秒刷新缓存。
3. 核对环境边界
操作路径:项目 → 项目设置。保存环境边界后返回接入指南。
- IP 排除规则:每行一个 IP 或 CIDR,用于排除办公网络等内部流量。
- 每秒事件上限:当前环境的采集速率边界。
- 报表时区:属于项目级配置,会影响所有环境的报表日期边界。
4. 选择正确密钥
| 接入端 | 密钥 | 初始化字段 |
|---|---|---|
| Browser | pk_… |
writeKey |
| Go | sk_… |
ServerKey |
| Android、iOS、小程序 | ck_… |
clientKey |
如果模板仍显示 YOUR_BROWSER_KEY、YOUR_SERVER_KEY 或 YOUR_CLIENT_KEY,说明当前页面会话没有对应明文。Owner/Admin 可在“密钥轮换”中生成新值。
轮换会让旧密钥立即失效。先确认可以同步更新应用,再执行轮换;不要为了查看旧值而轮换生产密钥。