配置环境、来源白名单与密钥

配置环境、来源白名单与密钥

1. 选择环境

进入项目后,在左侧项目选择器下方选择 productionstagingdevelopment。接入指南显示的地址、密钥状态和客户端应用都属于当前环境。

接入指南中的 Collector、Browser SDK、Go Module、Client Key、Origin 和密钥状态

操作路径:项目 → 接入指南。先核对页面标题中的项目名和环境,再复制参数。

官方托管环境使用:

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-go

2. 配置 Browser 来源

打开“项目 → 项目设置”,在当前环境的“来源白名单”中填写 Browser SDK 所在站点的 Origin:

https://shop.example.com
https://www.example.com

Origin 只能包含协议、主机和可选端口,不要填写路径、查询参数或结尾通配符。保存后 Collector 最多需要 60 秒刷新缓存。

3. 核对环境边界

项目设置中的报表时区、production 来源白名单、IP 排除规则、速率限制和密钥轮换

操作路径:项目 → 项目设置。保存环境边界后返回接入指南。

  • IP 排除规则:每行一个 IP 或 CIDR,用于排除办公网络等内部流量。
  • 每秒事件上限:当前环境的采集速率边界。
  • 报表时区:属于项目级配置,会影响所有环境的报表日期边界。

4. 选择正确密钥

接入端 密钥 初始化字段
Browser pk_… writeKey
Go sk_… ServerKey
Android、iOS、小程序 ck_… clientKey

如果模板仍显示 YOUR_BROWSER_KEYYOUR_SERVER_KEYYOUR_CLIENT_KEY,说明当前页面会话没有对应明文。Owner/Admin 可在“密钥轮换”中生成新值。

轮换会让旧密钥立即失效。先确认可以同步更新应用,再执行轮换;不要为了查看旧值而轮换生产密钥。