DAT C / C++ Library

Installation

Until it is officially merged into vcpkg, you will need to manually install and integrate the project using this repository.
https://github.com/microsoft/vcpkg/pull/52088
version: 4.7.0

فوری آغاز

یہ مکمل flow CMS سے certificates لیتا، JSON data والا DAT بناتا اور verify کرتا ہے۔

مرحلہ وار

1. CMS سے connect کریں

Issuing service full certificates کا token استعمال کرتی ہے۔ startup پر فوراً synchronization سے certificates ملنے سے پہلے issuance نہیں ہوتا۔

2. DAT issue کریں

یہ مثال public JSON کو plain اور protected user information کو JSON کی صورت secure میں رکھتی ہے۔

3. DAT verify کریں

parse expiration اور signature check کرکے secure decrypt کرتا ہے۔ صرف successful verification کے بعد ملنے والا payload استعمال کریں۔

اہم functions

Function	مقصد
`dat_cms_manager_sync`	Certificates فوراً synchronize کرتا ہے۔
`dat_cms_manager_issue`	DAT string allocate کرکے دیتا ہے۔
`dat_cms_manager_parse`	Verified payload allocate کرکے دیتا ہے۔
`dat_cms_manager_last_error`	آخری synchronization error دیتا ہے۔

Data regions

plain: signed مگر encrypted نہ ہونے والے bytes۔
secure: encrypted bytes۔
payload: صرف parse کامیاب ہونے کے بعد اعتماد کریں۔

JSON کے علاوہ options

مثالوں میں معروف JSON ہے۔ تیز processing کے لیے binary data، JSON serialization اور parsing سے بچ کر data size کم کر سکتا ہے۔

Simple values text کی صورت یا structured data کو Protobuf یا MessagePack جیسے binary formats میں plain اور secure میں رکھیں۔

موجودہ C issuance API، NUL-terminated strings لیتا ہے۔ arbitrary bytes کو Base64Url یا Hex میں encode کرکے payload lengths سے result پڑھیں۔

Verify-only services

DAT issue نہ کرنے والی service verify-only option اور verify-only token استعمال کرتی اور صرف parse call کرتی ہے۔

Shutdown اور errors

متعلقہ cleanup functions سے dat، payload اور cms release کریں۔

Error messages کے بجائے error codes اور retry classifications استعمال کریں۔