@gerege-systems/eid-mongolia-sdk 0.36.0 → 0.37.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +36 -26
- package/dist/{browser-CCP--VGv.d.ts → browser-CxTMnKOc.d.ts} +2 -3
- package/dist/{browser-w1Ca6FdZ.d.cts → browser-DdxKtnvo.d.cts} +2 -3
- package/dist/browser.d.cts +1 -1
- package/dist/browser.d.ts +1 -1
- package/dist/index.cjs +812 -836
- package/dist/index.d.cts +130 -115
- package/dist/index.d.ts +130 -115
- package/dist/index.js +386 -409
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -922,45 +922,55 @@ try {
|
|
|
922
922
|
ч тогтооно). `session_id`, `doc_id`, `on_behalf_of_*` нь CA-ийн бүртгэлээс — локал тайланд байхгүй.
|
|
923
923
|
- Хөтчийн bundle (минифай): ~253 KB, gzip ~137 KB (`npm run size:validate`, хязгаар 300 KB).
|
|
924
924
|
|
|
925
|
-
## 3h. «Миний QR» — биечлэн шалгах (`eid.qr`, 0.
|
|
925
|
+
## 3h. «Миний QR» — биечлэн шалгах (`eid.qr`, 0.37.0)
|
|
926
926
|
|
|
927
|
-
Иргэн eID апп дээрээ «Миний QR»-ийг харуулна (`EIDMN-QR1:<token>`, 120 с, нэг удаагийн). RP (касс, POS, апп) скан
|
|
928
|
-
|
|
929
|
-
|
|
930
|
-
|
|
931
|
-
|
|
932
|
-
({surname, givenName}), `phone` (E.164), `birth_date` (YYYY-MM-DD, мэдрэмтгий), `civil_id` (мэдрэмтгий). Бүртгэлд
|
|
933
|
-
байхгүй утга → `unavailable`, алдаа биш.
|
|
927
|
+
Иргэн eID апп дээрээ «Миний QR»-ийг харуулна (`EIDMN-QR1:<token>`, 120 с, нэг удаагийн). RP (касс, POS, апп) скан хийнэ →
|
|
928
|
+
иргэн утсан дээрээ «Та <RP>-д «Миний мэдээлэл» хэсгийн бүх мэдээллийг хуваалцах гэж байна» гэсэн өгүүлбэрийг PIN2-оор
|
|
929
|
+
(QUALIFIED гарын үсгийн түлхүүр) зөвшөөрнө → RP иргэний **өөрийн** гарын үсэгтэй (PS256 JWS, `x5c` = [SIGN гэрчилгээ,
|
|
930
|
+
олгогч CA]) «Миний мэдээлэл»-ийг (апп дээр хадгалсан түлхүүр/утга яг тэр хэвээр, нүүрний JPEG зураг) авна. RP-д зөвхөн
|
|
931
|
+
`QR_PRESENT` эрх. CA өгөгдлийг DB-д хадгалахгүй — RP-ийн анхны амжилттай уншилтаар устгана.
|
|
934
932
|
|
|
935
933
|
```ts
|
|
936
934
|
import { QrError, QrTokenInvalidError, SessionFailedError } from "@gerege-systems/eid-mongolia-sdk";
|
|
937
935
|
|
|
938
|
-
const s = await eid.qr.start({ qr: scanned,
|
|
939
|
-
|
|
940
|
-
// s-ийг (JSON) хадгалж болно — result-д nonce, хүссэн аттрибутыг тулгана.
|
|
936
|
+
const s = await eid.qr.start({ qr: scanned, nonce: orderId }); // nonce өгөөгүй бол base64url(16 байт); VC алга
|
|
937
|
+
// s ({ sessionId, nonce })-ийг JSON-оор хадгалж болно — result/check-д nonce, session-ийг тулгана.
|
|
941
938
|
try {
|
|
942
|
-
const p = await eid.qr.result(s);
|
|
943
|
-
|
|
939
|
+
const p = await eid.qr.result(s); // эсвэл polling UI: await eid.qr.check(s) → { complete: false } | { complete: true, result }
|
|
940
|
+
p.data; // { birth_date: "1990-01-01", given_name: "Бат", … } — payload-ийн дарааллаар, түлхүүр verbatim
|
|
941
|
+
p.source; // "dan" | "passport" | "citizenid" | "gsign" | "guardian" | "unknown" | …
|
|
942
|
+
p.photo; // Uint8Array (JPEG) | undefined
|
|
943
|
+
p.signer; // { certificate, etsi: "PNOMN-…", givenName, surname, commonName } — гэрчилгээнээс
|
|
944
|
+
p.signedAt; // Date (iat)
|
|
945
|
+
p.sha256; // hex SHA-256(signingInput) = CA-ийн аудитын qrsha (маргаанд тулгах)
|
|
944
946
|
} catch (e) {
|
|
945
947
|
if (e instanceof QrTokenInvalidError) {/* start: 404 — шинэ QR гаргуул */}
|
|
946
948
|
else if (e instanceof SessionFailedError) {/* USER_REFUSED, TIMEOUT … */}
|
|
947
|
-
else if (e instanceof QrError && e.code === "
|
|
948
|
-
else if (e instanceof QrError && e.code === "
|
|
949
|
+
else if (e instanceof QrError && e.code === "QR_PRESENTATION_GONE") {/* аль хэдийн уншигдсан / хугацаа дууссан — шинэ QR */}
|
|
950
|
+
else if (e instanceof QrError && e.code === "QR_REVOCATION_UNKNOWN") {/* OCSP хариугүй — түр, дахин verify */}
|
|
951
|
+
else if (e instanceof QrError) {/* QR_* шалгалт унасан — ИТГЭХГҮЙ */}
|
|
949
952
|
else throw e;
|
|
950
953
|
}
|
|
951
954
|
```
|
|
952
955
|
|
|
953
|
-
|
|
954
|
-
(
|
|
955
|
-
|
|
956
|
-
|
|
957
|
-
|
|
958
|
-
|
|
959
|
-
|
|
960
|
-
|
|
961
|
-
|
|
962
|
-
|
|
963
|
-
|
|
956
|
+
Шалгалт (`verifyQrPresentation(jws, expect, trust)`; Go / .NET SDK-тэй ижил, `test/fixtures/myqr_vectors.json`):
|
|
957
|
+
хэлбэр (≤ 512 KiB, 3 сегмент) → header яг `alg` PS256 / `typ` `eidmn-myqr+jwt` / `x5c` 2 гэрчилгээ (`QR_HEADER_INVALID`)
|
|
958
|
+
→ гинж: x5c[1] ∪ `trust.intermediatesPem` → `trust.trustAnchorsPem` (анхдагч `NATIONAL_ROOT_CA_PEM`), цаг ± 60 с, CA биш,
|
|
959
|
+
KeyUsage contentCommitment, QUALIFIED (qcStatements), issuer allowlist (анхдагч `CITIZEN_ISSUING_CA_SKI`), RSA ≥ 2048
|
|
960
|
+
(`QR_CHAIN_INVALID`; x5c[1] хэзээ ч anchor биш) → цуцлалт `trust.revocation` (алга бол SDK-ийн OCSP; `revocationMode`
|
|
961
|
+
анхдагч hard-fail: `QR_CERT_REVOKED` / `QR_REVOCATION_UNKNOWN`) → PS256 (salt 32) хүлээн авсан байтаар
|
|
962
|
+
(`QR_SIGNATURE_INVALID`) → claim: `iss` = `https://ca.eidmongolia.mn`, `sub` = гэрчилгээний serialNumber, `statement` нь
|
|
963
|
+
`rp_name`-ээс угсарсантай яг тэнцүү (`QR_CLAIMS_INVALID`), `aud` = RP UUID (том/жижиг үсэг ялгахгүй,
|
|
964
|
+
`QR_AUDIENCE_MISMATCH`), `sid` (`QR_SESSION_MISMATCH`), `nonce` (`QR_NONCE_MISMATCH`), `0 < exp − iat ≤ 300`,
|
|
965
|
+
`iat ≤ одоо+60` (`QR_NOT_YET_VALID`), `одоо < exp+60` (`QR_EXPIRED`) → өгөгдөл: `source` `^[a-z0-9_-]{1,32}$`, `fields`
|
|
966
|
+
≤ 128 түлхүүр (1–64 тэмдэгт, удирдлагын тэмдэгтгүй), утга string ≤ 2048 байт, `photo` хатуу base64 JPEG ≤ 150 KiB,
|
|
967
|
+
өөр гишүүнгүй (`QR_DATA_INVALID`). `trust` = `ClientConfig.trust` (`allowUntrusted`, `checkKeyUsage: false` энд
|
|
968
|
+
үйлчлэхгүй).
|
|
969
|
+
|
|
970
|
+
`result`-ийн `maxWaitMs` дуусахад иргэн хариулаагүй бол `QrError` `QR_PENDING` (дахин дуудаж болно). CA-ийн код
|
|
971
|
+
(`ApiError` / `ForbiddenError`-ийн `code`): 400 `REQUEST_INVALID` (nonce 16–128 байт ASCII 0x21–0x7E), 403
|
|
972
|
+
`PERMISSION_DENIED` / `RP_REQUIRED`, 404 `QR_TOKEN_INVALID`, 409 `NO_SIGNING_CERTIFICATE`, 429 `RATE_LIMITED`; `GET /session`-ийн
|
|
973
|
+
410 → `QrError` `QR_PRESENTATION_GONE` (presentation нэг л удаа өгөгдөнө). `qr.issuer` тохиргоо — тест орчинд л.
|
|
964
974
|
|
|
965
975
|
## 4. QR ба ижил төхөөрөмж — device link v3
|
|
966
976
|
|
|
@@ -205,8 +205,8 @@ interface SessionResult {
|
|
|
205
205
|
/** USB токены гэрчилгээ олголтын session-ий `tokenCertificate` блок (`token.issueCertificate`); бусад урсгалд null. */
|
|
206
206
|
tokenCertificate?: TokenCertSessionBlock | null;
|
|
207
207
|
/**
|
|
208
|
-
* «Миний QR» session-ий
|
|
209
|
-
*
|
|
208
|
+
* «Миний QR» session-ий presentation: иргэний PS256 гарын үсэгтэй `jws` (x5c) — ШАЛГААГҮЙ; итгэхдээ `qr.result` /
|
|
209
|
+
* `verifyQrPresentation`-ийн үр дүнг л хэрэглэ. Бусад урсгалд null.
|
|
210
210
|
*/
|
|
211
211
|
presentation?: SessionPresentation | null;
|
|
212
212
|
/** Серверийн хариуны түүхий JSON (`parseSessionResult`-ийн оролт) — SDK задлаагүй талбарт. */
|
|
@@ -215,7 +215,6 @@ interface SessionResult {
|
|
|
215
215
|
/** QR session-ий `presentation` блок. */
|
|
216
216
|
interface SessionPresentation {
|
|
217
217
|
jws: string;
|
|
218
|
-
claims?: Record<string, unknown>;
|
|
219
218
|
}
|
|
220
219
|
/**
|
|
221
220
|
* Session-ий `person` блок (CA `dto.PersonBlock`). Нэршил core.gerege.mn-тэй нэг мөр — гурван нэр ӨӨР ойлголт:
|
|
@@ -205,8 +205,8 @@ interface SessionResult {
|
|
|
205
205
|
/** USB токены гэрчилгээ олголтын session-ий `tokenCertificate` блок (`token.issueCertificate`); бусад урсгалд null. */
|
|
206
206
|
tokenCertificate?: TokenCertSessionBlock | null;
|
|
207
207
|
/**
|
|
208
|
-
* «Миний QR» session-ий
|
|
209
|
-
*
|
|
208
|
+
* «Миний QR» session-ий presentation: иргэний PS256 гарын үсэгтэй `jws` (x5c) — ШАЛГААГҮЙ; итгэхдээ `qr.result` /
|
|
209
|
+
* `verifyQrPresentation`-ийн үр дүнг л хэрэглэ. Бусад урсгалд null.
|
|
210
210
|
*/
|
|
211
211
|
presentation?: SessionPresentation | null;
|
|
212
212
|
/** Серверийн хариуны түүхий JSON (`parseSessionResult`-ийн оролт) — SDK задлаагүй талбарт. */
|
|
@@ -215,7 +215,6 @@ interface SessionResult {
|
|
|
215
215
|
/** QR session-ий `presentation` блок. */
|
|
216
216
|
interface SessionPresentation {
|
|
217
217
|
jws: string;
|
|
218
|
-
claims?: Record<string, unknown>;
|
|
219
218
|
}
|
|
220
219
|
/**
|
|
221
220
|
* Session-ий `person` блок (CA `dto.PersonBlock`). Нэршил core.gerege.mn-тэй нэг мөр — гурван нэр ӨӨР ойлголт:
|
package/dist/browser.d.cts
CHANGED
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
export { D as DeviceLinkSession, d as NavigatorLike, l as isMobileUserAgent } from './browser-
|
|
1
|
+
export { D as DeviceLinkSession, d as NavigatorLike, l as isMobileUserAgent } from './browser-DdxKtnvo.cjs';
|
|
2
2
|
export { D as DeviceLinkError, E as EidError } from './errors-CgJcEjrZ.cjs';
|
package/dist/browser.d.ts
CHANGED
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
export { D as DeviceLinkSession, d as NavigatorLike, l as isMobileUserAgent } from './browser-
|
|
1
|
+
export { D as DeviceLinkSession, d as NavigatorLike, l as isMobileUserAgent } from './browser-CxTMnKOc.js';
|
|
2
2
|
export { D as DeviceLinkError, E as EidError } from './errors-CgJcEjrZ.js';
|