跳至主要內容
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
依據刪除權（right to 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 指紋。不會有原始的瀏覽器資料傾印。
自行回報的位址
瀏覽器本身回報的內容，並標示為未經驗證。

證據會在回應送出後才補充豐富，絕不佔用申請人的關鍵路徑，在補充完成前會標示為尚未補充。

防竄改證明

我們不稱它為區塊鏈，因為它並不是。它只是一個資料庫拒絕任何人編輯的資料表。

以淺白的文字說明是什麼在保護紀錄，讓您的稽核人員能對照我們的說法與實際行為。

  • 僅可附加，由資料庫強制執行

    治理資料表上的觸發器會在任何更新或刪除時引發錯誤。應用程式碼、管理員，以及我們自己都受此限制。

  • 一項範圍狹窄且有記錄的例外

    帳號被刪除時，其條目會與帳號分離而非被清除，且僅限其他所有欄位逐位元組完全相同的情況。不會有任何內容被截斷。

  • 寫入須經受保護的函式

    條目由具備明確權限的資料庫函式寫入，這是因為曾發生列級安全性（row-level security）悄悄吞掉寫入的真實事件。這個函式的存在，正是修正的結果。

  • 讀取證據本身就是一個事件

    若未提供至少十二個字元的書面理由，就無法讀取網路與裝置詳細資料，且此讀取會以讀取者的名義記錄為 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 免費開始預約示範