14 预览页鉴权 | EdgeAgent Docs

本文介绍 2D 组态预览页支持的鉴权相关 URL 参数,以及在需要登录校验或需要独立登录态两类典型场景下的使用方式。适用于需要对预览页访问做权限控制、或在多账号环境下隔离登录态的配置人员。

1 参数说明

预览链接支持追加以下三个参数:

参数	是否必需	作用说明
`requireAuth`	鉴权场景必填	设为 `1` 时开启预览页鉴权,进入预览页触发登录校验,未登录时弹出登录窗口
`tokenKey`	可选	指定用于读取或隔离登录态的 token 存储 Key。配置后不会继承当前站点默认登录用户信息,适用于多账号或独立登录态场景
`_t`	可选	时间戳或随机串,用于避免浏览器缓存;建议在 `tokenKey` 场景下同步携带

💡 三个参数可按需组合使用,是否携带 tokenKey 是决定「继承登录态」还是「独立登录态」的关键。

2 使用方式

根据是否需要独立登录态,选择以下两种方式之一。

2.1 场景对比速查

场景	所需参数	登录态来源	典型用途
开启鉴权(继承当前登录态)	`requireAuth=1`	站点默认登录用户	对外部用户做基础访问控制
开启鉴权 + 独立登录态	`requireAuth=1` + `tokenKey` + `_t`	指定 `tokenKey` 对应的存储 Key	多账号隔离、独立会话演示

2.2 场景 A:开启鉴权,继承当前登录态

在预览链接末尾追加 requireAuth=1 即可:


https://web-dev.iheatingos.com/configuration2d/preview
  ?r=1770796093364
  &id=meta2d.2026123171528
  &folder=2D%E7%BB%84%E6%80%81%E7%BC%96%E5%86%99%E6%96%87%E6%A1%A3%E5%9B%BE%E7%BA%B8
  &component=false
  &requireAuth=1

ℹ️ 实际使用时,URL 为一行连续字符串。上方分行展示仅为便于阅读。

效果表现:

用户未登录:预览页弹出登录窗口,完成登录后进入预览。
用户已登录:直接使用当前登录用户信息进入预览,无需重复登录。

场景 A 登录弹窗 图 1 场景 A:未登录用户进入预览页时的登录弹窗

2.3 场景 B:开启鉴权并使用独立登录态

在链接中追加 requireAuth=1,并指定 tokenKey,同时建议携带 _t 避免缓存:


https://web-dev.iheatingos.com/configuration2d/preview
  ?r=1770796093364
  &id=meta2d.2026123171528
  &folder=2D%E7%BB%84%E6%80%81%E7%BC%96%E5%86%99%E6%96%87%E6%A1%A3%E5%9B%BE%E7%BA%B8
  &component=false
  &requireAuth=1
  &_t=1770796251819
  &tokenKey=xxtoken1

效果表现:

预览页始终弹出登录窗口,要求重新登录。
登录态写入 tokenKey=xxtoken1 对应的存储 Key,不读取也不复用站点默认登录信息,从而实现登录态隔离。

场景 B 独立登录弹窗 图 2 场景 B:使用独立 tokenKey 时的登录弹窗

⚠️ tokenKey 的值需保证唯一,不同业务或账号之间建议使用不同的 Key,避免登录态相互覆盖。

3 常见问题

问题	可能原因	处理建议
加了 `requireAuth=1` 却未弹登录窗	当前已登录且为场景 A	属正常现象;如需强制登录,改用场景 B
场景 B 登录后下次访问仍弹窗	未携带相同的 `tokenKey`	确保每次访问使用一致的 `tokenKey`
URL 参数失效	参数顺序或编码问题	检查 `&` 分隔符、URL 编码是否正确,必要时追加 `_t` 清除缓存