EchoScan 浏览器验证器
EchoScan 浏览器 校验器在浏览器中运行, 支持预登录设备信任和浏览器
指纹 它使用可发布浏览器 Environment ID 返回服务器发行的 imprint· ;
您信任的后端然后查询 EchoScan 报告 API v1 并应用您的商业政策 .
设备身份兼容性
2.x和3.x版本使用相同的设备身份命名空间并需要兼容的服务 支持 v4 提交 API 。 现有历史尚存 2.0不自动识别或合并到这个命名空间.
如果设备识别不可用, 运行失败而不提交印记 。 这个技术 失败不能确定风险.
SDK 3.0 诊断边界
3.0版本删除 getLastRunTrace() 已公布的 2.x、,
与先前的详细诊断和错误导出.
run() 返回时 imprint 和可选最小值 diagnostic 收据;
SDK_VERSION 识别已安装的 SDK.
失败使用 EchoScanError.category: 取消、 超时、 处理、 运行 in progress,
检测失败,配置或提交失败。 失败者还包括SDK版本和最低限度诊断收据: not_sent (无相关API请求), unconfirmed (未收到同意),或 received (观察到可持久服务器接收),及其API操作. 身份证从不提供诊断。 原始错误,反应机构,
原因、确切期限和内部身份失效原因不是公共合同.
迁移前删除痕量输出和旧错误类检查 。 匹配后端必须部署
先说 对于支持,提供SDK版本,公用出错类别和最小诊断收据.
这些支持细节不能取代正式报告或确定风险.
安装
npm install @echoscan/[email protected]
在 EchoScan 中创建浏览器环境, 将精确的允许来源注册到校验者会在哪里
运行,并复制其可出版 environmentId。环境标识不是一个密钥 API 或
工作区身份证.
生成印记
import { createEchoScan } from '@echoscan/browser-verifier'
const verifier = createEchoScan({
environmentId: 'env_0123456789abcdef0123456789abcdef',
})
const { imprint } = await verifier.run()
成功运行返回 imprint 并且可能包括最低限度的诊断收据。 新印记使用 imp_<32 lowercase hex> 格式。 发送
标记到您信任的后端,并有受保护的登录、注册、付款或其他
业务请求.
您的后端使用它唯一的服务器密钥 API 查询报告 API v1:
GET https://api.echoscan.org/api/v1/fingerprint/report/{imprint}
X-API-Key: <server-secret-api-key>
Accept: application/json
永远不要在浏览器代码中放置密钥或工作空间ID. 保持完整的报告和最后允许, 对您的后端提出质疑、审查或拒绝决定.
无害环境管理、UMD和CDN
Npm 软件包提供无害环境管理、 TypeScript 声明和一个单文件的 UMD 构建, 以曝光方式显示
window.EchoScan. 在自主办无害环境管理建设时,公布其匹配情况 chunks/ 目录也一样.
EchoScan还为当前支持的CDN构建服务于:
- 无害环境管理:
https://cdn.echoscan.org/v1/echoscan.esm.js - UMD: (英语)
https://cdn.echoscan.org/v1/echoscan.umd.js
文档
- 开发者 API 和集成指南
- OpenAPI 合同
- EchoScan 平台概览
- 公共扫描 ——第一党产品示范,不是 替换客户浏览器环境或可信后端集成.