पेश है Apple - Apple प्राधिकरण सिस्टम के साथ साइन इन करें

नमस्कार, हेब्र!

इस साल की गर्मियों में, WWDC 2019 सम्मेलन में, Apple ने Apple प्राधिकरण प्रणाली के साथ अपना स्वयं का साइन इन किया और सोशल मीडिया लॉगिन का उपयोग करने वाले ऐप स्टोर के सभी अनुप्रयोगों के लिए इसे अनिवार्य बना दिया। अपवाद शैक्षिक, कॉर्पोरेट, सरकार और व्यावसायिक अनुप्रयोग हैं जो अपने स्वयं के प्राधिकरण का उपयोग करते हैं। Apple के साथ साइन इन करने के लिए, Apple ने उच्च-गुणवत्ता वाले दस्तावेज़ बनाए हैं, और इस लेख में हम CIAN के उदाहरण का उपयोग करके वर्णन करेंगे कि इसे हमारी सेवा में कैसे लागू किया जाए।

Apple डेवलपर अकाउंट कॉन्फ़िगर करें

एकता का काम एक डेवलपर खाते की स्थापना के साथ शुरू होता है। सबसे पहले आपको अपने ऐप आईडी के लिए साइन इन ऐप्पल विकल्प को सक्षम करना होगा। ऐसा करने के लिए, Apple डेवलपर खाते में पहचानकर्ताओं की सूची पर जाएं , आवश्यक ऐप आईडी चुनें और इसके लिए साइन इन ऐप्पल विकल्प को सक्षम करें।

अब हम सेवा आईडी को कॉन्फ़िगर करते हैं - वेब एप्लिकेशन के लिए एक विशिष्ट पहचानकर्ता जिसे आपको ऐप्पल एपीआई के साथ साइन का उपयोग करना होगा। कुल मिलाकर, प्रति ऐप आईडी पर 5 सेवा आईडी बनाई जा सकती हैं। ऐसा करने के लिए, पहचानकर्ता बनाने के लिए बटन पर क्लिक करें, सेवा आईडी चुनें, आवश्यक फ़ील्ड भरें और साइन इन ऐप्पल फ़ील्ड में संपादित करें पर क्लिक करें। एक फॉर्म खुल जाएगा जहां हम सही प्राथमिक ऐप आईडी का चयन करते हैं, वेब डोमेन निर्दिष्ट करते हैं और सफल लॉगिन के बाद रीडायरेक्ट के लिए URL सूचीबद्ध करते हैं। ध्यान रखें कि आप केवल 10 रिटर्न URL दर्ज कर सकते हैं:



सहेजने के लिए, सहेजें, जारी रखें और रजिस्टर पर क्लिक करें। हां, किसी भी कॉन्फ़िगरेशन परिवर्तन के लिए, आपको तीनों बटन पर क्लिक करना होगा, अन्यथा परिवर्तन प्रभावी नहीं होंगे।

अब, सेवा आईडी सूची में, बनाए गए पहचानकर्ता का चयन करें और फिर साइन इन ऐप्पल फ़ील्ड में फिर से संपादित करें पर क्लिक करें। खुलने वाली विंडो में, वेब एड्रेस फ़ील्ड के बगल में, हम दो नए बटन देखते हैं:



यह फ़ाइल आपके संसाधन को सत्यापित करने के लिए Apple के लिए आवश्यक है। इसे डाउनलोड करें और अपने संसाधन पर रखें। इसके तुरंत बाद, इस फिंट ने हमारे लिए काम नहीं किया: जब हमारे व्यवस्थापक ने फ़ाइल को जोड़ा, तब किसी अन्य स्थान पर पड़ी फ़ाइल पर रीडायरेक्ट (302) निर्दिष्ट url पर काम करता था, और Apple ने इसे सत्यापित नहीं किया था। तब मुझे URL (200) द्वारा सीधे एक्सेस के लिए फाइल रखनी थी। Apple द्वारा फ़ाइल की सफलतापूर्वक जाँच करने के बाद, डोमेन रोशनी के आगे एक हरे रंग का चेकमार्क:



