为什么重要
没有记录的验证，只是一种意见。
使用身份服务本身会带来风险：必须有人能说明谁看过申请人的身份证件，以及对它做了什么。台账就是你给出答案的方式。
对你而言
按顺序证明发生了什么以及结果如何。数月后当某项决定受到质疑时，台账就是证据，而且它比身份证件图像留存得更久。
对你的合规负责人而言
用带筛选的导出来应对隐私请求或审计，而不是花上一周来回发邮件。每次导出本身也是一条条目。
对你的申请人而言
对已存储文档的每次查看和下载都会留下一条条目，因此“谁看过我的档案？”这个问题，企业可以给出答案。针对身份证件照片的逐图像事件和申请人自助查看功能即将推出。
记录的内容
完整的事件词汇表。
每个条目都使用其中一个名称，因此同一个筛选条件的含义始终一致。名称按其在账本中的显示形式列出。
登录和访问
进入账户的每一种方式，以及每一次幕后查看。
- LOGIN_2FA_CHALLENGED
- 一次登录到达了双重验证步骤。
- LOGIN_SUCCESS
- 一次登录完成。
- FORENSIC_DETAIL_ACCESSED
- 有人打开了某条目背后的网络和设备证据。这需要书面理由，而该请求本身也会被记录。
验证请求
申请人的全过程，从链接到同意。
- SIGN_LINK_OPENED
- 申请人打开其验证链接。
- EULA_ACCEPTED
- 申请人在继续之前接受条款。
- TASK_CREATED / TASK_SENT
- 由某个人或某个 API 密钥创建并发送了一个验证请求。
- TASK_VIEWED / TASK_VOIDED
- 通过 API 获取或取消请求。
记录和导出
任何离开账户的内容都会留下痕迹。
- DOCUMENT_VIEWED
- 在门户中打开了一份已存储的文档。
- DOCUMENT_DOWNLOADED
- 在门户中或通过 API 下载了一份文档。
- DOCUMENT_EMAILED
- 一份文档通过电子邮件发送给了收件人。
- AUDIT_EXPORTED
- 通过 API 检索了审计轨迹。读取记录这件事本身也会被记录。
账户和 API
设置和凭据，并附有操作者信息。
- SETTING_CHANGED
- 通过 API 更改了账户设置。
- SESSION_CREATED / SESSION_REVOKED
- 打开或撤销了一个 API 会话。
- ACCOUNT_MAILING_ADDRESS_UPDATED / BILLING_ADDRESS_UPDATED
- 账户详情发生变更。
请求时间线（每个请求一条，与台账并存）
每个请求还带有自己的时间线。它是工作记录，而不是仅追加的台账，因此我们单独命名。
- BIOMETRIC_VERIFIED / BIOMETRIC_FAILED
- 验证引擎报告身份核验通过或未通过，并附上未通过的检查项。
- RETENTION_PURGE / RETENTION_PURGE_FAILED
- 保留期清理任务在保留期结束时删除请求的已存储文档，或未能删除。
- GDPR_ERASURE
- 根据删除权请求对个人信息进行脱敏。
即将推出
即将推出专门用于闭环身份验证的事件。我们将其逐一列出，以便您监督我们兑现。
- ID_IMAGE_VIEWED / ID_IMAGE_DOWNLOADED
- 每次打开或下载身份证件图像或自拍照时，记录由谁操作。
- DECISION_RECORDED
- 你的团队针对某次验证记录的接受或拒绝，并附上理由。
- API_KEY_CREATED / API_KEY_REVOKED
- 将密钥生命周期事件记为台账条目。目前它们随密钥一起存储，而不是作为条目。
- VERIFICATION_VERIFIED / VERIFICATION_FAILED
- 将验证结果作为仅追加的台账条目提供给 ShieldID API 账户。目前它们被写入请求时间线。
- IMAGE_PURGED
- 为每一次自动清除身份证件图像提供回执。
- Applicant view
- 提供一个自助页面，让被验证者查看谁访问过其验证。
- CSV export
- 面向审计人员的带筛选导出，电子表格格式。JSON 导出目前已可用。
条目的结构
十四个字段，每次都有。证据则按请求提供。
一条条目以通俗文字和机器可读的形式说明：谁、做了什么、对什么、结果如何。网络和设备证据与之并列存放，需通过有日志记录的请求才能查看。
条目
- 操作者类型
- 个人、签署人、系统、管理员或 API 密钥。API 密钥的操作带有该密钥自身的 id，因此脚本与个人永远不会混淆。
- 操作者标签
- 当时的姓名或电子邮件，而不是会随人员离职而变化的实时查询结果。
- 操作
- 事件名称，来自上方的固定词汇表。
- 类别与严重程度
- 认证、文档、签署、任务、账户、安全或系统；严重程度从信息到严重。
- 目标
- 该操作所针对的对象：一次验证、一份证件、一个人或一项设置。
- 摘要
- 一句通俗易懂的话，在事发当时写下。
- 结果
- 成功、失败或被拒绝。被拒绝的操作与成功的操作一样醒目地记录在案。
- 元数据
- 结构化详情：API 密钥标签、环境（sandbox 或生产）、请求 ID 等。
- 时间戳
- 服务器时间，按顺序记录，绝不可编辑。
证据，附于已记录的请求之后
- IP 地址及范围
- 公网、运营商级 NAT、私有、回环或未知，让审核人员知道该给予多大程度的信任。
- 网络运营商
- 反向 DNS、注册人、ASN，以及该地址是否属于托管服务商。
- 位置
- 国家、地区、城市和邮政编码，以及精度半径和数据是否已过期。
- 设备
- 一小组信号，例如时区、屏幕尺寸、平台和语言，被精简为稳定的 SHA-256 指纹。不会保存原始浏览器数据。
- 上报地址
- 浏览器自身上报的内容，标记为未经验证。
证据在响应发出之后才进行补充丰富，绝不占用申请人的关键流程路径，并且在补充完成之前会标记为未补充。
防篡改证据
我们不称它为区块链，因为它不是。它只是一张数据库拒绝任何人编辑的表。
用平实的语言说明是什么在保护这份记录，让您的审计人员可以对照我们的实际行为核实我们的说法。
仅追加，由数据库强制执行
治理表上的触发器会在任何更新或删除操作时抛出错误。应用代码、管理员以及我们自己都受其约束。
一个范围狭窄且有日志记录的例外
账户被删除时，其条目会与账户分离而不是被清除，并且仅当其他所有列都逐字节完全一致时才会如此。不会截断任何内容。
写入通过受保护的函数进行
条目由具有明确权限的数据库函数写入，起因是一次真实事故：行级安全策略悄无声息地吞掉了写入。这个函数的存在，正是该问题的修复。
查看证据本身就是一个事件
未提供至少十二个字符的书面理由，就无法读取网络和设备详情，该读取会以读取者的名义记录为 FORENSIC_DETAIL_ACCESSED。
清除图像不会影响记录
身份证件图像会在较短的计时后被清除。台账条目是独立的记录，与图像没有关联，因此删除图像绝不会移除描述其处理经过的条目。
搜索和筛选
像查询数据库一样搜索它，因为它本来就是数据库。
每个筛选条件都在服务器端校验，并限定在你的账户范围内。筛选列表只显示实际出现过的值，因此你不会搜到空结果。
- 操作者
- 某个人，或以 id 标识的 API 密钥。可隔离某个集成所做的一切。
- 目标
- 某次验证、某份文档或某个人。这位申请人的档案上发生过的一切。
- 操作
- 词汇表中的任意事件名称。
- 类别、严重程度、结果
- 仅安全事件、仅失败、仅被拒绝的操作。
- 日期范围
- 起止时间，精确到秒。
- 自由文本
- 覆盖摘要、操作者标签、对象标签和操作。刻意不会搜索原始元数据。
目前导出格式为 JSON：通过 API 导出一次验证的完整轨迹，上限五百行，每次检索都会记录为 AUDIT_EXPORTED。面向客户的 CSV 导出即将推出。
试一试
一份示例台账，虚构且可搜索。
筛选、展开一行、打开证据。下面的姓名和事件均为演示而虚构；字段集合和行为则是真实的。
Activity Ledger
示例数据已显示 18 条记录。
2026-09-16 · 13:41:22
LOGIN_2FA_CHALLENGED
Wren Halloway · 门户登录
Success示例数据——虚构账本为此事件保存的所有字段
- 类别
- AUTH
- 严重程度
- NOTICE
- 摘要
- 已为来自新设备的门户登录请求第二重验证。
- IP 范围
- PUBLIC
- 位置
- 汉密尔顿, 安大略省
- 设备
- 桌面设备 · macOS · 1512x982 · America/Toronto
- API 密钥
- 无——是人，不是密钥
- 环境
- production
- 请求 ID
- req_9f2c41ad8e
- 记录时间
- 2026-09-16T13:41:22-04:00
2026-09-16 · 13:41:58
LOGIN_SUCCESS
Wren Halloway · 门户登录
Success示例数据——虚构账本为此事件保存的所有字段
- 类别
- AUTH
- 严重程度
- INFO
- 摘要
- 第二重验证通过后，登录完成。
- IP 范围
- PUBLIC
- 位置
- 汉密尔顿, 安大略省
- 设备
- 桌面设备 · macOS · 1512x982 · America/Toronto
- API 密钥
- 无——是人，不是密钥
- 环境
- production
- 请求 ID
- req_9f2c41ad90
- 记录时间
- 2026-09-16T13:41:58-04:00
2026-09-16 · 14:02:10
SESSION_CREATED
入驻组件（生产环境） · API 会话 4a81
Success示例数据——虚构账本为此事件保存的所有字段
- 类别
- SECURITY
- 严重程度
- NOTICE
- 摘要
- 已使用用户引导小组件密钥打开一个 API 会话。
- IP 范围
- PUBLIC
- 位置
- 多伦多, 安大略省
- 设备
- 服务器 · 无浏览器客户端
- API 密钥
- 入驻组件（生产环境）
- 环境
- production
- 请求 ID
- req_4a81b0c7d2
- 记录时间
- 2026-09-16T14:02:10-04:00
2026-09-16 · 14:02:11
TASK_CREATED
入驻组件（生产环境） · 对 Ottoline Marchetti-Fife 的验证
Success示例数据——虚构账本为此事件保存的所有字段
- 类别
- TASK
- 严重程度
- INFO
- 摘要
- 已为新申请人发起验证请求，并已签发链接。
- IP 范围
- PUBLIC
- 位置
- 多伦多, 安大略省
- 设备
- 服务器 · 无浏览器客户端
- API 密钥
- 入驻组件（生产环境）
- 环境
- production
- 请求 ID
- req_4a81b0c7d3
- 记录时间
- 2026-09-16T14:02:11-04:00
2026-09-16 · 14:19:47
SIGN_LINK_OPENED
Ottoline Marchetti-Fife · 验证链接 7c19
Success示例数据——虚构账本为此事件保存的所有字段
- 类别
- SIGNING
- 严重程度
- INFO
- 摘要
- 申请人在手机上打开了其验证链接。
- IP 范围
- CGNAT
- 位置
- 密西沙加, 安大略省
- 设备
- 移动设备 · Android · 412x915 · 3 个触控点
- API 密钥
- 无——是人，不是密钥
- 环境
- production
- 请求 ID
- req_7c19aa4402
- 记录时间
- 2026-09-16T14:19:47-04:00
2026-09-16 · 14:20:12
EULA_ACCEPTED
Ottoline Marchetti-Fife · 验证同意书
Success示例数据——虚构账本为此事件保存的所有字段
- 类别
- SIGNING
- 严重程度
- NOTICE
- 摘要
- 申请人已阅读并接受验证同意声明。
- IP 范围
- CGNAT
- 位置
- 密西沙加, 安大略省
- 设备
- 移动设备 · Android · 412x915 · 3 个触控点
- API 密钥
- 无——是人，不是密钥
- 环境
- production
- 请求 ID
- req_7c19aa4419
- 记录时间
- 2026-09-16T14:20:12-04:00
2026-09-16 · 14:22:35
BIOMETRIC_VERIFIED
验证引擎 · 对 Ottoline Marchetti-Fife 的验证
Success示例数据——虚构账本为此事件保存的所有字段
- 类别
- SIGNING
- 严重程度
- INFO
- 摘要
- 证件、人脸比对和活体检测均已通过；结果已记录。
- IP 范围
- PRIVATE
- 位置
- 多伦多, 安大略省
- 设备
- Worker · 无浏览器客户端
- API 密钥
- 入驻组件（生产环境）
- 环境
- production
- 请求 ID
- req_7c19aa4460
- 记录时间
- 2026-09-16T14:22:35-04:00
2026-09-16 · 14:22:39
TASK_VIEWED
入驻组件（生产环境） · 对 Ottoline Marchetti-Fife 的验证
Success示例数据——虚构账本为此事件保存的所有字段
- 类别
- TASK
- 严重程度
- INFO
- 摘要
- 签名的 webhook 到达后，已通过 API 获取验证结果。
- IP 范围
- PUBLIC
- 位置
- 多伦多, 安大略省
- 设备
- Worker · 无浏览器客户端
- API 密钥
- 入驻组件（生产环境）
- 环境
- production
- 请求 ID
- req_7c19aa4471
- 记录时间
- 2026-09-16T14:22:39-04:00
2026-09-16 · 15:07:03
DOCUMENT_VIEWED
Desmond Quillfeather · Ottoline Marchetti-Fife 的结果
Success示例数据——虚构账本为此事件保存的所有字段
- 类别
- DOCUMENT
- 严重程度
- NOTICE
- 摘要
- 验证结果已在门户中打开。
- IP 范围
- PUBLIC
- 位置
- 汉密尔顿, 安大略省
- 设备
- 桌面设备 · Windows · 1920x1080 · America/Toronto
- API 密钥
- 无——是人，不是密钥
- 环境
- production
- 请求 ID
- req_b2d0e51f7a
- 记录时间
- 2026-09-16T15:07:03-04:00
2026-09-16 · 15:08:44
DOCUMENT_DOWNLOADED
Desmond Quillfeather · Ottoline Marchetti-Fife 的结果
Success示例数据——虚构账本为此事件保存的所有字段
- 类别
- DOCUMENT
- 严重程度
- WARNING
- 摘要
- 结果摘要已下载为 PDF。
- IP 范围
- PUBLIC
- 位置
- 汉密尔顿, 安大略省
- 设备
- 桌面设备 · Windows · 1920x1080 · America/Toronto
- API 密钥
- 无——是人，不是密钥
- 环境
- production
- 请求 ID
- req_b2d0e51f83
- 记录时间
- 2026-09-16T15:08:44-04:00
2026-09-15 · 11:52:18
SIGN_LINK_OPENED
Barnaby Thistlewood · 验证链接 3e77
Success示例数据——虚构账本为此事件保存的所有字段
- 类别
- SIGNING
- 严重程度
- INFO
- 摘要
- 申请人在手机上打开了其验证链接。
- IP 范围
- PUBLIC
- 位置
- 基奇纳, 安大略省
- 设备
- 移动设备 · iOS · 390x844 · 5 个触点
- API 密钥
- 无——是人，不是密钥
- 环境
- production
- 请求 ID
- req_3e7719b0c4
- 记录时间
- 2026-09-15T11:52:18-04:00
2026-09-15 · 11:55:02
BIOMETRIC_FAILED
验证引擎 · Barnaby Thistlewood 的验证
Failure示例数据——虚构账本为此事件保存的所有字段
- 类别
- SIGNING
- 严重程度
- WARNING
- 摘要
- 活体检测未通过。已为申请人提供再次尝试的机会。
- IP 范围
- PUBLIC
- 位置
- 基奇纳, 安大略省
- 设备
- 移动设备 · iOS · 390x844 · 5 个触点
- API 密钥
- 入驻组件（生产环境）
- 环境
- production
- 请求 ID
- req_3e7719b0d1
- 记录时间
- 2026-09-15T11:55:02-04:00
2026-09-15 · 16:30:55
FORENSIC_DETAIL_ACCESSED
Perpetua Nakashima · 事件 evt-0012
Success示例数据——虚构账本为此事件保存的所有字段
- 类别
- SECURITY
- 严重程度
- SECURITY
- 摘要
- 已在填写书面理由后查看 IP 和设备详情，该访问已记录在案。
- IP 范围
- PUBLIC
- 位置
- 渥太华, 安大略省
- 设备
- 桌面设备 · macOS · 1728x1117 · America/Toronto
- API 密钥
- 无——是人，不是密钥
- 环境
- production
- 请求 ID
- req_c4419d7e02
- 记录时间
- 2026-09-15T16:30:55-04:00
2026-09-15 · 09:14:31
SESSION_CREATED
Ines Valcourt-Brie · API 密钥：Billing sync (sandbox)
Success示例数据——虚构账本为此事件保存的所有字段
- 类别
- SECURITY
- 严重程度
- SECURITY
- 摘要
- 已创建一个 sandbox API 密钥。此后仅会再次显示其 14 位字符的前缀。
- IP 范围
- PUBLIC
- 位置
- 蒙特利尔, 魁北克
- 设备
- 桌面设备 · Linux · 2560x1440 · America/Toronto
- API 密钥
- 账单同步（sandbox）
- 环境
- sandbox
- 请求 ID
- req_5aa7c31048
- 记录时间
- 2026-09-15T09:14:31-04:00
2026-09-14 · 17:45:09
SESSION_REVOKED
Ines Valcourt-Brie · API 密钥：Legacy import (production)
Success示例数据——虚构账本为此事件保存的所有字段
- 类别
- SECURITY
- 严重程度
- SECURITY
- 摘要
- 一个未使用的生产密钥已被吊销。使用该密钥的调用现在一律被拒绝。
- IP 范围
- PUBLIC
- 位置
- 蒙特利尔, 魁北克
- 设备
- 桌面设备 · Linux · 2560x1440 · America/Toronto
- API 密钥
- 旧版导入（生产环境）
- 环境
- production
- 请求 ID
- req_5aa7c3112f
- 记录时间
- 2026-09-14T17:45:09-04:00
2026-09-14 · 10:22:47
SETTING_CHANGED
Clementine Ashgrove · 保留期
Success示例数据——虚构账本为此事件保存的所有字段
- 类别
- ACCOUNT
- 严重程度
- NOTICE
- 摘要
- 验证图像的保留期已从 90 天缩短至 30 天。
- IP 范围
- PUBLIC
- 位置
- 哈利法克斯, 新斯科舍
- 设备
- 桌面设备 · Windows · 1440x900 · America/Halifax
- API 密钥
- 无——是人，不是密钥
- 环境
- production
- 请求 ID
- req_8d2be40915
- 记录时间
- 2026-09-14T10:22:47-04:00
2026-09-14 · 10:31:12
AUDIT_EXPORTED
Clementine Ashgrove · 活动账本导出，8月1日至9月14日
Success示例数据——虚构账本为此事件保存的所有字段
- 类别
- SECURITY
- 严重程度
- WARNING
- 摘要
- 已为内部审查生成账本导出。导出操作本身也已记录在案。
- IP 范围
- PUBLIC
- 位置
- 哈利法克斯, 新斯科舍
- 设备
- 桌面设备 · Windows · 1440x900 · America/Halifax
- API 密钥
- 无——是人，不是密钥
- 环境
- production
- 请求 ID
- req_8d2be4093c
- 记录时间
- 2026-09-14T10:31:12-04:00
2026-09-14 · 03:00:04
RETENTION_PURGE
保留期清理 · 41 项验证已超出保留期
Success示例数据——虚构账本为此事件保存的所有字段
- 类别
- SYSTEM
- 严重程度
- NOTICE
- 摘要
- 已按计划清除存储的图像。描述这些图像的账本条目仍予保留。
- IP 范围
- LOOPBACK
- 位置
- 多伦多, 安大略省
- 设备
- 计划任务 · 无浏览器客户端
- API 密钥
- 无——是人，不是密钥
- 环境
- production
- 请求 ID
- req_f00d21c7b5
- 记录时间
- 2026-09-14T03:00:04-04:00
| 时间 | 操作者 | 操作 | 目标 | 结果 | 详情 |
|---|---|---|---|---|---|
| 2026-09-16 13:41:22 | Wren Halloway TENANT | LOGIN_2FA_CHALLENGED | 门户登录 | Success | |
示例数据——虚构账本为此事件保存的所有字段
| |||||
| 2026-09-16 13:41:58 | Wren Halloway TENANT | LOGIN_SUCCESS | 门户登录 | Success | |
示例数据——虚构账本为此事件保存的所有字段
| |||||
| 2026-09-16 14:02:10 | 入驻组件（生产环境） API_KEY | SESSION_CREATED | API 会话 4a81 | Success | |
示例数据——虚构账本为此事件保存的所有字段
| |||||
| 2026-09-16 14:02:11 | 入驻组件（生产环境） API_KEY | TASK_CREATED | 对 Ottoline Marchetti-Fife 的验证 | Success | |
示例数据——虚构账本为此事件保存的所有字段
| |||||
| 2026-09-16 14:19:47 | Ottoline Marchetti-Fife SIGNER | SIGN_LINK_OPENED | 验证链接 7c19 | Success | |
示例数据——虚构账本为此事件保存的所有字段
| |||||
| 2026-09-16 14:20:12 | Ottoline Marchetti-Fife SIGNER | EULA_ACCEPTED | 验证同意书 | Success | |
示例数据——虚构账本为此事件保存的所有字段
| |||||
| 2026-09-16 14:22:35 | 验证引擎 SYSTEM | BIOMETRIC_VERIFIED | 对 Ottoline Marchetti-Fife 的验证 | Success | |
示例数据——虚构账本为此事件保存的所有字段
| |||||
| 2026-09-16 14:22:39 | 入驻组件（生产环境） API_KEY | TASK_VIEWED | 对 Ottoline Marchetti-Fife 的验证 | Success | |
示例数据——虚构账本为此事件保存的所有字段
| |||||
| 2026-09-16 15:07:03 | Desmond Quillfeather TENANT | DOCUMENT_VIEWED | Ottoline Marchetti-Fife 的结果 | Success | |
示例数据——虚构账本为此事件保存的所有字段
| |||||
| 2026-09-16 15:08:44 | Desmond Quillfeather TENANT | DOCUMENT_DOWNLOADED | Ottoline Marchetti-Fife 的结果 | Success | |
示例数据——虚构账本为此事件保存的所有字段
| |||||
| 2026-09-15 11:52:18 | Barnaby Thistlewood SIGNER | SIGN_LINK_OPENED | 验证链接 3e77 | Success | |
示例数据——虚构账本为此事件保存的所有字段
| |||||
| 2026-09-15 11:55:02 | 验证引擎 SYSTEM | BIOMETRIC_FAILED | Barnaby Thistlewood 的验证 | Failure | |
示例数据——虚构账本为此事件保存的所有字段
| |||||
| 2026-09-15 16:30:55 | Perpetua Nakashima ADMIN | FORENSIC_DETAIL_ACCESSED | 事件 evt-0012 | Success | |
示例数据——虚构账本为此事件保存的所有字段
| |||||
| 2026-09-15 09:14:31 | Ines Valcourt-Brie TENANT | SESSION_CREATED | API 密钥：Billing sync (sandbox) | Success | |
示例数据——虚构账本为此事件保存的所有字段
| |||||
| 2026-09-14 17:45:09 | Ines Valcourt-Brie TENANT | SESSION_REVOKED | API 密钥：Legacy import (production) | Success | |
示例数据——虚构账本为此事件保存的所有字段
| |||||
| 2026-09-14 10:22:47 | Clementine Ashgrove TENANT | SETTING_CHANGED | 保留期 | Success | |
示例数据——虚构账本为此事件保存的所有字段
| |||||
| 2026-09-14 10:31:12 | Clementine Ashgrove TENANT | AUDIT_EXPORTED | 活动账本导出，8月1日至9月14日 | Success | |
示例数据——虚构账本为此事件保存的所有字段
| |||||
| 2026-09-14 03:00:04 | 保留期清理 SYSTEM | RETENTION_PURGE | 41 项验证已超出保留期 | Success | |
示例数据——虚构账本为此事件保存的所有字段
| |||||
常见问题