📞 ⏺️ 🚃 Z- भुगतान (OAuth 2.0) के माध्यम से साइटों पर प्राधिकरण 🌚 📈 👤

नमस्कार हेब्रोसोसिटी! यह आलेख तृतीय-पक्ष साइटों पर उपयोगकर्ताओं को अधिकृत करने के लिए OAuth 2.0 पर आधारित Z-Payment API प्रोटोकॉल का वर्णन करता है। हम स्वीकार करते हैं कि पंजीकरण हमेशा आलसी होता है, इस तथ्य का उल्लेख नहीं करने के लिए कि आपको व्यक्तिगत जानकारी (कम से कम मेल द्वारा) साझा करनी है, और जब आपको केवल एक बार ऐसा करने की आवश्यकता होती है, तो आलस्य दुगना होता है। यही कारण है कि बड़ी संख्या में उपयोगकर्ताओं के साथ इंटरनेट सेवाएं स्वयं के माध्यम से तृतीय-पक्ष संसाधनों पर प्राधिकरण की संभावना प्रदान करती हैं और इस मामले में जेड-भुगतान अब अपवाद नहीं है।

परिचय

हाल ही में, Z-Payment टीम ने OAuth 2.0 प्रोटोकॉल के आधार पर एक सर्वर प्राधिकरण तंत्र लागू किया, जो डेवलपर्स को Z-Payment सेवा के माध्यम से तृतीय-पक्ष साइटों पर प्राधिकरण बनाने और अधिकृत उपयोगकर्ताओं के व्यक्तिगत डेटा का अनुरोध उनकी सहमति से करने का अवसर प्रदान करता है। यह विधि आपको तृतीय-पक्ष साइट पर सुरक्षित उपयोगकर्ता प्रमाणीकरण को लागू करने की अनुमति देती है।

इस इंटरफ़ेस तक पहुंच का लाभ उठाने के लिए, आपको 3 आवश्यक शर्तें पूरी करनी होंगी:

Z- पेमेंट पर रजिस्ट्रेशन करवाएं
एक साइट रजिस्टर करें
साइट को सार्वजनिक स्थिति प्राप्त करनी चाहिए, अर्थात Z- कैटलॉग में प्रकाशित

प्राधिकरण के इस तरीके को लागू करते समय जेड-पेमेंट का मुख्य कार्य डेवलपर्स को जेड-पेमेंट संसाधनों का उपयोग करके स्वतंत्र प्रोजेक्ट बनाने के लिए एक अन्य उपकरण प्रदान करना है। एक सफल उदाहरण जेड-चेंज एक्सचेंज एक्सचेंज परियोजना है।
प्राधिकरण प्रक्रिया में 4 चरण होते हैं:

Z- भुगतान पर प्राधिकरण के लिए उपयोगकर्ता का संक्रमण
व्यक्तिगत डेटा तक पहुंचने के लिए उपयोगकर्ता की अनुमति। उपयोगकर्ता को तृतीय पक्ष (आप) द्वारा अनुरोधित डेटा के प्रावधान से सहमत होना चाहिए। यदि उपयोगकर्ता Z-Payment पर अधिकृत नहीं है, तो उसे अपने व्यक्तिगत खाते को अधिकृत करने के लिए कहा जाएगा। सफल प्राधिकरण के बाद, उपयोगकर्ता को व्यक्तिगत डेटा तक पहुंच की अनुमति देने के लिए कहा जाएगा
एक्सेस कुंजी प्राप्त करने के लिए साइट पर कोड मान पास करना
Z-Payment API तक पहुंचने के लिए प्रोजेक्ट सर्वर access_token एक्सेस कुंजी प्राप्त करना

अब क्रम में और अधिक

दी: साइट। कार्य Z- भुगतान के माध्यम से अपने उपयोगकर्ताओं को अधिकृत / पंजीकृत करना है।

चरण 1