पहचानकर्ता अनुभाग से, कुंजी अनुभाग पर जाएं और एक नई कुंजी बनाएं। ऐसा करने के लिए, ऐप्पल चेकबॉक्स के साथ साइन इन की जाँच करें और ऐप आईडी की जाँच करने के लिए पहले कॉन्फ़िगर करें पर क्लिक करें, फिर जारी रखें:



अगली स्क्रीन पर, कुंजी के साथ फ़ाइल डाउनलोड करना सुनिश्चित करें और इसे एक सुरक्षित स्थान पर सहेजें, क्योंकि इस स्क्रीन को छोड़ने के बाद कुंजी डाउनलोड के लिए उपलब्ध नहीं होगी। उसी पृष्ठ पर आप कुंजी आईडी देख सकते हैं, जिसकी हमें अभी भी आवश्यकता है:



साइन इन करें Apple में उपयोगकर्ताओं के लिए एक बोनस है: यह आपको एक नकली ई-मेल प्रदान करने की अनुमति देता है, जिस पर आप केवल विश्वसनीय पते से लिख सकते हैं। इस मामले में, अतिरिक्त कॉन्फ़िगरेशन की आवश्यकता है। अधिक अनुभाग खोलें, Apple अनुभाग के साथ साइन इन कॉन्फ़िगर करें पर क्लिक करें और अपना URL दर्ज करें:

IOS ऐप के साथ साइन इन ऐप बटन को जोड़ें।

CIAN तीन प्लेटफॉर्म पर काम करता है: iOS, Android, Web। IOS के लिए एक देशी एसडीके है, इसलिए प्राधिकरण इस तरह दिखाई देगा:



IOS एप्लिकेशन में Apple के साथ साइन इन करने के लिए, ASAuthorizationAppleIDButton बटन जोड़ें और उस पर क्लिक हैंडलर लटकाएं:

let appleIDProvider = ASAuthorizationAppleIDProvider() let request = appleIDProvider.createRequest() request.requestedScopes = [.fullName, .email] let authorizationController = ASAuthorizationController(authorizationRequests: [request]) authorizationController.delegate = self authorizationController.presentationContextProvider = self authorizationController.performRequests() 

ASAuthorizationAppleIDProvider के अलावा, ASAuthorizationPasswordProvider पर ध्यान दें, जो आपको किचेन से "लॉगिन-पासवर्ड" का एक गुच्छा प्राप्त करने की अनुमति देता है।

अब हम ASAuthorizationControllerPresentationContextProviding को लागू करते हैं:

 func presentationAnchor(for controller: ASAuthorizationController) -> ASPresentationAnchor {    return self.view.window! } 

