Lumaktaw sa pangunahing nilalaman
ShieldID

Activity Ledger

Bawat tingin. Bawat click. Nakatala.

Ang Activity Ledger ay isang append-only na talaan ng lahat ng nangyayari sa paligid ng isang verification: sino ang nag-sign in, sino ang nagbukas ng link, ano ang ipinasya ng engine, at sino ang nag-export ng ano. Maaaring magdagdag ng mga entry, ngunit hindi kailanman mae-edit o made-delete ang mga ito. Hindi ninyo magagawa, at hindi rin namin.

Subukan ang sample ledgerAPI reference

Ang ledger na inilalarawan dito ay ang governance record na pinapatakbo na ngayon ang Trust Ledger at inilalabas na sa mga ShieldID API account. Anumang hindi pa naitatala para sa mga identity verification ay minarkahan bilang Malapit na sa pahinang ito.

Bakit ito mahalaga

Ang verification na walang talaan ay opinyon lamang.

Ang paggamit ng identity service ay may sariling panganib: may kailangang managot kung sino ang nakakita sa ID ng aplikante at kung ano ang ginawa rito. Ang ledger ang paraan ninyo para sumagot.

Para sa inyo

Patunayan kung ano ang nangyari, nang may pagkakasunod-sunod, kasama ang kinalabasan. Kapag kinuwestiyon ang isang desisyon makalipas ang ilang buwan, ang ledger ang ebidensya, at mas tumatagal ito kaysa sa mga ID image.

Para sa inyong compliance lead

Sagutin ang isang privacy request o audit gamit ang filtered na export sa halip na isang linggong email. Ang bawat export ay isa ring entry.

Para sa inyong mga aplikante

Bawat pagtingin at pag-download ng isang nakaimbak na dokumento ay nag-iiwan ng entry, kaya may maibibigay na sagot ang negosyo sa tanong na "sino ang nakakita ng file ko?" Malapit nang dumating ang per-image na mga event para sa mga ID photo at ang self-service na view para sa mga aplikante.

Ano ang itinatala nito

Ang buong event vocabulary.

Isa sa mga pangalang ito ang ginagamit ng bawat entry, kaya laging pareho ang ibig sabihin ng isang filter. Ipinapakita ang mga pangalan ayon sa paglabas ng mga ito sa ledger.

Sign-in at access

Bawat daan papasok sa account, at bawat sulyap sa likod ng tabing.

LOGIN_2FA_CHALLENGED
Umabot ang isang sign-in sa two-factor na hakbang.
LOGIN_SUCCESS
Natapos ang isang sign-in.
FORENSIC_DETAIL_ACCESSED
May nagbubukas ng ebidensya ng network at device sa likod ng isang entry. Kailangan nito ng nakasulat na dahilan, at ang request mismo ay nire-record.

Mga verification request

Ang paglalakbay ng aplikante, mula sa link hanggang sa consent.

SIGN_LINK_OPENED
Binuksan ng aplikante ang kanyang verification link.
EULA_ACCEPTED
Tinanggap ng aplikante ang mga tuntunin bago magpatuloy.
TASK_CREATED / TASK_SENT
May ginawa at ipinadalang verification request, ng isang tao o ng isang API key.
TASK_VIEWED / TASK_VOIDED
Kinukuha o kinakansela ang isang request sa pamamagitan ng API.

Mga record at export

Anumang lumalabas sa account ay nag-iiwan ng bakas.

DOCUMENT_VIEWED
May nakaimbak na dokumentong binuksan sa portal.
DOCUMENT_DOWNLOADED
May dokumentong dina-download, sa portal o sa pamamagitan ng API.
DOCUMENT_EMAILED
May dokumentong ine-email sa isang ttatanggap.
AUDIT_EXPORTED
May audit trail na kinukuha sa pamamagitan ng API. Ang pagbasa ng talaan ay nire-record din mismo.

Account at API

Mga setting at credential, kasama ang actor.

SETTING_CHANGED
May binagong setting ng account sa pamamagitan ng API.
SESSION_CREATED / SESSION_REVOKED
May binuksan o ni-revoke na API session.
ACCOUNT_MAILING_ADDRESS_UPDATED / BILLING_ADDRESS_UPDATED
May nagbago sa mga detalye ng account.

Request timeline (bawat request, kasabay ng ledger)

Ang bawat request ay may sarili ring timeline. Isa itong working record, hindi ang append-only na ledger, kaya hiwalay namin itong pinangalanan.

BIOMETRIC_VERIFIED / BIOMETRIC_FAILED
Iniuulat ng verification engine na pumasa o nabigo ang identity check, kasama ang check na nabigo.
RETENTION_PURGE / RETENTION_PURGE_FAILED
Dine-delete ng retention sweep ang mga nakaimbak na dokumento ng isang request sa pagtatapos ng window nito, o hindi ito nagawa.
GDPR_ERASURE
Ni-redact ang personal na impormasyon alinsunod sa isang right-to-erasure request.