Z- भुगतान के लिए प्राधिकरण के लिए उपयोगकर्ता को पुनर्निर्देशित करना आवश्यक है, आप पते में GET या POST अनुरोध द्वारा ऐसा कर सकते हैं z-payment.ru/enter.php z-payment.ru/enter.php मापदंडों के साथ:
client_id - एक आवश्यक पैरामीटर, एक चार-अंकीय, Z- भुगतान में अद्वितीय स्टोर पहचानकर्ता, सिस्टम में एक साइट को पंजीकृत करते समय जारी किया गया।
रीडायरेक्ट - एक आवश्यक पैरामीटर, वह पता जिसे उपयोगकर्ता को प्राधिकरण के बाद पुनर्निर्देशित किया जाएगा (निर्दिष्ट पते का डोमेन स्टोर सेटिंग्स में मुख्य डोमेन के अनुरूप होना चाहिए)
प्रदर्शन - आवश्यक पैरामीटर, प्राधिकरण पृष्ठ के प्रदर्शन के प्रकार को इंगित करता है। वर्तमान में यह केवल पृष्ठ का समर्थन करता है, जिसका अर्थ है एक अलग विंडो में प्राधिकरण
गुंजाइश - वैकल्पिक पैरामीटर, यह पैरामीटर उपयोगकर्ता के बारे में अनुरोधित व्यक्तिगत डेटा की सूची के लिए जिम्मेदार है। अनुरोधित डेटा को अल्पविराम या स्थान से अलग किया जाना चाहिए।
यहां संभावित अनुरोधित डेटा की एक सूची दी गई है:

0	f_name	पहला नाम
1	s_name	उपनाम
2	m_name	मध्य नाम
3	birth_day	जन्म की तारीख
4	समूह	प्रमाण पत्र का प्रकार
5	लिंग	पॉल
6	e_mail	मेल
7	फ़ोन	मोबाइल नंबर
8	देश	देश
9	शहर	शहर
10	संतुलन	बटुआ संतुलन

response_type एक वैकल्पिक पैरामीटर है, यह उस प्रकार की प्रतिक्रिया के लिए ज़िम्मेदार है, जिसे हम प्राप्त करना चाहते हैं, यह मान ले सकता है: कोड - यदि हम किसी तृतीय-पक्ष सर्वर (डिफ़ॉल्ट रूप से) या टोकन से अनुरोध करना चाहते हैं - यदि हम क्लाइंट से अनुरोध करना चाहते हैं।
जैसा कि ऊपर कहा गया है, एक GET अनुरोध इस तरह दिखना चाहिए:

GET: z-payment.ru/enter.php?client_id=ID__&redirect=http://.ru/login&dispaly=page&scope=f_name,s_name,m_name,phone,city,e_mail&response_type=code

चरण 2

इस तरह के लिंक पर क्लिक करके, उपयोगकर्ता एक पृष्ठ पर होगा जहां उसे तीसरे व्यक्ति (आपकी साइट) को डेटा प्रदान करने के लिए सहमति देने के लिए कहा जाएगा जो आप गुंजाइश पैरामीटर में अनुरोध करते हैं, या पहले लॉग इन करें यदि उसने ऐसा नहीं किया है, और फिर सहमति है। इसके अलावा, उपयोगकर्ता की सहमति से, स्वचालित मोड में, उसे रीडायरेक्ट पैरामीटर में निर्दिष्ट पृष्ठ पर स्थानांतरित किया जाएगा।

चरण 3

वापस लौटकर, GET विधि कोड पैरामीटर पारित करेगी, जिसमें अस्थायी कोड शामिल है। इसके साथ, डेटा का अनुरोध करना संभव हो जाता है जिसके लिए उपयोगकर्ता ने सहमति दी है। पैरामीटर जीवनकाल 15 मिनट है, इस अवधि के दौरान आपको अनुरोध स्थल से access_token API तक पहुंच कुंजी प्राप्त करने की आवश्यकता है। यह इस तरह दिखेगा:

GET: REDIRECT_URI?code=a2a56603b8f57a6fa4dff77380df05206c883f011c40b72630bb5ed6f6479e52a8e
:
GET: REDIRECT_URI?error=invalid_request&error_description=Invalid+display+parameter

चरण 4

