DAT Ruby लाइब्रेरी
GitHub RubyGemsइंस्टॉलेशन
त्वरित शुरुआत
यह पूरा प्रवाह CMS से सर्टिफिकेट प्राप्त करता है, JSON डेटा वाला DAT बनाता है और उसका सत्यापन करता है।
चरणबद्ध उपयोग
1. CMS से कनेक्ट करें
जारीकर्ता सेवा पूर्ण सर्टिफिकेट के लिए टोकन का उपयोग करती है। स्टार्टअप पर तुरंत सिंक्रनाइज़ करने से सर्टिफिकेट उपलब्ध होने से पहले जारीकरण रुकता है।
2. DAT जारी करें
इस उदाहरण में सार्वजनिक JSON को plain में और संरक्षित उपयोगकर्ता जानकारी को JSON के रूप में secure में रखा गया है।
3. DAT सत्यापित करें
parse समाप्ति और हस्ताक्षर की जाँच करता है, फिर secure को डिक्रिप्ट करता है। केवल सफल सत्यापन के बाद मिले payload का उपयोग करें।
प्रमुख फ़ंक्शन
| फ़ंक्शन | उद्देश्य |
|---|---|
sync_or_raise | सर्टिफिकेट को तुरंत सिंक्रनाइज़ करता है। |
issue(plain, secure) | DAT string बनाता है। |
parse(dat) | DAT सत्यापित करके DatPayload लौटाता है। |
last_error | अंतिम synchronization error लौटाता है। |
डेटा क्षेत्र
plain: हस्ताक्षरित, लेकिन एन्क्रिप्ट न किए गए बाइट्स।secure: एन्क्रिप्ट किए गए बाइट्स।payload: इस पर केवलparseके सफल होने के बाद ही भरोसा करें।
JSON के अलावा विकल्प
उदाहरण परिचित JSON का उपयोग करते हैं। तेज़ प्रसंस्करण के लिए बाइनरी डेटा JSON serialization और parsing को हटाकर डेटा का आकार भी घटा सकता है।
सरल मानों को text के रूप में रखें, या Protobuf और MessagePack जैसे बाइनरी प्रारूपों में संरचित डेटा को plain और secure में रखें।
binary strings दें और उन्हें plain_bytes तथा secure_bytes से प्राप्त करें।
केवल-सत्यापन सेवाएँ
DAT जारी न करने वाली सेवा verify-only विकल्प और verify-only टोकन का उपयोग करती है और केवल parse कॉल करती है।
शटडाउन और त्रुटियाँ
automatic synchronization सक्रिय होने पर background thread को समाप्त करने के लिए stop कॉल करें।
त्रुटि संदेशों के बजाय त्रुटि कोड और पुनःप्रयास वर्गीकरण का उपयोग करें।