Paparating

Malapit na

Ang mga event na kumukumpleto sa loop partikular para sa identity verification. Inilista namin ang mga ito upang mapanagot ninyo kami.

ID_IMAGE_VIEWED / ID_IMAGE_DOWNLOADED
Sa bawat pagbukas o pag-download ng isang ID image o selfie, at kung sino ang gumawa nito.
DECISION_RECORDED
Ang pagtanggap o pagtanggi na nire-record ng inyong team sa isang verification, kasama ang dahilan.
API_KEY_CREATED / API_KEY_REVOKED
Mga key lifecycle event bilang mga ledger entry. Sa ngayon, nakaimbak ang mga ito kasama ng key, hindi bilang mga entry.
VERIFICATION_VERIFIED / VERIFICATION_FAILED
Mga resulta ng verification bilang append-only na ledger entry para sa mga ShieldID API account. Sa ngayon, isinusulat ang mga ito sa request timeline.
IMAGE_PURGED
Isang resibo para sa bawat awtomatikong pagpurga ng ID image.
Applicant view
Isang self-service na pahina kung saan makikita ng taong na-verify kung sino ang nag-access sa kanyang verification.
CSV export
Isang filtered na export para sa mga auditor, sa spreadsheet. Umiiral na ngayon ang JSON export.

Anatomiya ng isang entry

Labing-apat na field, sa bawat pagkakataon. Pagkatapos, ang ebidensya, kapag hiniling.

Sinasabi ng isang entry kung sino, ano, sa ano, at ano ang resulta, sa payak na salita at sa machine-readable na anyo. Ang ebidensya ng network at device ay nasa tabi nito, sa likod ng isang naka-log na request.

Ang entry

Actor type
Tao, signer, system, admin o API key. Ang mga aksyon ng isang API key ay may sariling id ng key, kaya hindi kailanman nagkakalito ang isang script at isang tao.
Actor label
Ang pangalan o email kung ano ito noong panahong iyon, hindi isang live lookup na nagbabago kapag umalis ang mga tao.
Aksyon
Ang pangalan ng event, mula sa nakapirming vocabulary sa itaas.
Kategorya at tindi ng severity
Auth, document, signing, task, account, security o system; mula info hanggang critical.
Target
Kung saan isinagawa ang aksyon: isang verification, isang dokumento, isang tao, o isang setting.
Buod
Isang pangungusap na madaling maintindihan, isinulat sa mismong oras ng pangyayari.
Outcome
Success, failure o denied. Ang tinanggihang aksyon ay itinatala nang kasing-linaw ng matagumpay.
Metadata
Estrukturadong detalye: label ng API key, environment (sandbox o production), request id, at iba pa.
Timestamp
Oras ng server, nakaayos ayon sa pagkakasunod, hindi kailanman mae-edit.

Ang ebidensya, sa likod ng isang naka-log na request

IP address at scope
Public, carrier-grade NAT, private, loopback o hindi alam, para malaman ng reviewer kung gaano ito dapat pagkatiwalaan.
Network operator
Reverse DNS, registrant, ASN at kung ang address ay pag-aari ng hosting provider.
Lokasyon
Bansa, rehiyon, lungsod at postal code, kasama ang accuracy radius at kung luma na ang data.
Device
Maikling listahan ng mga signal tulad ng time zone, laki ng screen, platform at mga wika, na pinaikli sa isang matatag na SHA-256 fingerprint. Walang hilaw na browser dump.
Iniulat na address
Ang mismong iniulat ng browser, na minarkahang hindi beripikado.

Ang ebidensya ay dinaragdagan ng detalye pagkatapos maipadala ang response, hindi kailanman sa critical path ng applicant, at minamarkahang unenriched hanggang dumating ito.

Tamper evidence

Hindi namin ito tinatawag na blockchain, dahil hindi ito iyon. Isa itong table na hindi pinapayagan ng database na i-edit ninuman.

Simpleng salita tungkol sa kung ano ang nagpoprotekta sa record, para masuri ng iyong auditor ang aming mga pahayag laban sa aming ikinikilos.

  • Append-only, ipinapatupad ng database

    Ang isang trigger sa governance table ay nagtataas ng error sa anumang update o delete. Sakop nito ang application code, mga administrator at kami mismo.

  • Isang makitid at naka-log na eksepsyon

    Kapag na-delete ang isang account, hinihiwalay ang mga entry nito mula sa account sa halip na burahin, at kung magkapareho lamang ang bawat ibang column, byte para sa byte. Walang pinuputol.

  • Ang mga write ay dumadaan sa isang guarded function

    Ang mga entry ay isinusulat ng isang database function na may tinukoy na mga privilege, matapos ang isang tunay na insidente kung saan tahimik na nilulunok ng row-level security ang mga write. Ang pag-aayos na iyon ang dahilan kung bakit umiiral ang function.

  • Ang pagbasa ng ebidensya ay isang event

    Hindi mababasa ang detalye ng network at device kung walang nakasulat na dahilan na hindi bababa sa labindalawang character, na nire-record sa pangalan ng bumasa bilang FORENSIC_DETAIL_ACCESSED.

  • Hindi ginagalaw ng pagpurga ng mga image ang talaan

    Pinupurga ang mga ID image sa loob ng maikling timer. Ang mga ledger entry ay hiwalay na talaan na walang link sa mga image, kaya ang pagbura ng isang image ay hindi kailanman nag-aalis ng entry na naglalarawan kung ano ang nangyari rito.

