跳至主要內容
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 或者正式環境）、請求編號等等。
時間戳記
伺服器時間，按次序排列，永不可編輯。

證據，附於有記錄的請求之後

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

    Onboarding 小工具（正式環境） · API 工作階段 4a81

    Success

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

    TASK_CREATED

    Onboarding 小工具（正式環境） · 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

    Onboarding 小工具（正式環境） · 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 密鑰：帳單同步 (sandbox)

    Success

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

    SESSION_REVOKED

    Ines Valcourt-Brie · API 密鑰：舊有匯入 (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 免費開始預約示範