DAT C / C++ लाइब्रेरी

इंस्टॉलेशन

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

त्वरित शुरुआत

यह पूरा प्रवाह CMS से सर्टिफिकेट प्राप्त करता है, JSON डेटा वाला DAT बनाता है और उसका सत्यापन करता है।

चरणबद्ध उपयोग

1. CMS से कनेक्ट करें

जारीकर्ता सेवा पूर्ण सर्टिफिकेट के लिए टोकन का उपयोग करती है। स्टार्टअप पर तुरंत सिंक्रनाइज़ करने से सर्टिफिकेट उपलब्ध होने से पहले जारीकरण रुकता है।

2. DAT जारी करें

इस उदाहरण में सार्वजनिक JSON को plain में और संरक्षित उपयोगकर्ता जानकारी को JSON के रूप में secure में रखा गया है।

3. DAT सत्यापित करें

parse समाप्ति और हस्ताक्षर की जाँच करता है, फिर secure को डिक्रिप्ट करता है। केवल सफल सत्यापन के बाद मिले payload का उपयोग करें।

प्रमुख फ़ंक्शन

फ़ंक्शन	उद्देश्य
`dat_cms_manager_sync`	सर्टिफिकेट को तुरंत सिंक्रनाइज़ करता है।
`dat_cms_manager_issue`	DAT string allocate करके लौटाता है।
`dat_cms_manager_parse`	सत्यापित payload allocate करके लौटाता है।
`dat_cms_manager_last_error`	अंतिम synchronization error लौटाता है।

डेटा क्षेत्र

plain: हस्ताक्षरित, लेकिन एन्क्रिप्ट न किए गए बाइट्स।
secure: एन्क्रिप्ट किए गए बाइट्स।
payload: इस पर केवल parse के सफल होने के बाद ही भरोसा करें।

JSON के अलावा विकल्प

उदाहरण परिचित JSON का उपयोग करते हैं। तेज़ प्रसंस्करण के लिए बाइनरी डेटा JSON serialization और parsing को हटाकर डेटा का आकार भी घटा सकता है।

सरल मानों को text के रूप में रखें, या Protobuf और MessagePack जैसे बाइनरी प्रारूपों में संरचित डेटा को plain और secure में रखें।

वर्तमान C issuance API NUL-terminated strings स्वीकार करता है। arbitrary bytes को Base64Url या Hex में encode करें और payload lengths का उपयोग करके परिणाम पढ़ें।

केवल-सत्यापन सेवाएँ

DAT जारी न करने वाली सेवा verify-only विकल्प और verify-only टोकन का उपयोग करती है और केवल parse कॉल करती है।

शटडाउन और त्रुटियाँ

dat, payload और cms को उनके संबंधित cleanup functions से release करें।

त्रुटि संदेशों के बजाय त्रुटि कोड और पुनःप्रयास वर्गीकरण का उपयोग करें।