API key তৈরি ও সুরক্ষিত রাখুন
সর্বনিম্ন প্রয়োজনীয় scope-সহ live বা sandbox credential বানান, প্রয়োজনে IP সীমা দিন এবং নিরাপদে key ঘুরিয়ে বা বাতিল করুন।
- Context বেছে নিনPersonal বা organisation workspace নির্বাচন করুন।
- Permission দিনKey-এর নাম দিন এবং শুধু প্রয়োজনীয় scope নিন।
- Source সীমিত করুনঐচ্ছিকভাবে caller IP address বা network দিন।
- একবার সংরক্ষণ করুনদেখানো secret সুরক্ষিত secret manager-এ রাখুন।
- Access বজায় রাখুনReplacement-এর জন্য key rotate করুন; পুরোনো credential revoke করুন।
Scope ও role
API Keys-এ account read, AI inference ও training, AI hosting job, model transformation job, blockchain service এবং support ticket permission-সহ সমর্থিত scope-এর বিবরণ থাকে। Organisation-এ owner ও administrator key পরিচালনা করেন; member দেখতে পারেন, পরিচালনা করতে পারেন না। Credential কোন context-এ থাকবে তা বেছে নিন, কারণ দৃশ্যমানতা ও কর্তৃত্ব context অনুযায়ী সীমিত।
- API Keys খোলার আগে লক্ষ্য organisation নির্বাচন করুন।
- Scope-এর বিবরণ পড়ে প্রয়োজনীয় operation-ই নিন।
- পরিচালনা করা না গেলে owner বা administrator-কে বলুন।
Live key তৈরি করুন
সাধারণ key-তে ২–১২০ অক্ষরের নাম, অন্তত একটি তালিকাভুক্ত scope এবং ঐচ্ছিক IP allowlist লাগে। দেখানো সীমার মধ্যে প্রতি লাইনে বৈধ IP address বা CIDR network দিন। তালিকা খালি থাকলে যেকোনো source IP অনুমোদিত। তৈরির পর সম্পূর্ণ plaintext একবার দেখানো হয়; শুধু hash রাখা হয়, তাই পরে ফেরত পাওয়া যায় না।
- Application বা environment অনুযায়ী নাম দিন।
- সর্বনিম্ন scope ও প্রয়োজনীয় স্থিতিশীল source address বাছুন।
- দেখানো value সরাসরি অনুমোদিত secret storage-এ রাখুন।
স্যান্ডবক্স ইনফারেন্স কী
Dashboard-এ শুধু AI inference-এ সীমিত sandbox key তৈরি করা যায়, সঙ্গে সেখানে দেখানো মাসিক request allowance থাকে। প্রতি account বা organisation context-এ একটিই সক্রিয় sandbox key অনুমোদিত। আগে থেকে থাকলে সেটি ব্যবহার করুন অথবা নতুনটি নেওয়ার আগে revoke করুন। Sandbox ও live credential আলাদা রাখুন; sandbox allowance-কে production service-এর নিশ্চয়তা ভাববেন না।
- এই context-এ সক্রিয় sandbox key আছে কি না দেখুন।
- Inference test-এর জন্য একটি তৈরি করে আলাদা সংরক্ষণ করুন।
- Allowance দেখুন এবং আর দরকার না হলে revoke করুন।
Secret সুরক্ষিত রাখুন
তৈরি বা rotate করার সময় দেখালেই সম্পূর্ণ key কপি করুন। ব্যবহারকারী service-এর সীমিত access-সহ encrypted secret manager-এ রাখুন। Source code, browser code, log, screenshot, ticket বা chat-এ কখনো দেবেন না। একবারের display মিস করলে বা value খুঁজে না পেলে key rotate করুন; support plaintext উদ্ধার করতে পারে না।
- দেখানো value সরাসরি সুরক্ষিত storage-এ নিন।
- Documented setting দিয়ে consumer কনফিগার করুন।
- ফাঁস বা হারানোর সন্দেহ হলে সঙ্গে সঙ্গে rotate করুন।
Rotate বা revoke করুন
Rotation পুরোনো credential revoke করে একই নাম, tier, scope ও allowlist-সহ replacement তৈরি করে। নতুন value একবার দেখানো হয়; পুরোনো key বন্ধ হয়ে যাবে বলে নির্ভরশীল service দ্রুত update করুন। Revocation replacement না দিয়ে নির্বাচিত key নিষ্ক্রিয় করে। Action দেওয়ার আগে সঠিক key ও context নিশ্চিত করুন।
- নিয়মিত rotation-এর আগে সব consumer শনাক্ত করুন।
- নতুন value সংরক্ষণ করে নির্ভরশীল service update করুন।
- পুরোনো key revoke করে dashboard state যাচাই করুন।
Rejected request নির্ণয় করুন
Key malformed বা revoked, user inactive, source IP allowlist-এর বাইরে, অথবা চাওয়া scope নেই—এ কারণে request প্রত্যাখ্যাত হতে পারে। Sandbox request মাসিক সীমাও ছাড়াতে পারে। Context, deployed secret version, caller egress address ও প্রয়োজনীয় scope যাচাই করুন। সহায়তা চাইলে secret দেবেন না।
- Key সক্রিয় ও প্রয়োজনীয় operation scope আছে নিশ্চিত করুন।
- প্রকৃত source IP ও sandbox allowance তুলুন।
- ভুল বা ফাঁস হলে rotate করুন; শুধু গোপন তথ্য-বর্জিত reference দিন।
সাধারণ জিজ্ঞাসা
পরে key আবার দেখা যাবে?
না। নতুন value পেতে rotate করুন।
কোন scope দেব?
Integration-এ প্রয়োজনীয় তালিকাভুক্ত scope-গুলোই।
Member কি organisation key তৈরি করতে পারে?
না। Owner ও administrator organisation key পরিচালনা করেন।
Rotation করলে পুরোনো key সচল থাকে?
না। Rotation পুরোনোটি revoke করে replacement দেয়।
Caller IP বদলালে কী করব?
অনুমোদিত key manager দিয়ে allowlist update করুন।
দুটি sandbox key রাখা যায়?
প্রতি context-এ একটিই সক্রিয় sandbox key।