본문으로 건너뛰기
ShieldID

활동 원장

모든 조회. 모든 클릭. 기록으로 남습니다.

Activity Ledger는 인증과 관련해 일어나는 모든 일을 기록하는 추가 전용 기록입니다. 누가 로그인했는지, 누가 링크를 열었는지, 엔진이 무엇을 판단했는지, 누가 무엇을 내보냈는지가 담겨 있습니다. 항목은 추가할 수만 있고 수정하거나 삭제할 수 없습니다. 고객님도, 저희도 마찬가지입니다.

샘플 ledger 체험하기API 레퍼런스

여기에 설명된 ledger는 현재 Trust Ledger를 운영하는 거버넌스 기록이며, ShieldID API 계정에 순차적으로 적용되고 있습니다. 신원 확인에 대해 아직 기록되지 않는 항목에는 다음 표시가 붙습니다: 출시 예정 이 페이지에 있습니다.

중요한 이유

기록 없는 인증은 의견에 불과합니다.

신원 확인 서비스를 사용하면 그 자체로 새로운 위험이 생깁니다. 누가 신청자의 신분증을 보았고 그것으로 무엇을 했는지 누군가는 답할 수 있어야 하기 때문입니다. 원장이 바로 그 답이 됩니다.

고객님을 위해

무슨 일이 어떤 순서로 일어났고 결과가 어땠는지 증명하세요. 몇 달 뒤 어떤 결정에 의문이 제기되더라도 원장이 증거가 되며, 원장은 신분증 이미지보다 오래 남습니다.

컴플라이언스 책임자를 위해

개인정보 요청이나 감사에 일주일간 이메일을 주고받는 대신 필터링된 내보내기로 답하세요. 모든 내보내기 자체도 하나의 항목으로 남습니다.

신청자를 위해

저장된 문서를 보거나 다운로드할 때마다 항목이 남으므로, "누가 내 파일을 보았나요?"라는 질문에 기업이 답할 수 있습니다. 신분증 사진의 이미지별 이벤트와 신청자용 셀프서비스 화면은 곧 제공될 예정입니다.

기록되는 내용

이벤트 용어 전체

모든 항목은 아래 이름 중 하나를 사용하므로 필터는 항상 같은 의미를 갖습니다. 이름은 ledger에 표시되는 그대로 보여드립니다.

로그인 및 접근

계정에 들어오는 모든 경로와, 내부를 들여다보는 모든 열람을 기록합니다.

LOGIN_2FA_CHALLENGED
로그인이 2단계 인증 단계에 도달했습니다.
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 내보내기를 사용할 수 있습니다.

항목의 구조

항상 14개 필드를 기록하고, 증거는 요청 시에 제공합니다.

항목에는 누가, 무엇을, 무엇에 대해, 어떤 결과로 했는지가 쉬운 말과 기계가 읽을 수 있는 형식으로 담겨 있습니다. 네트워크 및 기기 증거는 그 옆에 있으며, 기록되는 요청을 거쳐야 열람할 수 있습니다.

항목

행위자 유형
사람, 서명자, 시스템, 관리자 또는 API 키입니다. API 키의 작업에는 키 자체의 ID가 담기므로 스크립트와 사람이 혼동되지 않습니다.
행위자 라벨
당시의 이름 또는 이메일입니다. 사람이 떠나면 달라지는 실시간 조회 값이 아닙니다.
작업
위의 고정된 어휘 목록에서 가져온 이벤트 이름입니다.
카테고리 및 심각도
auth, document, signing, task, account, security 또는 system 중 하나이며, 심각도는 info부터 critical까지입니다.
대상
조치가 취해진 대상입니다. 검증, 문서, 사람, 설정 중 하나입니다.
요약
그 시점에 작성된 사람이 읽을 수 있는 한 문장입니다.
결과
성공, 실패 또는 거부. 거부된 작업도 성공한 작업과 똑같이 분명하게 기록됩니다.
메타데이터
API 키 레이블, 환경(sandbox 또는 production), 요청 ID 등의 구조화된 세부 정보입니다.
타임스탬프
서버 시간 기준으로 순서대로 기록되며 수정할 수 없습니다.

기록된 요청 뒤에 있는 증거

