DAT CMS
DAT CMS হলো ঐচ্ছিক সার্ভিস যা সার্টিফিকেট তৈরি, সংরক্ষণ ও client managers-এ বিতরণ করে। এই নথি clients ও server-এর synchronization contract বর্ণনা করে। installation ও operations-এর জন্য DAT CMS service guide দেখুন।
ভূমিকা-নির্দিষ্ট endpoints
| ভূমিকা | পাথ | ব্যবহারকারী |
|---|---|---|
| পূর্ণ সার্টিফিকেট সংগ্রহ | GET /v1/certs?version=<n> | DAT ইস্যুকারী সার্ভিস |
| Verify-only সার্টিফিকেট সংগ্রহ | GET /v1/certs/verify-only?version=<n> | শুধু যাচাই ও decrypt করা সার্ভিস |
| সার্টিফিকেট নিবন্ধন | POST /v1/cert/{signature}/{crypto}/{propagation}/{issuance}/{ttl} | Operators বা certificate-generation jobs |
পূর্ণ ও verify-only retrieval আলাদা token roles দিয়ে সুরক্ষিত হতে পারে। verify-only সার্ভিস যেন পূর্ণ সার্টিফিকেট না চায়, তাই client manager-এর verifyOnly option সেট করুন।
Version cursor
ক্লায়েন্ট server-এ শেষ প্রয়োগ করা version পাঠায়। server state অপরিবর্তিত থাকলে সার্টিফিকেট আবার পাঠাতে হয় না। নতুন state থাকলে response-এর প্রথম লাইনে version এবং পরের লাইনে সার্টিফিকেট থাকে।
সফল response-এ শুধু version, কোনো সার্টিফিকেট না থাকলে ক্লায়েন্ট বিদ্যমান সার্টিফিকেট ও issuer রাখে। server version ক্লায়েন্টের চেয়ে কম হলে state rollback না করে error ধরা হয়।
সার্টিফিকেট import নিয়ম
- এক response-এ একই
cidএকাধিকবার থাকলে পুরো response প্রত্যাখ্যান করুন। - নতুন response-এ ইতিমধ্যে থাকা
cidএলে বিদ্যমান সার্টিফিকেট রাখুন। - এক operation-এ state প্রয়োগের আগে প্রতিটি সার্টিফিকেট parse ও validate করুন।
- সফলভাবে import করা সার্টিফিকেটের partial set রাখবেন না।
- বর্তমান সময়ে ইস্যুযোগ্য সার্টিফিকেট থেকে উপযুক্ত issuer বাছুন।
প্রাথমিক ও manual synchronization
client manager তৈরির সময় প্রথম synchronization সাধারণত best-effort। ব্যর্থ হলেও manager তৈরি হয় এবং নির্দিষ্ট last error রাখে। startup ব্যর্থ করতে হলে library-এর immediate synchronization API call করুন যাতে error caller-এর কাছে যায়।
automatic synchronization ব্যবহার না করা পরিবেশ interval বন্ধ করে প্রয়োজনে সরাসরি synchronize করতে পারে। এটি চালু থাকলে application shutdown-এর সময় manager close বা stop করুন।
Network ও errors
production environment-এর জন্য connection ও overall request timeouts সেট করুন। Redirect policies runtime অনুযায়ী বদলায়, তাই library documentation দেখুন। বর্তমান clients non-2xx CMS responses-কে HTTP status অনুযায়ী DAT_CMS_* errors হিসেবে classify করে এবং server-এর JSON response-এর detailed error code রাখে না।
সাময়িক storage failure-এর সময় server সর্বশেষ সফল certificate snapshot দিতে পারে। সফল snapshot না থাকলে DAT_STORE_UNAVAILABLE ফেরত দেয়।
Service documentation
deployment, databases, access tokens ও runtime configuration-এর জন্য DAT CMS service guide দেখুন।