Mobile-ID Quantum Safe
Liên hệ với chúng tôi

TRUSTED SIC API

Phê duyệt ký, kích hoạt và bằng chứng
trong một vòng đời rõ ràng.

Hợp đồng tham chiếu cho onboarding RP, yêu cầu ký, phê duyệt Passkey/WebAuthn, kích hoạt chữ ký, định tuyến đa CA, ký được bảo vệ, đóng gói ASiC và truy xuất bằng chứng.

Xem endpoint→Tải OpenAPI / Postman→

XÁC THỰC

Hai kênh được bảo vệ

  • RP-to-Trusted-SIC: mTLS + OAuth2 client credential hoặc private-key JWT
  • Phê duyệt người dùng: OIDC session + WebAuthn challenge/assertion
  • Scope: signing.request, signing.approve, signing.execute, evidence.read
  • Audience, tenant, RP và purpose là thông tin authorization bắt buộc

KIỂM SOÁT YÊU CẦU

Tác vụ chống replay

  • Idempotency-Key trên mọi yêu cầu làm thay đổi trạng thái
  • X-Correlation-Id xuyên suốt RP, SIC, CA và dịch vụ bằng chứng
  • Nonce và request timestamp cho approval và activation
  • Authorization ngắn hạn với liên kết document-hash

DANH MỤC ENDPOINT

Mục đích nghiệp vụ và đầu ra bằng chứng cho từng tác vụ.

POST

/v1/signing-requests

Tạo yêu cầu với document hash, signer, approval, signature và evidence policy.

Trả về: signingRequestId, status, expiry, evidenceCorrelationId
GET

/v1/signing-requests/{id}

Đọc trạng thái vòng đời, provider đã chọn, thông tin approval, chữ ký và liên kết bằng chứng.

Scope: signing.request.read
POST

/v1/signing-requests/{id}/approval-options

Tạo approval option kiểu WebAuthn/SPC được liên kết với request và relying party.

Trả về: challenge, rpId, allowCredentials, transactionSummary
POST

/v1/signing-requests/{id}/webauthn/verify

Xác thực assertion, origin, RP ID, challenge, user presence/verification và policy.

Trả về: approvalId, thông tin assurance, expiry
POST

/v1/signing-requests/{id}/activation

Phát hành SAD ngắn hạn hoặc activation authorization của Mobile-ID cho đúng hash và key.

Trả về: activationId, expiresAt, boundKeyId, policy
GET

/v1/signing-profiles

Liệt kê profile classical, hybrid-evidence và PQC có kiểm soát đã được phê duyệt.

Bao gồm: định dạng, thuật toán, bộ tham số, provider và ràng buộc verifier
GET

/v1/ca-providers

Khám phá tuyến CA/TSP đủ điều kiện, credential và trạng thái vận hành cho RP.

Bao gồm: connector profile, jurisdiction, credential eligibility
POST

/v1/signatures

Thực thi thao tác ký đã được authorization qua tuyến HSM/QSCD/SAM đã chọn.

Trả về: signatureId, bằng chứng thao tác, liên kết artifact
POST

/v1/asic-packages

Đóng gói tài liệu, manifest, chữ ký tách rời, timestamp và validation material.

Trả về: packageId, content manifest, trạng thái validation
POST

/v1/verifications

Xác minh chữ ký, đường dẫn certificate, timestamp, revocation và tuân thủ policy.

Trả về: kết quả path độc lập và định danh báo cáo đã ký
GET

/v1/evidence-packages/{id}

Truy xuất bằng chứng authentication, approval, activation, signing và validation đã liên kết.

Bằng chứng được kiểm soát truy cập và quản trị theo retention
POST

/v1/evidence-packages/{id}/renewals

Yêu cầu gia hạn timestamp/bằng chứng trước khi preservation profile hiện tại suy giảm.

Trả về: renewal job và evidence profile mục tiêu

VÍ DỤ

Phê duyệt và kích hoạt là hai bước kiểm toán độc lập.

Xác minh WebAuthn

POST /v1/signing-requests/srq_01J.../webauthn/verify
{
  "credential": {"id":"masked-credential-id","response":{...}},
  "clientDataPolicy": {
    "expectedOrigin":"https://sign.example.vn",
    "expectedRpId":"sign.example.vn"
  },
  "transactionDigest":"sha256-..."
}

Kết quả kích hoạt

{
  "activationId":"sad_01J...",
  "signingRequestId":"srq_01J...",
  "boundKeyId":"key_account_01J...",
  "boundDocumentHashes":["sha256-..."],
  "expiresAt":"2026-07-19T10:15:00Z",
  "replayPolicy":"single_use"
}

MÔ HÌNH LỖI

Problem details theo phong cách RFC 9457

  • approval_required — không có phê duyệt hợp lệ của signer
  • activation_expired — SAD/authorization đã hết hạn
  • profile_not_eligible — signer/provider không thể dùng profile được yêu cầu
  • provider_unavailable — tuyến đã chọn không sẵn sàng và failover chưa được phê duyệt
  • verification_partial — một đường xác thực độc lập không thể hoàn tất

QUẢN LÝ PHIÊN BẢN

Vòng đời tích hợp có thể dự đoán

  • Major version trong URI kèm thay đổi minor có tính cộng thêm
  • Header deprecation và sunset
  • Changelog cho schema và ví dụ
  • Hồ sơ năng lực và interoperability theo từng bản phát hành
  • Không suy luận về tình trạng sẵn sàng của endpoint từ trang tham chiếu này