IP 주소 및 범위
공인, 통신사급 NAT, 사설, 루프백 또는 알 수 없음으로 구분되어, 검토자가 얼마나 신뢰할지 판단할 수 있습니다.
네트워크 운영자
역방향 DNS, 등록자, ASN, 그리고 해당 주소가 호스팅 제공업체 소속인지 여부입니다.
위치
국가, 지역, 도시, 우편번호와 함께 정확도 반경 및 데이터가 오래되었는지 여부를 기록합니다.
기기
시간대, 화면 크기, 플랫폼, 언어 같은 몇 가지 신호를 모아 안정적인 SHA-256 지문으로 축약합니다. 브라우저 원본 정보를 그대로 저장하지 않습니다.
보고된 주소
브라우저가 직접 보고한 내용이며, 검증되지 않았다고 표시됩니다.

증거는 응답이 전송된 뒤에 보강되며, 신청자의 핵심 처리 경로에서는 절대 수행되지 않습니다. 보강되기 전까지는 미보강 상태로 표시됩니다.

변조 증거

블록체인이라고 부르지 않습니다. 블록체인이 아니기 때문입니다. 데이터베이스가 누구의 수정도 허용하지 않는 테이블입니다.

기록을 무엇이 보호하는지 쉬운 말로 설명해 드려요. 감사인이 저희의 주장을 실제 동작과 대조해 확인할 수 있도록요.

  • 추가만 가능하며, 데이터베이스가 이를 강제합니다

    거버넌스 테이블의 트리거가 업데이트나 삭제가 발생하면 오류를 일으킵니다. 애플리케이션 코드, 관리자, 그리고 우리 자신도 이 제약을 받습니다.

  • 기록이 남는 좁은 예외 하나

    계정이 삭제되면 해당 항목은 지워지지 않고 계정에서 분리됩니다. 이는 나머지 모든 열이 바이트 단위로 완전히 동일한 경우에만 이루어집니다. 잘려 나가는 내용은 없습니다.

  • 쓰기는 보호된 함수를 거칩니다

    항목은 정해진 권한을 가진 데이터베이스 함수가 기록합니다. 행 수준 보안이 쓰기 작업을 조용히 삼켜 버린 실제 사고를 겪은 뒤에 도입했으며, 이 함수가 존재하는 이유가 바로 그 수정입니다.

  • 증거를 읽는 것도 하나의 이벤트입니다

    네트워크 및 기기 상세 정보는 12자 이상의 서면 사유 없이는 열람할 수 없으며, 열람한 사람의 이름으로 FORENSIC_DETAIL_ACCESSED로 기록됩니다.

  • 이미지를 삭제해도 기록은 그대로입니다

    신분증 이미지는 짧은 주기로 삭제됩니다. 원장 항목은 이미지와 연결되지 않은 별도의 기록이므로, 이미지를 삭제해도 그 이미지에 일어난 일을 설명하는 항목은 사라지지 않습니다.

검색 및 필터

데이터베이스처럼 검색하세요. 실제로 데이터베이스니까요.

모든 필터는 서버 측에서 검증되며 고객님의 계정 범위로 제한됩니다. 필터 목록에는 실제로 존재하는 값만 표시되므로 아무것도 없는 값을 검색하는 일이 없습니다.

행위자
사람 또는 ID로 지정한 API 키입니다. 하나의 연동이 수행한 모든 작업을 따로 확인할 수 있습니다.
대상
인증, 문서 또는 사람입니다. 이 신청자의 파일에 일어난 모든 일을 볼 수 있습니다.
작업
어휘 목록에 있는 모든 이벤트 이름입니다.
카테고리, 심각도, 결과
보안 이벤트만, 실패만, 거부된 작업만 볼 수 있습니다.
날짜 범위
시작과 종료를 초 단위까지 지정합니다.
자유 텍스트
요약, 행위자 라벨, 대상 라벨, 작업을 대상으로 검색합니다. 원본 메타데이터는 의도적으로 검색하지 않습니다.

현재 내보내기는 JSON으로 제공됩니다. API를 통해 인증 하나의 전체 기록을 최대 500행까지 내보낼 수 있으며, 조회할 때마다 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에서 무료로 시작하기데모 예약하기