उपयोगकर्ताओं को उनके Apple ID का इस्तेमाल करके, Firebase से पुष्टि करने की अनुमति दी जा सकती है. इसके लिए, Firebase SDK टूल का इस्तेमाल करके, OAuth 2.0 के साइन-इन फ़्लो को शुरू से आखिर तक पूरा करना होगा.
शुरू करने से पहले
Apple का इस्तेमाल करके उपयोगकर्ताओं को साइन इन कराने के लिए, पहले Apple की डेवलपर साइट पर जाकर, Sign In with Apple को कॉन्फ़िगर करें. इसके बाद, अपने Firebase प्रोजेक्ट के लिए, Apple को साइन-इन की सुविधा देने वाली कंपनी के तौर पर चालू करें.
Apple Developer Program में शामिल होना
Sign In with Apple को सिर्फ़ Apple Developer Program के सदस्य कॉन्फ़िगर कर सकते हैं.
'Apple से साइन इन करें' सुविधा को कॉन्फ़िगर करना
- Apple की डेवलपर साइट के Certificates, Identifiers & Profiles पेज पर जाकर, अपने ऐप्लिकेशन के लिए Sign In with Apple की सुविधा चालू करें.
- अपनी वेबसाइट को अपने ऐप्लिकेशन से जोड़ें. इसके बारे में वेब के लिए, Sign In with Apple को कॉन्फ़िगर करें के पहले सेक्शन में बताया गया है. जब कहा जाए, तब इस यूआरएल को रिटर्न यूआरएल के तौर पर रजिस्टर करें:
आपको Firebase कंसोल सेटिंग पेज पर, अपने Firebase प्रोजेक्ट का आईडी मिल सकता है. इसके बाद, अपना नया सेवा आईडी नोट करें. आपको अगले सेक्शन में इसकी ज़रूरत पड़ेगी.https://YOUR_FIREBASE_PROJECT_ID.firebaseapp.com/__/auth/handler
- 'Apple से साइन इन करें' सुविधा के लिए निजी पासकोड बनाएं. अगले सेक्शन में, आपको अपने नए निजी पासकोड और पासकोड आईडी की ज़रूरत होगी.
- अगर Firebase Authentication की ऐसी किसी सुविधा का इस्तेमाल किया जाता है जो उपयोगकर्ताओं को ईमेल भेजती है, तो Apple की निजी ईमेल रिले सेवा को कॉन्फ़िगर करें और
noreply@YOUR_FIREBASE_PROJECT_ID.firebaseapp.com(या अपनी पसंद के मुताबिक बनाए गए ईमेल टेंप्लेट डोमेन) को रजिस्टर करें. इससे Apple, Firebase Authentication से भेजे गए ईमेल को Apple के उन ईमेल पतों पर रिले कर सकता है जिनकी पहचान ज़ाहिर नहीं की गई है. इन सुविधाओं में, ईमेल लिंक से साइन-इन करना, ईमेल पते की पुष्टि करना, खाते में किए गए बदलाव को रद्द करना वगैरह शामिल है.
साइन-इन की सुविधा देने वाली कंपनी के तौर पर Apple को चालू करना
- अपने Apple प्रोजेक्ट में Firebase जोड़ें. Firebase कंसोल में अपना ऐप्लिकेशन सेट अप करते समय, अपने ऐप्लिकेशन का बंडल आईडी ज़रूर रजिस्टर करें.
- Firebase कंसोल में, सुरक्षा > पुष्टि करना पर जाएं.
- साइन-इन का तरीका टैब में, Apple से साइन-इन करने की सुविधा देने वाली कंपनी को चालू करें. पिछले सेक्शन में बनाए गए सर्विस आईडी की जानकारी दें. साथ ही, OAuth कोड फ़्लो कॉन्फ़िगरेशन सेक्शन में, अपना Apple टीम आईडी और निजी पासकोड और कुंजी आईडी डालें, जिसे आपने पिछले सेक्शन में बनाया था.
Apple की पहचान छिपाकर रखे गए डेटा से जुड़ी ज़रूरी शर्तों का पालन करना
Sign In with Apple की सुविधा, उपयोगकर्ताओं को साइन इन करते समय अपने डेटा को छिपाने का विकल्प देती है. इसमें उनका ईमेल पता भी शामिल है. इस विकल्प को चुनने वाले उपयोगकर्ताओं के ईमेल पतों में, डोमेन के तौर पर privaterelay.appleid.com शामिल होता है. अपने ऐप्लिकेशन में Sign In with Apple का इस्तेमाल करने पर, आपको Apple की डेवलपर नीतियों या शर्तों का पालन करना होगा. ये नीतियां या शर्तें, Apple ID की पहचान छिपाने से जुड़ी होती हैं.
इसमें, सीधे तौर पर पहचान ज़ाहिर करने वाली किसी भी निजी जानकारी को Apple आईडी से जोड़ने से पहले, उपयोगकर्ता की ज़रूरी सहमति लेना शामिल है. Firebase से पुष्टि करने की सुविधा का इस्तेमाल करने पर, ये कार्रवाइयां की जा सकती हैं:
- किसी ईमेल पते को ऐसे Apple ID से लिंक करना जिससे उपयोगकर्ता की पहचान छिपी रहती है या इसके उलट.
- किसी फ़ोन नंबर को पहचान छिपाने वाले Apple ID से लिंक करना या पहचान छिपाने वाले Apple ID को किसी फ़ोन नंबर से लिंक करना
- Facebook, Google वगैरह जैसे किसी ऐसे सोशल क्रेडेंशियल को Apple ID से लिंक करना जिसमें पहचान छिपाई गई हो या इसके उलट.
ऊपर दी गई सूची पूरी नहीं है. अपने डेवलपर खाते के सदस्यता सेक्शन में जाकर, Apple Developer Program के लाइसेंस देने के लिए कानूनी समझौता देखें. इससे यह पक्का किया जा सकेगा कि आपका ऐप्लिकेशन, Apple की ज़रूरी शर्तों को पूरा करता है.
Apple से साइन इन करना और Firebase की मदद से पुष्टि करना
Apple खाते से पुष्टि करने के लिए, सबसे पहले Apple के AuthenticationServices फ़्रेमवर्क का इस्तेमाल करके, उपयोगकर्ता को उसके Apple खाते में साइन इन कराएं. इसके बाद, Apple के रिस्पॉन्स से मिले आईडी टोकन का इस्तेमाल करके, Firebase AuthCredential ऑब्जेक्ट बनाएं:
साइन-इन के हर अनुरोध के लिए, एक रैंडम स्ट्रिंग जनरेट करें. इसे "नॉन्स" कहते हैं. इसका इस्तेमाल करके, यह पक्का किया जा सकता है कि आपको मिला आईडी टोकन, खास तौर पर आपके ऐप्लिकेशन के पुष्टि करने के अनुरोध के जवाब में दिया गया था. रीप्ले अटैक से बचने के लिए, यह चरण ज़रूरी है.
SecRandomCopyBytes(_:_:_)की मदद से, क्रिप्टोग्राफ़िक तरीके से सुरक्षित नॉन्स जनरेट किया जा सकता है. इसका उदाहरण यहां दिया गया है:Swift
private func randomNonceString(length: Int = 32) -> String { precondition(length > 0) var randomBytes = [UInt8](repeating: 0, count: length) let errorCode = SecRandomCopyBytes(kSecRandomDefault, randomBytes.count, &randomBytes) if errorCode != errSecSuccess { fatalError( "Unable to generate nonce. SecRandomCopyBytes failed with OSStatus \(errorCode)" ) } let charset: [Character] = Array("0123456789ABCDEFGHIJKLMNOPQRSTUVXYZabcdefghijklmnopqrstuvwxyz-._") let nonce = randomBytes.map { byte in // Pick a random character from the set, wrapping around if needed. charset[Int(byte) % charset.count] } return String(nonce) }
Objective-C
// Adapted from https://auth0.com/docs/api-auth/tutorials/nonce#generate-a-cryptographically-random-nonce - (NSString *)randomNonce:(NSInteger)length { NSAssert(length > 0, @"Expected nonce to have positive length"); NSString *characterSet = @"0123456789ABCDEFGHIJKLMNOPQRSTUVXYZabcdefghijklmnopqrstuvwxyz-._"; NSMutableString *result = [NSMutableString string]; NSInteger remainingLength = length; while (remainingLength > 0) { NSMutableArray *randoms = [NSMutableArray arrayWithCapacity:16]; for (NSInteger i = 0; i < 16; i++) { uint8_t random = 0; int errorCode = SecRandomCopyBytes(kSecRandomDefault, 1, &random); NSAssert(errorCode == errSecSuccess, @"Unable to generate nonce: OSStatus %i", errorCode); [randoms addObject:@(random)]; } for (NSNumber *random in randoms) { if (remainingLength == 0) { break; } if (random.unsignedIntValue < characterSet.length) { unichar character = [characterSet characterAtIndex:random.unsignedIntValue]; [result appendFormat:@"%C", character]; remainingLength--; } } } return [result copy]; }
आपको साइन-इन के अनुरोध के साथ, नॉन्स का SHA256 हैश भेजना होगा. Apple इसे बिना किसी बदलाव के रिस्पॉन्स में पास कर देगा. Firebase, ओरिजनल नॉन्स को हैश करके और Apple से मिली वैल्यू से उसकी तुलना करके, जवाब की पुष्टि करता है.
Swift
@available(iOS 13, *) private func sha256(_ input: String) -> String { let inputData = Data(input.utf8) let hashedData = SHA256.hash(data: inputData) let hashString = hashedData.compactMap { String(format: "%02x", $0) }.joined() return hashString }
Objective-C
- (NSString *)stringBySha256HashingString:(NSString *)input { const char *string = [input UTF8String]; unsigned char result[CC_SHA256_DIGEST_LENGTH]; CC_SHA256(string, (CC_LONG)strlen(string), result); NSMutableString *hashed = [NSMutableString stringWithCapacity:CC_SHA256_DIGEST_LENGTH * 2]; for (NSInteger i = 0; i < CC_SHA256_DIGEST_LENGTH; i++) { [hashed appendFormat:@"%02x", result[i]]; } return hashed; }
Apple का साइन-इन फ़्लो शुरू करें. इसमें, अपने अनुरोध में नॉन्स का SHA256 हैश और Apple के जवाब को मैनेज करने वाली डेलिगेट क्लास शामिल करें (अगला चरण देखें):
Swift
import CryptoKit // Unhashed nonce. fileprivate var currentNonce: String? @available(iOS 13, *) func startSignInWithAppleFlow() { let nonce = randomNonceString() currentNonce = nonce let appleIDProvider = ASAuthorizationAppleIDProvider() let request = appleIDProvider.createRequest() request.requestedScopes = [.fullName, .email] request.nonce = sha256(nonce) let authorizationController = ASAuthorizationController(authorizationRequests: [request]) authorizationController.delegate = self authorizationController.presentationContextProvider = self authorizationController.performRequests() }Objective-C
@import CommonCrypto; - (void)startSignInWithAppleFlow { NSString *nonce = [self randomNonce:32]; self.currentNonce = nonce; ASAuthorizationAppleIDProvider *appleIDProvider = [[ASAuthorizationAppleIDProvider alloc] init]; ASAuthorizationAppleIDRequest *request = [appleIDProvider createRequest]; request.requestedScopes = @[ASAuthorizationScopeFullName, ASAuthorizationScopeEmail]; request.nonce = [self stringBySha256HashingString:nonce]; ASAuthorizationController *authorizationController = [[ASAuthorizationController alloc] initWithAuthorizationRequests:@[request]]; authorizationController.delegate = self; authorizationController.presentationContextProvider = self; [authorizationController performRequests]; }ASAuthorizationControllerDelegateको लागू करते समय, Apple के जवाब को मैनेज करना. अगर साइन-इन हो गया है, तो Firebase से पुष्टि करने के लिए, Apple के जवाब में मौजूद आईडी टोकन का इस्तेमाल करें. इसके लिए, अनहैश किए गए नॉन्स का इस्तेमाल करें:Swift
@available(iOS 13.0, *) extension MainViewController: ASAuthorizationControllerDelegate { func authorizationController(controller: ASAuthorizationController, didCompleteWithAuthorization authorization: ASAuthorization) { if let appleIDCredential = authorization.credential as? ASAuthorizationAppleIDCredential { guard let nonce = currentNonce else { fatalError("Invalid state: A login callback was received, but no login request was sent.") } guard let appleIDToken = appleIDCredential.identityToken else { print("Unable to fetch identity token") return } guard let idTokenString = String(data: appleIDToken, encoding: .utf8) else { print("Unable to serialize token string from data: \(appleIDToken.debugDescription)") return } // Initialize a Firebase credential, including the user's full name. let credential = OAuthProvider.appleCredential(withIDToken: idTokenString, rawNonce: nonce, fullName: appleIDCredential.fullName) // Sign in with Firebase. Auth.auth().signIn(with: credential) { (authResult, error) in if error { // Error. If error.code == .MissingOrInvalidNonce, make sure // you're sending the SHA256-hashed nonce as a hex string with // your request to Apple. print(error.localizedDescription) return } // User is signed in to Firebase with Apple. // ... } } } func authorizationController(controller: ASAuthorizationController, didCompleteWithError error: Error) { // Handle error. print("Sign in with Apple errored: \(error)") } }Objective-C
- (void)authorizationController:(ASAuthorizationController *)controller didCompleteWithAuthorization:(ASAuthorization *)authorization API_AVAILABLE(ios(13.0)) { if ([authorization.credential isKindOfClass:[ASAuthorizationAppleIDCredential class]]) { ASAuthorizationAppleIDCredential *appleIDCredential = authorization.credential; NSString *rawNonce = self.currentNonce; NSAssert(rawNonce != nil, @"Invalid state: A login callback was received, but no login request was sent."); if (appleIDCredential.identityToken == nil) { NSLog(@"Unable to fetch identity token."); return; } NSString *idToken = [[NSString alloc] initWithData:appleIDCredential.identityToken encoding:NSUTF8StringEncoding]; if (idToken == nil) { NSLog(@"Unable to serialize id token from data: %@", appleIDCredential.identityToken); } // Initialize a Firebase credential, including the user's full name. FIROAuthCredential *credential = [FIROAuthProvider appleCredentialWithIDToken:IDToken rawNonce:self.appleRawNonce fullName:appleIDCredential.fullName]; // Sign in with Firebase. [[FIRAuth auth] signInWithCredential:credential completion:^(FIRAuthDataResult * _Nullable authResult, NSError * _Nullable error) { if (error != nil) { // Error. If error.code == FIRAuthErrorCodeMissingOrInvalidNonce, // make sure you're sending the SHA256-hashed nonce as a hex string // with your request to Apple. return; } // Sign-in succeeded! }]; } } - (void)authorizationController:(ASAuthorizationController *)controller didCompleteWithError:(NSError *)error API_AVAILABLE(ios(13.0)) { NSLog(@"Sign in with Apple errored: %@", error); }
Firebase Auth के साथ काम करने वाली अन्य कंपनियों के उलट, Apple कोई फ़ोटो यूआरएल उपलब्ध नहीं कराता.
इसके अलावा, जब उपयोगकर्ता ऐप्लिकेशन के साथ अपना ईमेल पता शेयर नहीं करने का विकल्प चुनता है, तो Apple उस उपयोगकर्ता के लिए एक यूनीक ईमेल पता (xyz@privaterelay.appleid.com फ़ॉर्मैट में) उपलब्ध कराता है. इसे आपके ऐप्लिकेशन के साथ शेयर किया जाता है. अगर आपने निजी ईमेल रिले सेवा को कॉन्फ़िगर किया है, तो Apple, उपयोगकर्ता के असली ईमेल पते पर, पहचान छिपाने वाले पते पर भेजे गए ईमेल फ़ॉरवर्ड करता है.
फिर से पुष्टि करना और खाता लिंक करना
इसी पैटर्न का इस्तेमाल reauthenticateWithCredential() के साथ किया जा सकता है. इसका इस्तेमाल करके, संवेदनशील कार्रवाइयों के लिए नया क्रेडेंशियल वापस पाया जा सकता है. इसके लिए, हाल ही में साइन-इन करना ज़रूरी है:
Swift
// Initialize a fresh Apple credential with Firebase.
let credential = OAuthProvider.credential(
withProviderID: "apple.com",
IDToken: appleIdToken,
rawNonce: rawNonce
)
// Reauthenticate current Apple user with fresh Apple credential.
Auth.auth().currentUser.reauthenticate(with: credential) { (authResult, error) in
guard error != nil else { return }
// Apple user successfully re-authenticated.
// ...
}
Objective-C
FIRAuthCredential *credential = [FIROAuthProvider credentialWithProviderID:@"apple.com",
IDToken:appleIdToken,
rawNonce:rawNonce];
[[FIRAuth auth].currentUser
reauthenticateWithCredential:credential
completion:^(FIRAuthDataResult * _Nullable authResult,
NSError * _Nullable error) {
if (error) {
// Handle error.
}
// Apple user successfully re-authenticated.
// ...
}];
साथ ही, linkWithCredential() का इस्तेमाल करके, मौजूदा खातों को अलग-अलग आइडेंटिटी प्रोवाइडर से लिंक किया जा सकता है.
ध्यान दें कि Apple के मुताबिक, उपयोगकर्ताओं के Apple खातों को अन्य डेटा से लिंक करने से पहले, आपको उनकी साफ़ तौर पर सहमति लेनी होगी.
'Apple से साइन इन करें' सुविधा का इस्तेमाल करके, किसी मौजूदा खाते को लिंक करने के लिए, पुष्टि करने वाले क्रेडेंशियल का फिर से इस्तेमाल नहीं किया जा सकता. अगर आपको Sign in with Apple क्रेडेंशियल को किसी दूसरे खाते से लिंक करना है, तो आपको पहले पुराने Sign in with Apple क्रेडेंशियल का इस्तेमाल करके खातों को लिंक करने की कोशिश करनी होगी. इसके बाद, गड़बड़ी का पता लगाकर नया क्रेडेंशियल ढूंढना होगा.
नया क्रेडेंशियल, गड़बड़ी की userInfo डिक्शनरी में मौजूद होगा. इसे AuthErrorUserInfoUpdatedCredentialKey कुंजी का इस्तेमाल करके ऐक्सेस किया जा सकता है.
उदाहरण के लिए, किसी Facebook खाते को मौजूदा Firebase खाते से लिंक करने के लिए, उस ऐक्सेस टोकन का इस्तेमाल करें जो आपको उपयोगकर्ता को Facebook में साइन इन करने पर मिला था:
Swift
// Initialize a Facebook credential with Firebase.
let credential = FacebookAuthProvider.credential(
withAccessToken: AccessToken.current!.tokenString
)
// Assuming the current user is an Apple user linking a Facebook provider.
Auth.auth().currentUser.link(with: credential) { (authResult, error) in
// Facebook credential is linked to the current Apple user.
// The user can now sign in with Facebook or Apple to the same Firebase
// account.
// ...
}
Objective-C
// Initialize a Facebook credential with Firebase.
FacebookAuthCredential *credential = [FIRFacebookAuthProvider credentialWithAccessToken:accessToken];
// Assuming the current user is an Apple user linking a Facebook provider.
[FIRAuth.auth linkWithCredential:credential completion:^(FIRAuthDataResult * _Nullable authResult, NSError * _Nullable error) {
// Facebook credential is linked to the current Apple user.
// The user can now sign in with Facebook or Apple to the same Firebase
// account.
// ...
}];
टोकन रद्द करना
Apple की ज़रूरी शर्तों के मुताबिक, खाता बनाने की सुविधा देने वाले ऐप्लिकेशन में उपयोगकर्ताओं को अपना खाता मिटाने की सुविधा भी देनी होगी. इस बारे में App Store की समीक्षा से जुड़े दिशा-निर्देशों में बताया गया है
इस ज़रूरी शर्त को पूरा करने के लिए, यह तरीका अपनाएं:
पक्का करें कि आपने 'Apple से साइन इन करें' की सेवा देने वाली कंपनी के कॉन्फ़िगरेशन के Services ID और OAuth कोड फ़्लो कॉन्फ़िगरेशन सेक्शन को भरा हो. इसके बारे में 'Apple से साइन इन करें' को कॉन्फ़िगर करें सेक्शन में बताया गया है.
Sign in with Apple की मदद से उपयोगकर्ता बनाए जाने पर, Firebase उपयोगकर्ता के टोकन सेव नहीं करता. इसलिए, टोकन रद्द करने और खाता मिटाने से पहले, आपको उपयोगकर्ता से फिर से साइन इन करने के लिए कहना होगा.
Swift
private var currentNonce: String? private func deleteCurrentUser() { do { let nonce = try CryptoUtils.randomNonceString() currentNonce = nonce let appleIDProvider = ASAuthorizationAppleIDProvider() let request = appleIDProvider.createRequest() request.requestedScopes = [.fullName, .email] request.nonce = CryptoUtils.sha256(nonce) let authorizationController = ASAuthorizationController(authorizationRequests: [request]) authorizationController.delegate = self authorizationController.presentationContextProvider = self authorizationController.performRequests() } catch { // In the unlikely case that nonce generation fails, show error view. displayError(error) } }
ASAuthorizationAppleIDCredentialसे ऑथराइज़ेशन कोड पाएं और उपयोगकर्ता के टोकन रद्द करने के लिए,Auth.auth().revokeToken(withAuthorizationCode:)को कॉल करें.Swift
private var user: User? func authorizationController(controller: ASAuthorizationController, didCompleteWithAuthorization authorization: ASAuthorization) { guard let appleIDCredential = authorization.credential as? ASAuthorizationAppleIDCredential else { print("Unable to retrieve AppleIDCredential") return } guard let _ = currentNonce else { fatalError("Invalid state: A login callback was received, but no login request was sent.") } guard let appleAuthCode = appleIDCredential.authorizationCode else { print("Unable to fetch authorization code") return } guard let authCodeString = String(data: appleAuthCode, encoding: .utf8) else { print("Unable to serialize auth code string from data: \(appleAuthCode.debugDescription)") return } Task { do { try await Auth.auth().revokeToken(withAuthorizationCode: authCodeString) try await user?.delete() self.updateUI() } catch { self.displayError(error) } } }
आखिर में, उपयोगकर्ता खाता और उससे जुड़ा सारा डेटा मिटाएं
अगले चरण
जब कोई उपयोगकर्ता पहली बार साइन इन करता है, तो एक नया उपयोगकर्ता खाता बन जाता है. साथ ही, यह खाता उन क्रेडेंशियल से लिंक हो जाता है जिनका इस्तेमाल करके उपयोगकर्ता ने साइन इन किया है. जैसे, उपयोगकर्ता नाम और पासवर्ड, फ़ोन नंबर या पुष्टि करने वाली सेवा की जानकारी. यह नया खाता आपके Firebase प्रोजेक्ट के हिस्से के तौर पर सेव किया जाता है. इसका इस्तेमाल, आपके प्रोजेक्ट के हर ऐप्लिकेशन में किसी उपयोगकर्ता की पहचान करने के लिए किया जा सकता है. इससे कोई फ़र्क़ नहीं पड़ता कि उपयोगकर्ता ने कैसे साइन इन किया है.
-
अपने ऐप्लिकेशन में, उपयोगकर्ता की प्रोफ़ाइल की बुनियादी जानकारी पाने के लिए,
Userऑब्जेक्ट का इस्तेमाल किया जा सकता है. उपयोगकर्ताओं को मैनेज करना देखें. Firebase Realtime Database और Cloud Storage सुरक्षा नियमों में, साइन इन किए हुए उपयोगकर्ता का यूनीक यूज़र आईडी,
authवैरिएबल से पाया जा सकता है. साथ ही, इसका इस्तेमाल करके यह कंट्रोल किया जा सकता है कि उपयोगकर्ता कौनसा डेटा ऐक्सेस कर सकता है.
पुष्टि करने वाली सेवा देने वाली कंपनी के क्रेडेंशियल को किसी मौजूदा उपयोगकर्ता खाते से लिंक करके, उपयोगकर्ताओं को पुष्टि करने वाली सेवा देने वाली कई कंपनियों का इस्तेमाल करके आपके ऐप्लिकेशन में साइन इन करने की अनुमति दी जा सकती है.
किसी उपयोगकर्ता को साइन आउट करने के लिए,
signOut: को कॉल करें.
Swift
let firebaseAuth = Auth.auth() do { try firebaseAuth.signOut() } catch let signOutError as NSError { print("Error signing out: %@", signOutError) }
Objective-C
NSError *signOutError; BOOL status = [[FIRAuth auth] signOut:&signOutError]; if (!status) { NSLog(@"Error signing out: %@", signOutError); return; }
पुष्टि करने से जुड़ी सभी गड़बड़ियों के लिए, गड़बड़ी को मैनेज करने वाला कोड भी जोड़ा जा सकता है. गड़बड़ियां ठीक करना देखें.