ASAuthorizationControllerDelegate प्रतिनिधि बनाएं जो सफलता या त्रुटि की रिपोर्ट करता है:

 public func authorizationController( controller: ASAuthorizationController, didCompleteWithAuthorization authorization: ASAuthorization ) { guard let appleIDCredential = authorization.credential as? ASAuthorizationAppleIDCredential, let code = appleIDCredential.authorizationCode, let codeStr = String(data: code, encoding: .utf8) else {        // -            //           return } let email = appleIDCredential.email let firstName = appleIDCredential.fullName?.givenName let lastName = appleIDCredential.fullName?.familyName //           codeStr } public func authorizationController( controller: ASAuthorizationController, didCompleteWithError error: Error ) { //   } 

हम सर्वर को प्राप्त प्राधिकरण भेजते हैं और हमारे सिस्टम में प्राधिकरण की सफलता के बारे में बैकएंड से प्रतिक्रिया की प्रतीक्षा करते हैं।

हम वेब और Android के लिए Apple के साथ साइन इन को कार्यान्वित करते हैं

अचानक, Android और वेब के लिए, Apple एक SDK प्रदान नहीं करता है, इसलिए दोनों मामलों में आपको Apple प्राधिकरण पृष्ठ खोलने की आवश्यकता है और प्रक्रिया अलग होगी:



लॉगिन पृष्ठ का URL इस प्रकार है:

 https://appleid.apple.com/auth/authorize?\ state=abvgd&\ response_type=code&\ client_id=ServiceID&\ scope=email+name&\ response_mode=form_post&\ redirect_uri=https%3A%2F%2Fcian.ru%2Fauth%2Fsome-callback%2F%3Ftype%3Dappleid 

इसके मापदंडों पर विचार करें:

• client_id - सेवा आईडी जो ऊपर दर्ज की गई थी।
  
• redirect_uri - URI जहां उपयोगकर्ता AppleID के माध्यम से सफल प्रमाणीकरण के बाद पुनर्निर्देशित होता है। हमने Apple डेवलपर सेट करते समय इस URI को ऊपर निर्दिष्ट किया था।
  
• राज्य - उपयोगकर्ता का सत्र पहचानकर्ता जिसे पुनर्निर्देशित करने पर Apple वापस आएगा, ताकि हम प्रेषक की जांच कर सकें। आप इस पैरामीटर को स्वयं उत्पन्न करने के लिए एक नियम का आविष्कार कर सकते हैं, उदाहरण के लिए, एक यादृच्छिक स्ट्रिंग।
  
• गुंजाइश - यह पैरामीटर इंगित करता है कि उपयोगकर्ता से क्या जानकारी की आवश्यकता है। उदाहरण के लिए, नाम, ईमेल, या दोनों, जैसा कि ऊपर दिए गए उदाहरण में है।
  
• response_type - यह पैरामीटर इंगित करता है कि किस रूप में प्रतिक्रिया की आवश्यकता है। यह कोड या id_token हो सकता है। यदि आप id_token का चयन करते हैं, तो आपको उसे response_mode पैरामीटर के साथ निर्दिष्ट करना होगा, जिसमें आप क्वेरी, टुकड़ा और form_post निर्दिष्ट कर सकते हैं।
  

AppleID के माध्यम से दो-कारक प्रमाणीकरण सफल होने के बाद, Apple निर्दिष्ट पुनर्निर्देशन को कॉल करेगा और राज्य और कोड पैरामीटर पारित करेगा:

 curl -X POST \ 'https://www.cian.ru/some-callback/?type=appleid' \ -H 'Content-Type: application/x-www-form-urlencoded' \ --data ' \ state=abvgd&\ code=12345&\ user={"name":{"firstName":"Tanya","lastName":"Sviridova"},"email":"someemail@gmail.com"}' 

कोड पैरामीटर में, एक बार उपयोगकर्ता प्रमाणीकरण कोड पारित किया जाता है, जो 5 मिनट के लिए मान्य होता है। राज्य पैरामीटर में, सत्र पहचानकर्ता भेजा गया था जब प्राधिकरण फ़ॉर्म बनाया गया था, और उपयोगकर्ता पैरामीटर, उपयोगकर्ता डेटा में।

डेटा पुनर्प्राप्ति

सभी ग्राहकों पर, उपयोगकर्ता डेटा को बचाने के लिए, आपको Apple से access_token प्राप्त करना होगा। ऐसा करने के लिए, पहले प्राधिकरण_कोड का अनुरोध करें:

 curl -X POST https://appleid.apple.com/auth/token -d '\ client_id=some_client_id&\ code=12345&\ client_secret=jwt_part1.jwt_part2.jwt_part3&\ grant_type=authorization_code' 

इस अनुरोध में:

• client_id वेब एप्लिकेशन और iOS एप्लिकेशन के लिए AppID के लिए बनाई गई ServiceID को इंगित करता है।
  
• कोड - हमें iOS क्लाइंट से रीडायरेक्ट या ट्रांसफर के बाद उच्चतर प्राप्त हुआ
  
• अनुदान_प्रकार पैरामीटर में, हम टोकन प्राप्त करने के उद्देश्य से गुजरते हैं: प्राधिकरण (प्राधिकरण_कोड) या टोकन का नवीनीकरण (रिफ्रेश_टोकन)
  
• client_secret पैरामीटर में - JSON वेब टोकन आवेदन पंजीकरण के दौरान प्राप्त गुप्त कुंजी के आधार पर।
  

आप पायथन में JSON वेब कैम बना सकते हैं:

 claims = { 'iss': APPLEID_TEAM_ID, 'aud': 'https://appleid.apple.com', 'sub': client_id, 'iat': current_timestamp, 'exp': current_timestamp + expire_period, } headers = {'kid': 'APPLEID_KEY_ID', 'alg': 'ES256'} client_secret = jwt.encode(payload=claims, key=secret_key, algorithm='ES256', headers=headers).decode('utf-8') 

यदि सब कुछ ठीक रहा, तो निम्नलिखित पैरामीटर प्रतिक्रिया में आएंगे:

 {  "access_token":"ufhzch",  "token_type":"Bearer",  "expires_in":3600,  "refresh_token":"some_refresh_token",  "id_token":"some_long_signed_jwt_token" } 

हुर्रे, यहाँ access_token है। इसके साथ ही रिफ्रेश_टोकन आता है, जिसे आवश्यक होने पर अपडेट किया जा सकता है।

उपयोगकर्ता जानकारी id_token फ़ील्ड में संग्रहीत की जाती है, लेकिन इसे डीकोड करना होगा:

 public_key = jwt.algorithms.RSAAlgorithm.from_jwk(    json.dumps(apple_public_key) ) data = jwt.decode(    id_token,    public_key,    algorithm="RS256",    verify=True,    audience=client_id, ) 

Apple_public_key एक सार्वजनिक कुंजी है जिसे लिंक से प्राप्त किया जा सकता है ।

डिकोडिंग के बाद हमें मिलता है:

 data = {  "iss": "https://appleid.apple.com",  "aud": client_id,  "exp": 1570379521,  "iat": 1570378921,  "sub": "  ",  "at_hash": "8ZDF6j786IQf9mA",  "email": "someemail@gmail.com",  "email_verified": "true",  "auth_time": 1570378804 } 

ईमेल केवल एक बार प्रेषित किया जाता है जब उपयोगकर्ता पहली बार आपकी सेवा में साइन इन एप्पल के साथ लॉग इन करता है। अगली बार, Apple इस डेटा को केवल तभी स्थानांतरित करेगा जब उपयोगकर्ता आपके आवेदन को अपने दम पर बंद कर देगा। Apple का यह प्राधिकरण अन्य सेवाओं से भिन्न है जहां डेटा एपीआई के माध्यम से प्राप्त किया जा सकता है, और हमें यह जानकारी नहीं मिली कि वे इसके बाद से कुछ लागू करने की योजना बना रहे हैं।

इस उत्तर में, हमें उन मापदंडों के उप की आवश्यकता होती है, जो हर बार और ईमेल से प्रसारित होती है, इसलिए हम उन्हें अपने सिस्टम में सहेजते हैं और क्लाइंट को सफल प्राधिकरण के बारे में सूचित करते हैं। लाभ।

पहला परिणाम

एप्पल के साथ साइन इन के साथ CIAN के नए संस्करण की रिलीज़ के बाद, दिन के पहले दिन यह iOS 13 के लिए नए पंजीकरणों के एक तिहाई के लिए जिम्मेदार था, और अब यह iOS के सभी संस्करणों के लिए दूसरा स्थान लेता है, केवल VK के लिए दूसरा। AppleID का उपयोग करके साइट पर कुछ पंजीकरण हैं, लेकिन उनकी संख्या धीरे-धीरे बढ़ रही है। और अब हमारे पास Android एप्लिकेशन पर AppleID के माध्यम से प्राधिकरण को सक्षम करने की योजना है, और देखें कि कितने उपयोगकर्ता इस तरह के मुश्किल तरीके से पंजीकरण करेंगे।