跳到主要内容
ShieldID

活动台账

每一次查看，每一次点击，都有记录。

活动台账是对一次验证相关的所有事情的仅追加记录：谁登录了、谁打开了链接、引擎做出了什么决定、谁导出了什么。条目只能添加，绝不能编辑或删除。你不能，我们也不能。

试用示例账本API 参考

此处描述的账本是目前支撑 Trust Ledger 运行的治理记录，并正在向 ShieldID API 账户推出。身份验证中尚未记录的任何内容均会标注为 即将推出 在本页面上。

为什么重要

没有记录的验证，只是一种意见。

使用身份服务本身会带来风险：必须有人能说明谁看过申请人的身份证件，以及对它做了什么。台账就是你给出答案的方式。

对你而言

按顺序证明发生了什么以及结果如何。数月后当某项决定受到质疑时，台账就是证据，而且它比身份证件图像留存得更久。

对你的合规负责人而言

用带筛选的导出来应对隐私请求或审计，而不是花上一周来回发邮件。每次导出本身也是一条条目。

对你的申请人而言

对已存储文档的每次查看和下载都会留下一条条目，因此“谁看过我的档案？”这个问题，企业可以给出答案。针对身份证件照片的逐图像事件和申请人自助查看功能即将推出。

记录的内容

完整的事件词汇表。

每个条目都使用其中一个名称，因此同一个筛选条件的含义始终一致。名称按其在账本中的显示形式列出。

登录和访问

进入账户的每一种方式，以及每一次幕后查看。

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

  • 2026-09-16 · 13:41:58

    LOGIN_SUCCESS

    Wren Halloway · 门户登录

    Success

  • 2026-09-16 · 14:02:10

    SESSION_CREATED

    入驻组件（生产环境） · API 会话 4a81

    Success

  • 2026-09-16 · 14:02:11

    TASK_CREATED

    入驻组件（生产环境） · 对 Ottoline Marchetti-Fife 的验证

    Success

  • 2026-09-16 · 14:19:47

    SIGN_LINK_OPENED

    Ottoline Marchetti-Fife · 验证链接 7c19

    Success

  • 2026-09-16 · 14:20:12

    EULA_ACCEPTED

    Ottoline Marchetti-Fife · 验证同意书

    Success

  • 2026-09-16 · 14:22:35

    BIOMETRIC_VERIFIED

    验证引擎 · 对 Ottoline Marchetti-Fife 的验证

    Success

  • 2026-09-16 · 14:22:39

    TASK_VIEWED

    入驻组件（生产环境） · 对 Ottoline Marchetti-Fife 的验证

    Success

  • 2026-09-16 · 15:07:03

    DOCUMENT_VIEWED

    Desmond Quillfeather · Ottoline Marchetti-Fife 的结果

    Success

  • 2026-09-16 · 15:08:44

    DOCUMENT_DOWNLOADED

    Desmond Quillfeather · Ottoline Marchetti-Fife 的结果

    Success

  • 2026-09-15 · 11:52:18

    SIGN_LINK_OPENED

    Barnaby Thistlewood · 验证链接 3e77

    Success

  • 2026-09-15 · 11:55:02

    BIOMETRIC_FAILED

    验证引擎 · Barnaby Thistlewood 的验证

    Failure

  • 2026-09-15 · 16:30:55

    FORENSIC_DETAIL_ACCESSED

    Perpetua Nakashima · 事件 evt-0012

    Success

  • 2026-09-15 · 09:14:31

    SESSION_CREATED

    Ines Valcourt-Brie · API 密钥：Billing sync (sandbox)

    Success

  • 2026-09-14 · 17:45:09

    SESSION_REVOKED

    Ines Valcourt-Brie · API 密钥：Legacy import (production)

    Success

  • 2026-09-14 · 10:22:47

    SETTING_CHANGED

    Clementine Ashgrove · 保留期

    Success

  • 2026-09-14 · 10:31:12

    AUDIT_EXPORTED

    Clementine Ashgrove · 活动账本导出，8月1日至9月14日

    Success

  • 2026-09-14 · 03:00:04

    RETENTION_PURGE

    保留期清理 · 41 项验证已超出保留期

    Success

常见问题

关于记录的直接解答。

用你自己的数据体验

运行一次 sandbox 验证，然后看看它写入了什么。

了解台账最快的方式，就是在其中创建一条条目。Sandbox 会话永不计费。

在 sandbox 中免费开始预约演示