Analytics API Token হলো Credential, Identifier নয়
API token ডেটায় প্রবেশাধিকার দেয়। একে lifecycle-সহ secret হিসেবে পরিচালনা করুন: একবার দেখান, verifier রাখুন, ক্ষমতা সীমিত করুন এবং সহজে revoke করুন।
API token কোনো user বা site-এর label নয়; এটি একটি credential। বৈধ token যার কাছে আছে, সে তার মালিকের পরিচয়ে কাজ করতে পারে। একে identifier মনে করলে token logs, URL, support screenshot এবং এমন দীর্ঘমেয়াদি configuration-এ চলে যায়, যেগুলো কেউ নিশ্চিতভাবে revoke করতে পারে না।
IETF-এর জানুয়ারি ২০২৫-এ প্রকাশিত OAuth 2.0 Security Best Current Practice OAuth deployment-এর threat model ও নিরাপত্তা নির্দেশনা আপডেট করেছে। ব্যক্তিগত API token OAuth access token নাও হতে পারে, কিন্তু মূল engineering principle একই: possession-based credential-কে transit-এ সুরক্ষিত রাখতে হবে, নির্দিষ্ট service-এ সীমিত করতে হবে এবং caller-এর প্রয়োজনমতো ক্ষমতা দিতে হবে।
Secret একবারই দেখান
Cryptographically secure random source এবং পর্যাপ্ত entropy দিয়ে token তৈরি করুন, যাতে বাস্তবে অনুমান করা না যায়। সম্পূর্ণ token শুধু তৈরির সময় ফেরত দিন; পরে শনাক্ত করার জন্য non-secret prefix এবং খোঁজার জন্য one-way verifier রাখুন। Database কপি হয়ে গেলে verifier, পুনর্ব্যবহারযোগ্য plaintext credential-এর চেয়ে নিরাপদ। সাধারণ hash-কে password hash ভাববেন না: API token-এ উচ্চ randomness দরকার, আর মানুষের password-এর জন্য ইচ্ছাকৃতভাবে ধীর password-hashing function দরকার।
Product UI ও API response-এ স্পষ্ট করে দিন যে token একবারই দেখা যাবে। ব্যবহারকারী creation screen ছেড়ে গেলে মূল secret আবার দেখানোর বদলে revoke করে নতুন token দেওয়ার পথ রাখুন। Query parameter, page URL, analytics event, error report বা screenshot-এ token কখনও রাখবেন না। Authorization header-এর তুলনায় URL browser history, referrer, proxy log ও support ticket-এ সহজে থেকে যায়।
Credential সঠিক স্থানে পাঠান
HTTP API-তে TLS-এর ওপর Authorization header দিয়ে token নিন। RFC 6750 bearer token-কে এমন credential বলে যা যে কেউ হাতে পেলে ব্যবহার করতে পারে; storage বা transit-এ তা ফাঁস হলে অপব্যবহারের সুযোগ তৈরি হয়। URI query parameter-এ bearer credential না রাখারও পরামর্শ দেয়, কারণ URL প্রায়ই log হয়। কোনো protocol অন্য transport বাধ্যতামূলক না করলে এবং threat model নথিভুক্ত না থাকলে query string বা request body-তে token প্রত্যাখ্যান করুন।
অনুরোধের operation চালানোর আগে server-এ token যাচাই করুন। Owner ও permission বিশ্বস্ত storage থেকে বের করুন; request-এ পাঠানো user বা site owner-কে কর্তৃত্বের উৎস হিসেবে নেবেন না। Application log, trace এবং exception message থেকে secret দূরে রাখুন। Operational correlation দরকার হলে token-এর non-secret ID বা prefix log করুন, credential নয়।
Scope সীমিত করুন, মেয়াদ দিন এবং revoke করুন
Token কেবল প্রয়োজনীয় ন্যূনতম permission দেবে। Product সমর্থন করলে user-কে নির্দিষ্ট site, read-only access বা নির্বাচিত operation-এ token সীমাবদ্ধ করতে দিন। একটি report নেওয়ার জন্য automation script-কে পুরো account-এর write access নীরবে দেবেন না। OAuth security best practice token-এর privilege ও audience সীমিত করার কথা বলে; API নিজস্ব opaque format ব্যবহার করলেও এটি উপকারী design reference।
Expiry ও revocation-কে মূল control হিসেবে দিন। কম lifetime হলে ফাঁস হওয়া credential কম সময় ব্যবহারযোগ্য থাকে; revocation incident এবং team বা integration পরিবর্তনে কাজে লাগে। Rotation-এ overlap দরকার হলে সময়সীমা বেঁধে দিন এবং কোন token সক্রিয় তা দেখান। Revocation API boundary-তে কার্যকর হতে হবে; dashboard থেকে লুকানোই যথেষ্ট নয়।
Monoid-এর programmatic API-তে user-created mnd_live_… token opaque, plaintext-এ একবার ফেরত আসে এবং optional expiry ও soft revocation-সহ SHA-256 hash হিসেবে সংরক্ষিত হয়। এতে database পড়া হলেও মূল value প্রকাশ পায় না, কিন্তু ফাঁস হওয়া সক্রিয় token নিরীহ হয় না। Source control, CI output, browser bundle ও shared terminal history-তে token রাখবেন না; exposure সন্দেহ হলে নতুন token দিন এবং পুরোনোটি revoke করুন।
Lifecycle পরীক্ষা-যোগ্য করুন
সম্পূর্ণ ধাপ পরীক্ষা করুন: তৈরি করা, প্রত্যাশিত permission-এ ব্যবহার, invalid বা expired token প্রত্যাখ্যান, revoke করা, তারপর একই token আর কাজ করছে না নিশ্চিত করা। Token যেন অন্য account বা site-এ প্রবেশ না দেয় এবং প্রতিটি endpoint যেন একই authentication ও authorization rule প্রয়োগ করে—তা যাচাই করুন। Operational check-এ log-এ credential redact হওয়া এবং API response-এ stored token material কখনও ফেরত না আসাও নিশ্চিত করুন।
Secret-management lifecycle-এ creation, access control, rotation, audit এবং revocation রয়েছে—শুধু নিরাপদ storage নয়। System token-এর owner শনাক্ত করতে, তার কাজ সীমিত করতে, secret log না করে exposure ধরতে এবং দ্রুত বন্ধ করতে পারলেই API token সুরক্ষিত থাকে।
Comments
Loading comments…