সেটিংস › API অ্যাক্সেস থেকে আপনি ব্যক্তিগত অ্যাক্সেস টোকেন তৈরি করতে পারেন, যাতে কোনো স্ক্রিপ্ট বা MCP ক্লায়েন্ট আপনার পরিচয়ে Dvina ব্যবহার করতে পারে। অ্যাডমিনরাও সেখান থেকে ওয়েবহুক যোগ করে Livespace-এর ইভেন্ট নিজেদের সিস্টেমে পাঠাতে পারেন।
API অ্যাক্সেস Enterprise প্ল্যানে অন্তর্ভুক্ত। প্রত্যেক সদস্য নিজের টোকেন তৈরি করতে পারেন; শুধু মালিক ও অ্যাডমিনরা ওয়েবহুক দেখতে পান।
টোকেন তৈরি করুন
- সেটিংস খুলে API অ্যাক্সেস বেছে নিন।
- ব্যক্তিগত অ্যাক্সেস টোকেন-এর অধীনে টোকেন তৈরি করুন বেছে নিন।
- একটি নাম লিখুন, যাতে পরে বুঝতে পারেন এটি কোথায় ব্যবহার হচ্ছে।
- অ্যাক্সেস বেছে নিন: শুধু পড়া অথবা পড়া ও লেখা।
- কখন মেয়াদ শেষ হবে তা বেছে নিন: 30 দিন পরে, 90 দিন পরে, 365 দিন পরে অথবা কখনো মেয়াদ শেষ হবে না।
- টোকেন তৈরি করুন বেছে নিন।
- আপনার টোকেন কপি করুন-এর অধীনে টোকেনটি কপি করে নিরাপদ কোথাও রাখুন। টোকেনটি শুধু এই একবারই দেখানো হয়।
টোকেনটি যে Livespace-এ তৈরি করেছেন, সেখানে আপনার বর্তমান ভূমিকা অনুযায়ী আপনার পরিচয়ে কাজ করে। শুধু পড়া টোকেন তথ্য পড়তে পারে, কিন্তু কিছু যোগ বা পরিবর্তন করতে পারে না।
MCP ক্লায়েন্টের সঙ্গে টোকেন ব্যবহার করতে OAuth-এর বদলে API কী দিয়ে সংযোগ করুন দেখুন।
টোকেনের তথ্য দেখুন, বদলান বা বাতিল করুন
আপনার টোকেনগুলো ব্যক্তিগত অ্যাক্সেস টোকেন-এর অধীনে তাদের অ্যাক্সেসসহ তালিকায় থাকে। কোনো টোকেন বেছে নিলে দেখতে পাবেন সেটি যা দিয়ে শুরু, তার অ্যাক্সেস, কখন শেষ ব্যবহার হয়েছে এবং কখন মেয়াদ শেষ হবে।
- টোকেন বদলাতে, বদলান… বেছে নিন, তারপর নিশ্চিত করতে বদলান বেছে নিন। আগের টোকেনের জায়গায় নতুন টোকেন তৈরি হয় এবং পুরোনোটি সঙ্গে সঙ্গে কাজ করা বন্ধ করে। আপনার টোকেন কপি করুন-এর অধীনে নতুন টোকেনটি কপি করুন।
- টোকেন বন্ধ করতে, বাতিল করুন… বেছে নিন, তারপর নিশ্চিত করতে বাতিল করুন বেছে নিন। এটি ব্যবহার করে এমন সবকিছু সঙ্গে সঙ্গে কাজ করা বন্ধ করে।
টোকেন তৈরি, বদলানো ও বাতিল করার তথ্য অডিট লগে নথিভুক্ত হয়।
ওয়েবহুক যোগ করুন
ওয়েবহুক আপনার বেছে নেওয়া ঠিকানায় Livespace-এর ইভেন্ট পাঠায়। এগুলো অডিট লগে থাকা একই রেকর্ড।
- সেটিংস › API অ্যাক্সেস-এ, ওয়েবহুক-এর অধীনে ওয়েবহুক যোগ করুন বেছে নিন।
- একটি নাম ও URL লিখুন। সর্বসাধারণের জন্য অ্যাক্সেসযোগ্য HTTPS URL ব্যবহার করুন।
- ইভেন্ট-এর অধীনে, সব ইভেন্ট পেতে ঘরটি খালি রাখুন, অথবা কাজ ও ক্ষেত্রের তালিকা দিন, যেমন
member.addedবাsharing.*। - যোগ করুন বেছে নিন।
- সাইনিং সিক্রেট কপি করুন-এর অধীনে সিক্রেটটি কপি করুন। এটি শুধু এই একবারই দেখানো হয়।
Dvina যদি বলে Dvina থেকে এই ঠিকানায় পৌঁছানো যাচ্ছে না, তাহলে সর্বসাধারণের জন্য অ্যাক্সেসযোগ্য HTTPS URL ব্যবহার করুন।
প্রতিটি অনুরোধের স্বাক্ষর যাচাই করুন
Dvina একসঙ্গে একাধিক ইভেন্ট JSON হিসেবে পাঠায় এবং প্রতিটি অনুরোধে স্বাক্ষর যুক্ত করে। অনুরোধটি Dvina থেকে এসেছে কি না যাচাই করতে সাইনিং সিক্রেট ব্যবহার করুন:
- প্রতিটি অনুরোধে
t=<timestamp>,v1=<signature>-এর মতো একটিX-Dvina-Signatureহেডার থাকে। - টাইমস্ট্যাম্প, একটি ডট এবং অনুরোধের বডি মিলিয়ে আপনার সাইনিং সিক্রেট দিয়ে তৈরি HMAC-SHA256-এর হেক্স রূপই হলো স্বাক্ষর।
- নিজে এটি গণনা করে মিলিয়ে দেখুন। স্বাক্ষর না মিললে বা টাইমস্ট্যাম্প খুব পুরোনো হলে অনুরোধটি প্রত্যাখ্যান করুন।
ওয়েবহুক দেখুন বা পরিবর্তন করুন
ওয়েবহুক-এর অধীনে আপনার ওয়েবহুকগুলো তাদের অবস্থা সহ তালিকায় দেখানো হয়: চালু, বিরত বা ব্যর্থ হচ্ছে। বিস্তারিত দেখতে একটি বেছে নিন।
- পরিবর্তন করতে, এর নাম, URL বা ইভেন্ট সম্পাদনা করুন, তারপর সংরক্ষণ করুন বেছে নিন।
- বিরতি দিতে, ইভেন্ট পাঠান বন্ধ করুন। আবার পাঠানো শুরু করতে এটি আবার চালু করুন।
- কেমন কাজ করছে দেখতে, এর অবস্থা এবং কতগুলো ইভেন্ট পাঠানো হয়েছে তা দেখুন। ব্যর্থ হতে থাকা ওয়েবহুকে এর সর্বশেষ ত্রুটি দেখানো হয়। Dvina চেষ্টা চালিয়ে যায় এবং অডিট লগে ব্যর্থতা নথিভুক্ত করে।
- এর সিক্রেট পরিবর্তন করতে, নতুন সাইনিং সিক্রেট… বেছে নিন, তারপর নিশ্চিত করুন। অনুরোধগুলো সঙ্গে সঙ্গেই নতুন সিক্রেট দিয়ে স্বাক্ষর করা হয়, তাই প্রাপককে অবিলম্বে আপডেট করুন।
- সরিয়ে ফেলতে, মুছে ফেলুন… বেছে নিন, তারপর নিশ্চিত করতে মুছে ফেলুন বেছে নিন। এতে আর কিছু পাঠানো হবে না।