अंतिम चरण में, हम पते z-payment.ru/api/get_access_token.php पर अनुरोध भेजकर पहुंच प्राप्त करते हैं, चरण 1 में अनुरोध के रूप में, GET या POST विधि द्वारा प्रेषित किया जा सकता है और इसमें निम्नलिखित पैरामीटर शामिल होने चाहिए:
client_id - एक आवश्यक पैरामीटर, चार-अंकीय, z- भुगतान प्रणाली में अद्वितीय स्टोर पहचानकर्ता, Z- भुगतान व्यापारी में एक दुकान को पंजीकृत करते समय जारी किया गया (ऊपर देखें)

कोड - एक आवश्यक पैरामीटर, चरण 3 में प्राधिकरण के बाद प्राप्त एक अस्थायी कोड (ऊपर देखें)

format_answer - वैकल्पिक, प्रतिक्रिया प्रारूप, json डिफ़ॉल्ट रूप से उपयोग किया जाता है। यह मान ले सकता है: json, get।
client_secret - आवश्यक पैरामीटर, एक इलेक्ट्रॉनिक हस्ताक्षर है। यह अनुरोध पैरामीटर और मर्चेंट की स्टोर पासवर्ड के चिपके स्ट्रिंग से हैश md5 के रूप में बनता है।
हस्ताक्षर में शामिल डेटा: client_id + code + MerchantKey - इसमें से हम MD5 लेते हैं

अनुरोध का परिणाम मापदंडों से मिलकर एक उत्तर होना चाहिए:
access_token, expires_in प्रमुख जीवनकाल (सेकंड में), user_id वॉलेट ZP नंबर user_verification - उपयोगकर्ता प्रमाणन के बारे में जानकारी (उपयोगकर्ता के पास प्रमाणपत्र होने पर हाँ स्वीकार करता है), साथ ही पहले अनुरोध से अनुरोधित फ़ील्ड का एक सेट।

यह अब प्राधिकरण प्रक्रिया के सैद्धांतिक विवरण को पूरा करता है
पूर्वगामी के आधार पर, प्रोटोकॉल का एक सॉफ्टवेयर कार्यान्वयन करना संभव है, मैं इसे php 5.3 पर करूंगा और यह माना जाता है कि कार्यान्वित वर्ग का उपयोग किसी प्रकार के MVC आर्किटेक्चर में किया जाना चाहिए।
तो, कार्य Z- भुगतान के माध्यम से प्राधिकरण को स्वचालित करने के लिए एक सरल वर्ग बनाना है। मैं तुरंत कोड पर आरक्षण करना चाहता हूं:

परिभाषित स्थिरांक को कॉन्फ़िगरेशन फ़ाइल में ले जाने की आवश्यकता है, मैं उन्हें स्पष्टता के लिए उदाहरण में उपयोग करता हूं,
मैं एक वर्ग का उदाहरण नहीं देता हूं जो IUserStorage इंटरफ़ेस को लागू करता है, जहाँ भी आप चाहते हैं डेटा संग्रहीत किया जा सकता है - एक सत्र (SessionUserStorage), एक डेटाबेस (DbUserStorage) या एक फ़ाइल (FileUserStorage), और इसलिए यह केवल इंटरफ़ेस को जानने के लिए पर्याप्त है। कोड प्रलेखित है, इसलिए मुझे लगता है कि अतिरिक्त टिप्पणी उबाऊ है।

