एपीआई एक्सेस, स्कोप और डेवलपर अनुमति नीति
कैसे X2 सेवा, उद्देश्य और अनुमति द्वारा मॉड्यूलर एपीआई एक्सेस प्रदान करता है।
1. सिद्धांत
X2, X2 प्लेटफ़ॉर्म पर अप्रतिबंधित पहुंच के बजाय उद्देश्य, सेवा और अनुमति द्वारा प्रौद्योगिकी तक पहुंच प्रदान करता है।
2. सेवा-आधारित पहुंच
समर्थित एपीआई डोमेन में कैटलॉग, अधिकार और प्रकाशन, वितरण, विश्लेषण, दर्शक, सामाजिक और यूजीसी मुद्रीकरण, रॉयल्टी और रिपोर्टिंग, एआई सत्यापन, व्यावसायिक सत्यापन और अन्य अधिकृत सेवाएं शामिल हो सकती हैं। एक डोमेन तक पहुंच का तात्पर्य दूसरे डोमेन से नहीं है।
3. कार्यक्षेत्र-आधारित प्राधिकरण
क्रेडेंशियल पढ़ने, लिखने या संवेदनशील क्रियाओं जैसे कैटलॉग.रीड, कैटलॉग.राइट, राइट्स.रीड, राइट्स.क्लेम्स.सबमिट, डिस्ट्रीब्यूशन.सबमिट, एनालिटिक्स.रीड, रॉयल्टी.रीड या एआई.वेरीफाई तक सीमित हो सकते हैं। अंतिम तकनीकी दायरे के नाम एपीआई विनिर्देश में परिभाषित किए गए हैं।
4. उपयोगकर्ता, कार्यक्षेत्र और संगठन प्राधिकरण
एप्लिकेशन केवल अधिकृत उपयोगकर्ता, संगठन या अन्य संस्था से संबंधित संसाधनों तक पहुंच सकते हैं जिनके लिए स्पष्ट अनुमति दी गई है। अप्रतिबंधित क्रॉस-ग्राहक पहुंच सामान्य एपीआई प्राधिकरण का हिस्सा नहीं है।
5. आवेदन पंजीकरण
X2 को पहुंच प्रदान करने से पहले डेवलपर या कंपनी की पहचान, एप्लिकेशन का नाम, इच्छित उद्देश्य, रीडायरेक्ट यूआरएल, अनुरोधित दायरे, अपेक्षित ट्रैफ़िक, सुरक्षा जानकारी, डेटा-प्रतिधारण प्रथाओं और संपर्क विवरण की आवश्यकता हो सकती है।
6. अनुमोदन स्तर
X2 जोखिम, कार्य और संविदात्मक आवश्यकताओं के आधार पर मानक, सत्यापित-डेवलपर, प्रतिबंधित और उद्यम या भागीदार पहुंच को अलग कर सकता है।
7. संवेदनशील क्षेत्र
अधिकार हस्तांतरण, स्वामित्व परिवर्तन, लाभार्थी परिवर्तन, भुगतान निर्देश, केवाईसी या पहचान डेटा, प्रवर्तन कार्रवाई, थोक दावा और अन्य संवेदनशील कार्यों के लिए मैन्युअल अनुमोदन, मजबूत सत्यापन या अलग समझौतों की आवश्यकता हो सकती है।
8. वित्तीय अनुमतियाँ
रॉयल्टी रिपोर्ट पढ़ने की अनुमति स्वचालित रूप से लाभार्थी परिवर्तन, बैंक-खाता परिवर्तन या भुगतान आरंभ को अधिकृत नहीं करती है।
9. अधिकार अनुमतियाँ
अधिकार डेटा को पढ़ने की अनुमति स्वचालित रूप से अधिकार हस्तांतरण, दावे या स्वामित्व परिवर्तन को अधिकृत नहीं करती है।
10. OAuth सहमति
उपयोगकर्ता के लिए काम करने वाले एप्लिकेशन को स्पष्ट दायरे का अनुरोध करना चाहिए और उन अनुमतियों को स्पष्ट रूप से प्रस्तुत करना चाहिए। उपयोगकर्ताओं को भविष्य में पहुंच रद्द करने में सक्षम होना चाहिए।
11. कोई यूनिवर्सल एपीआई कुंजी नहीं
X2 एक सार्वभौमिक क्रेडेंशियल का उपयोग नहीं करता है जो स्वचालित रूप से प्रत्येक सेवा तक पहुंच प्रदान करता है। क्रेडेंशियल्स स्वामी, एप्लिकेशन, कार्यक्षेत्र, वातावरण, सीमा और स्थिति से जुड़े होने चाहिए।
12. ऑडिट ट्रेल
संवेदनशील एपीआई कार्रवाइयों को अभिनेता, एप्लिकेशन, स्कोप, संसाधन, कार्रवाई, समय और परिणाम के साथ लॉग किया जा सकता है।
13. सैंडबॉक्स और उत्पादन
सैंडबॉक्स और उत्पादन पहुंच अलग-अलग हैं। उत्पादन पहुंच के लिए अतिरिक्त सत्यापन और अनुमोदन की आवश्यकता हो सकती है।
14. आंतरिक सेवा-से-सेवा पहुंच
वही न्यूनतम-विशेषाधिकार सिद्धांत आंतरिक X2 सेवाओं पर लागू होता है। एक सेवा को अप्रतिबंधित डेटाबेस एक्सेस के बजाय केवल अपने कार्य के लिए आवश्यक एपीआई अनुमतियाँ प्राप्त करनी चाहिए।
15. प्रदाता एडेप्टर
बाहरी डीएसपी, वित्तीय प्रदाता, अधिकार संगठन और अन्य एडेप्टर केवल विशिष्ट एकीकरण के लिए आवश्यक डेटा एक्सेस प्राप्त करते हैं।
16. डेटा निर्यात
अधिकृत उपयोगकर्ता असंबंधित ग्राहक डेटा, मालिकाना आंतरिक डेटासेट, सुरक्षा जानकारी या धोखाधड़ी मॉडल प्राप्त किए बिना योग्य कैटलॉग, मेटाडेटा, अधिकार, रिपोर्ट, पंजीकरण या अन्य समर्थित जानकारी निर्यात कर सकते हैं।
17. फीस और निलंबन
एपीआई पहुंच मुफ़्त, सेवा-आधारित या उपयोग-आधारित हो सकती है। X2 संपूर्ण ग्राहक खाते को निलंबित किए बिना किसी अपमानजनक क्रेडेंशियल या एप्लिकेशन को निलंबित कर सकता है।