Mail.ru (oAuth 2.0) के माध्यम से साइट पर प्राधिकरण

सभी को नमस्कार!
मेलबर्न सहित विभिन्न सेवाओं पर प्राधिकरण के बारे में एनजेड का एक लेख पहले से ही मौजूद था। लेकिन यह Yii के लिए था और इस प्रक्रिया का विस्तार से वर्णन नहीं किया गया था। प्रोवेडनिक से एक लेख भी था, लेकिन इसने जावास्क्रिप्ट + php के माध्यम से प्राधिकरण प्रक्रिया का वर्णन किया। इस लेख में, मैं सर्वर प्राधिकरण विधि के बारे में विस्तार से जांच करना चाहूंगा। प्राधिकरण के लिए, PHP और सर्वर-सर्वर मॉडल का उपयोग किया जाएगा।

चरण 1. एक साइट रजिस्टर

हम लिंक http://api.mail.ru/sites/my/add का अनुसरण करते हैं और हमारी साइट को पंजीकृत करते हैं। इसके बाद, रिसीवर को डाउनलोड करें और अपलोड करें।
पंजीकरण के बाद, हमें 3 पैरामीटर दिए जाएंगे:

• आईडी
• निजी कुंजी
• गुप्त कुंजी

हम केवल आईडी और गुप्त कुंजी में रुचि रखेंगे (क्लाइंट-सर्वर मॉडल के लिए निजी कुंजी की आवश्यकता है)। हम उन्हें निम्नलिखित नामों के तहत हमारी स्क्रिप्ट की कॉन्फ़िगरेशन फ़ाइल में सहेजेंगे।

$APP_ID; $APP_SECRET; 

चरण 2. कोड प्राप्त करना

कोड प्राप्त करने के लिए, आपको connect.mail.ru/oauth/authorize से संपर्क करना होगा, इसके लिए $ _GET पैरामीटर पास करना होगा:

• client_id - साइट आईडी
• response_type - से चुनने के लिए 3 विकल्प। टोकन - एपीआई तक पहुंच केवल जावास्क्रिप्ट, कोड_और_टोकेन के माध्यम से दी जाएगी - सर्वर और जावास्क्रिप्ट के माध्यम से एपीआई तक पहुंच, कोड - सर्वर के माध्यम से एपीआई तक पहुंच। हमारे मामले में, यह कोड होगा।
• redirect_uri - response_type प्राप्त पृष्ठ का URL
• गुंजाइश - आवेदन विशेषाधिकार । पैरामीटर वैकल्पिक है और हमारे मामले में बेमानी है। यदि आप विशेषाधिकारों का अनुरोध करने का निर्णय लेते हैं, तो ध्यान रखें कि सभी उपयोगकर्ता अपने निजी डेटा को आपके पास स्थानांतरित नहीं करना चाहेंगे, इसलिए प्राधिकरण के लिए गुंजाइश पैरामीटर का उपयोग करें।

सुविधा के लिए, हम कोड प्राप्त करने और उसके प्रसंस्करण के लिए लिंक बनाने के लिए तर्क को विभाजित करेंगे:
example.com/login.php - कोड प्राप्त करने के लिए एक लिंक उत्पन्न करें (वास्तव में, प्राधिकरण के लिए एक लिंक)।
example.com/auth.php - प्रोसेसिंग कोड।

अंतिम क्वेरी इस तरह दिखाई देगी:

 $redirect_uri = urlencode("http://example.com/auth.php"); $login_url = "https://connect.mail.ru/oauth/authorize?client_id={$APP_ID}&response_type=code&redirect_uri={$redirect_uri}"; 

इस पते पर जाकर Mail.ru पर एक अनधिकृत उपयोगकर्ता देखेंगे:

यदि उपयोगकर्ता Mail.ru पर अधिकृत है, तो वह उसी विंडो को देखेगा, लेकिन लॉगिन और पासवर्ड दर्ज किए बिना।
अब उपयोगकर्ता के पास 2 विकल्प हैं: सक्षम और अक्षम करें। प्रतिबंध लगाकर, उपयोगकर्ता को पुनर्निर्देशित पृष्ठ पर एक त्रुटि के साथ पुनर्निर्देशित किया जाएगा।