Search at filter

I-search ito na parang database, dahil database ito.

Bawat filter ay vina-validate sa server-side at naka-scope sa inyong account. Ang mga listahan ng filter ay nagpapakita lamang ng mga value na talagang umiiral, kaya hindi kayo kailanman maghahanap ng wala.

Actor
Isang tao, o isang API key ayon sa id nito. Ihiwalay ang lahat ng ginawa ng isang integration.
Target
Isang verification, dokumento o tao. Lahat ng nangyari sa file ng aplikanteng ito.
Aksyon
Anumang pangalan ng event mula sa vocabulary.
Category, severity, outcome
Mga security event lang, mga pagkabigo lang, mga tinanggihang aksyon lang.
Saklaw ng petsa
Mula at hanggang, tumpak hanggang sa segundo.
Free text
Sa mga summary, actor label, target label at aksyon. Sadyang hindi kailanman sa raw metadata.

JSON ang export sa ngayon: ang buong trail para sa isang verification sa pamamagitan ng API, na may limitasyong limandaang row, at bawat pagkuha ay nire-record bilang AUDIT_EXPORTED. Malapit nang dumating ang CSV export para sa mga customer.

Subukan ito

Isang sample na ledger, kathang-isip at maaaring i-search.

I-filter, palawakin ang isang row, buksan ang ebidensya. Gawa-gawa lamang para sa demo ang mga pangalan at event sa ibaba; totoo ang field set at ang behavior.

Activity Ledger

Sample data

18 entry ang ipinapakita.

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

    LOGIN_2FA_CHALLENGED

    Wren Halloway · Portal sign-in

    Success

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

    LOGIN_SUCCESS

    Wren Halloway · Portal sign-in

    Success

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

    SESSION_CREATED

    Onboarding widget (production) · API session 4a81

    Success

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

    TASK_CREATED

    Onboarding widget (production) · Verification para kay Ottoline Marchetti-Fife

    Success

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

    SIGN_LINK_OPENED

    Ottoline Marchetti-Fife · Verification link 7c19

    Success

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

    EULA_ACCEPTED

    Ottoline Marchetti-Fife · Pahintulot sa verification

    Success

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

    BIOMETRIC_VERIFIED

    Verification engine · Verification para kay Ottoline Marchetti-Fife

    Success

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

    TASK_VIEWED

    Onboarding widget (production) · Verification para kay Ottoline Marchetti-Fife

    Success

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

    DOCUMENT_VIEWED

    Desmond Quillfeather · Resulta para kay Ottoline Marchetti-Fife

    Success

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

    DOCUMENT_DOWNLOADED

    Desmond Quillfeather · Resulta para kay Ottoline Marchetti-Fife

    Success

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

    SIGN_LINK_OPENED

    Barnaby Thistlewood · Verification link 3e77

    Success

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

    BIOMETRIC_FAILED

    Verification engine · Verification para kay Barnaby Thistlewood

    Failure

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

    FORENSIC_DETAIL_ACCESSED

    Perpetua Nakashima · Event evt-0012

    Success

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

    SESSION_CREATED

    Ines Valcourt-Brie · API key: Billing sync (sandbox)

    Success

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

    SESSION_REVOKED

    Ines Valcourt-Brie · API key: Legacy import (production)

    Success

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

    SETTING_CHANGED

    Clementine Ashgrove · Retention window

    Success

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

    AUDIT_EXPORTED

    Clementine Ashgrove · Activity Ledger export, 1 Agosto hanggang 14 Setyembre

    Success

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

    RETENTION_PURGE

    Retention sweep · 41 verification na lampas na sa kanilang retention window

    Success

Mga Tanong

Tuwirang sagot tungkol sa record.

Tingnan ito gamit ang sarili ninyong data

Magpatakbo ng isang sandbox verification. Pagkatapos, basahin kung ano ang isinulat nito.

Ang pinakamabilis na paraan para maunawaan ang ledger ay ang gumawa ng entry dito. Hindi kailanman sinisingil ang mga sandbox session.

Magsimula nang libre sa sandboxMag-book ng demo