https://api.phaseo.app/v1) पर भेजें:
मैनेजमेंट कुंजियाँ, API कुंजियाँ और OAuth टोकन
मैनेजमेंट रूट केवल मैनेजमेंट कुंजियाँ (या OAuth टोकन) स्वीकार करते हैं; Gateway API कुंजी उन्हें कॉल नहीं कर सकती।
गार्डरेल एक अलग नियंत्रण हैं: वे Gateway API कुंजियों पर लागू होते हैं और इन्फ़रेंस ट्रैफ़िक को नियंत्रित करते हैं, जैसे रूटिंग प्रतिबंध, बजट, प्रॉम्प्ट-इंजेक्शन से निपटना और संवेदनशील जानकारी के नियम। मैनेजमेंट कुंजी की क्षमताएँ तय करती हैं कि वह कौन से प्रशासन API कॉल कर सकती है।
ऐक्सेस स्तर चुनें
कुंजी बनाते समय हर टेम्पलेट क्षमताओं की एक स्पष्ट सूची में बदल जाता है। Phaseo कभीall जैसा वाइल्डकार्ड सेव नहीं करता, इसलिए कुंजी को बाद में जोड़ी गई अनुमति कभी नहीं मिलती।
किसी भी टेम्पलेट में
billing:write शामिल नहीं है, जो क्रेडिट टॉप-अप शुरू करती है; इसे --scopes के साथ स्पष्ट रूप से माँगें। सभी का उपयोग केवल भरोसेमंद प्रशासनिक ऑटोमेशन के लिए करें।
छोटी अनुमति के लिए, अपनी ज़रूरत की क्षमताएँ --scopes scope_a,scope_b के साथ दें:
क्षमताएँ वर्कस्पेस भूमिकाओं को ओवरराइड नहीं करतीं
Phaseo हर कॉल पर दो चीज़ें जाँचता है: कुंजी के पास क्षमता है, और कुंजी या OAuth उपयोगकर्ता उस वर्कस्पेस में उस भूमिका के साथ है जिसकी कार्रवाई को ज़रूरत है। उदाहरण के लिए,keys:write कुंजी प्रबंधन की अनुमति देती है, लेकिन भूमिका जाँच फिर भी तय करती है कि कॉल करने वाला उस वर्कस्पेस में कुंजियाँ प्रबंधित कर सकता है या नहीं। कोई कुंजी किसी क्षमता के सहारे दूसरे वर्कस्पेस तक नहीं पहुँच सकती और न ही ओनर और एडमिन जाँच छोड़ सकती है।
कुंजियाँ सुरक्षित रखें
- मैनेजमेंट कुंजियों को ब्राउज़र, डेस्कटॉप लॉग, सोर्स कंट्रोल और चैट से दूर रखें।
- हर इंटीग्रेशन के लिए एक कुंजी रखें, और सबसे सीमित टेम्पलेट चुनें जो काम करे।
- जब इंटीग्रेशन को अनिश्चितकालीन ऐक्सेस की ज़रूरत न हो, तो समाप्ति तिथि सेट करें।
- अनुपयोगी कुंजियों को तुरंत रोकें या डिलीट करें।
- लीक हुई कुंजी को आगे जाँच करने से पहले रोटेट करें।