DAT Go Library
GitHub pkg.go.devInstallation
فوری آغاز
یہ مکمل 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 | مقصد |
|---|---|
Sync() | Certificates فوراً synchronize کرتا ہے۔ |
Issue(plain, secure) | DAT string اور error دیتا ہے۔ |
Parse(dat) | Verified Payload اور error دیتا ہے۔ |
LastError() | آخری 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 میں رکھیں۔
Go strings bytes رکھ سکتی ہیں۔ byte slice کو string کے طور پر دے کر result واپس []byte میں بدلیں۔
Verify-only services
DAT issue نہ کرنے والی service verify-only option اور verify-only token استعمال کرتی اور صرف parse call کرتی ہے۔
Shutdown اور errors
automatic synchronization فعال ہو تو cleanup کے لیے defer cms.Close() استعمال کریں۔
Error messages کے بجائے error codes اور retry classifications استعمال کریں۔