PHP कोड ही

 /** @desc ID      */ define("SHOP_ID", "0001"); /** @desc MERCHANT KEY      */ define("MERCHANT_KEY", "password"); namespace Example; /** @desc           */ interface IUserStorage { /** @desc     */ public function load(); /** @desc       */ public function save(array $data); /** @desc     */ public function erase(); } /** @desc     */ class UserManager { const TOKEN_URL = "https://z-payment.ru/api/get_access_token.php"; /** * @var \Example\IUserStorage * @desc  */ protected $storage; /** * @var $userInfo array * @desc     */ protected $userInfo; /** * @var \Example\Controller\Base * @desc     mvc ,      */ protected $controller; /** * @param IUserStorage $storage * @desc   $storage    \Example\IUserStorage */ public function __construct(\Example\IUserStorage $storage) { $this->storage = $storage; $this->userInfo = $this->storage->load(); } /** @desc   ,     */ public function getUserInfo($field = null) { if (null === $field) return $this->userInfo; if (isset($this->userInfo[$field])) return $this->userInfo[$field]; return null; } /** * @return bool * @desc     */ public function isLogin() { return ($this->userInfo != null); } /** * @desc  ZP  * @return string | null */ public function getAccount() { if (!$this->isLogin()) return null; return $this->userInfo['user_id']; } /** * @return bool * @desc       */ public function isCertified() { return ($this->getUserInfo('user_verification') == 'yes'); } /** * @return bool * @desc    */ public function Login() { /** @desc    code,  mvc   ,      $code = $_REQUEST['code']; */ $code = $this->controller->getRequest()->get("code"); /** * @desc  ,    md5     * 1+2+Merchant Key,  Merchant Key    */ $client_secret = md5(SHOP_ID . $code . MERCHANT_KEY); /** @desc     */ $params = array( /** id  */ 'client_id=' . urlencode(SHOP_ID), /**      */ 'code=' . urlencode($code), /**    */ 'format_answer=' . 'json', /**   */ 'client_secret=' . urlencode($client_secret) ); $curl = curl_init(self::TOKEN_URL); curl_setopt($curl, CURLOPT_HEADER, 1); curl_setopt($curl, CURLOPT_POST, 1); curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1); curl_setopt($curl, CURLOPT_POSTFIELDS, implode("&", $params)); /** @desc    */ $result = curl_exec($curl); curl_close($curl); /** @desc    */ $result = json_decode($result); /** @desc     */ if ($result->error != null) return false; /** @desc    */ $this->storage->save((array)$result); return true; } /** * @desc   * @return void */ public function LogOut() { /** @desc   */ $this->storage->erase(); } /** * @param \Example\Controller\Base $controller * @return void * @desc   . */ public function setController(\Example\Controller\Base $controller) { $this->controller = $controller; /** * @var isLogin bool * @desc     */ $controller->getView()->isLogin = $this->isLogin(); /** @var $client_id int */ $client_id = SHOP_ID; /** * @var $redirect_uri string * @desc URL  */ $redirect_uri = "http://example_site_domain.org/login"; $display = "page"; /** * @var $scope strung * @desc   */ $scope = "f_name,s_name,m_name,sex,birth_day,group,e_mail,phone,country,city,balance"; if ($this->isLogin()) { /** @desc   ,      */ $controller->getView()->userName = $this->userInfo['f_name'] . " " . $this->userInfo['s_name']; } else { /** @desc    ,       */ $controller->getView()->linkZpAuth = sprintf("https://z-payment.ru/enter.php?client_id=%s&redirect_uri=%s&display=%s&scope=%s", $client_id, $redirect_uri, $display, $scope); } } }

जैसा कि आप देख सकते हैं, प्राधिकरण प्रक्रिया इस सुविधा की पेशकश करने वाली अन्य इंटरनेट सेवाओं के लगभग समान है, खासकर यदि आप वीके एपीआई को देखते हैं। :)

मेरे विनम्र काम को पढ़ने में आपके धैर्य के लिए मैं आपको धन्यवाद देता हूं और मैं उस प्रश्न का उत्तर देना चाहता हूं जो पहले पैराग्राफ को पढ़ने के बाद आपको पीड़ा देने लगा था - "अगर मुझे वीके, जीमेल, फेसबुक, इत्यादि की तुलना में काफी कम उपयोगकर्ता हैं, तो मुझे ZP के माध्यम से प्राधिकरण को फास्ट करने की आवश्यकता क्यों है?" , मैं जवाब देता हूं: अन्य साइटों पर कई OAuth प्रोटोकॉल कार्यान्वयनों के विपरीत, Z- पेमेंट एपीआई के माध्यम से प्राधिकरण से सत्यापित उपयोगकर्ता जानकारी प्राप्त होती है, जो ई-कॉमर्स से संबंधित सभी परियोजनाओं के लिए बहुत महत्वपूर्ण है।

आप प्रलेखन इंटरफेसएचटीटीपीएस.ज़िप डॉक्टर फ़ाइल में जेड-भुगतान एपीआई के बारे में अधिक पढ़ सकते हैं