यदि सब कुछ सही हो गया और उपयोगकर्ता ने साइट को अपने डेटा तक पहुंच की अनुमति दी, तो उपयोगकर्ता $ _GET कोड पैरामीटर के साथ रीडायरेक्ट_यूरी पृष्ठ (http://example.com/auth.php) पर पुनर्निर्देशित हो जाएगा।
नाम के तहत इसे सहेजें

 $APP_CODE; 

चरण 3. टोकन और यूआईडी प्राप्त करना

अगला, हमें सत्र पहचानकर्ता (टोकन) और Mail.ru उपयोगकर्ता आईडी के लिए प्राप्त कोड का आदान-प्रदान करने की आवश्यकता है, जिसके लिए एपीआई एक्सेस किया जा रहा है।

ऐसा करने के लिए, आपको connect.mail.ru/oauth/token से संपर्क करना होगा, इसके लिए पैरामीटर पास करना होगा:

• client_id ($ APP_ID)
• client_secret ($ APP_SECRET)
• अनुदान_प्रकार (प्राधिकरण_कोड)
• कोड ($ APP_CODE)
• redirect_uri (चरण 2 से $ पुनर्निर्देशित)

सभी मापदंडों की आवश्यकता है। रीडायरेक्ट_यूरी को ठीक उसी तरह मेल खाना चाहिए जिसका हमने चरण 2 में उपयोग किया था।

टोकन के लिए अनुरोध केवल POST अनुरोध के माध्यम से किया जा सकता है, इसलिए मदद करने के लिए CURL:

 $ch = curl_init(); $url = "https://connect.mail.ru/oauth/token"; $fields = Array( 'client_id' => $APP_ID, 'client_secret' => $APP_SECRET, 'grant_type' => "authorization_code", 'code' => $APP_CODE, 'redirect_uri' => urlencode(redirect_uri) ); foreach($fields as $key => $value){ $fields_string .= $key . '=' . $value . '&'; } rtrim($fields_string, '&'); curl_setopt($ch, CURLOPT_URL, $url); curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1); curl_setopt($ch, CURLOPT_POST, true); curl_setopt($ch, CURLOPT_POSTFIELDS, $fields_string); $result = curl_exec($ch); curl_close($ch); $arr = json_decode($result, true); // $arr = (array) json_decode($result).  - ,   ? $token = $arr['access_token']; $uid = $arr['x_mailru_vid']; 

चरण 4. उपयोगकर्ता डेटा प्राप्त करें

टोकन और यूआईडी प्राप्त करने के बाद , साइट www.appsmail.ru/platform/api पर Mail.ru API की लंबे समय से प्रतीक्षित पहुंच प्राप्त करती है ।
लेकिन सब कुछ इतना सरल नहीं है, एपीआई के हर अनुरोध पर हस्ताक्षर किए जाने चाहिए। हस्ताक्षर (हमारे मामले में) एक हैश की गणना है, जो बिना किसी विभाजक और निजी कुंजी के एपीआई को दिए गए मापदंडों के एक वर्णानुक्रम से क्रमबद्ध स्ट्रिंग से md5 एल्गोरिथ्म का उपयोग करता है।
उदाहरण के लिए:

 md5('app_id=423004method=friends.getsession_key=be6ef89965d58e56decdfacb9b62bdaa' . $APP_SECRET); 

Mail.ru क्लाइंट-सर्वर और सर्वर-सर्वर: 2 हस्ताक्षर विकल्प प्रदान करता है। अंतर 2 के दृष्टिकोण की अधिक सुरक्षा है। हम इसका उपयोग करेंगे। ऐसा करने के लिए, आपको API के अनुरोध में सुरक्षित = 1 निर्दिष्ट करना होगा।

हम Users.getInfo पद्धति का उपयोग करके Mail.ru उपयोगकर्ता की व्यक्तिगत जानकारी प्राप्त करने के अनुरोध को पूरा करेंगे।

 $request_params = Array( 'app_id' => $APP_ID, 'uids' => $uid, 'method' => 'users.getInfo', 'secure' => 1, 'session_key' => $token ); //        ksort($request_params); $params = ''; foreach ($request_params as $key => $value) { $params .= "$key=$value"; } //  -    $sig = md5($params . $APP_SECRET); //  $url = "http://www.appsmail.ru/platform/api?method=users.getInfo&app_id={$APP_ID}&session_key={$token}&sig={$sig}&uids={$uid}&secure=1"; $response = file_get_contents($url); $info = (array) json_decode($response); $info = $info[0]; //  print_r($info); 

वह सब है। इस प्रकार, हमें वह डेटा मिला है जिसे हमें डेटाबेस में उपयोगकर्ता को दर्ज करने की आवश्यकता है। बाद की पूरी प्रक्रिया को पहले ही बार-बार वर्णित किया जा चुका है, उदाहरण के लिए यहाँ । इसलिए मुझे इसका वर्णन करने का कोई कारण नहीं दिखता।

लाभ !! 1 सभी को अच्छा। यदि लेख दिलचस्प हो जाता है, तो मैं Vkontakte और Facebook के लिए सर्वर-साइड oAuth 2.0 प्राधिकरण प्रक्रिया का विश्लेषण भी कर सकता हूं।

संदर्भ

• Mail.ru पर प्राधिकरण प्रलेखन
• Mail.ru REST API
• अनुप्रयोगों के लिए अतिरिक्त विशेषाधिकार