अगर आपने Identity Platform के साथ Firebase से पुष्टि करने की सुविधा पर अपग्रेड किया है, तो आपके पास अपने iOS ऐप्लिकेशन में एसएमएस के लिए बहु-स्तरीय पुष्टि (MFA) की सुविधा जोड़ने का विकल्प है.
बहु-स्तरीय पुष्टि (MFA) की सुविधा से आपके ऐप्लिकेशन की सुरक्षा बढ़ जाती है. हालांकि, हमलावर अक्सर पासवर्ड और सोशल मीडिया खातों के साथ छेड़छाड़ करते हैं, लेकिन टेक्स्ट मैसेज को रोकना ज़्यादा मुश्किल होता है.
शुरू करने से पहले
बहु-स्तरीय पुष्टि (MFA) की सुविधा देने वाली कम से कम एक कंपनी चालू करें. फ़ोन से पुष्टि, पहचान छिपाकर पुष्टि करने, और Apple Game Center के अलावा, हर कंपनी MFA के साथ काम करती है.
पक्का करें कि आपका ऐप्लिकेशन, उपयोगकर्ता के ईमेल की पुष्टि कर रहा है. MFA के लिए ईमेल पते की पुष्टि करना ज़रूरी है. यह नुकसान पहुंचाने वाले लोगों को किसी ऐसे ईमेल से रजिस्टर करने से रोकता है जिसका मालिकाना हक उनके पास नहीं है. साथ ही, दूसरा तरीका जोड़कर, वे असली मालिक को लॉक कर सकते हैं.
बहु-स्तरीय पुष्टि (MFA) की सुविधा चालू करना
Firebase कंसोल का पुष्टि करने > साइन इन करने का तरीका पेज खोलें.
बेहतर सेक्शन में, एसएमएस के लिए बहु-स्तरीय पुष्टि (MFA) चालू करें.
आपको वे फ़ोन नंबर भी डालने चाहिए, जिनसे आप अपने ऐप्लिकेशन का परीक्षण करना चाहते हैं. हालांकि, यह ज़रूरी नहीं है, लेकिन डेवलपमेंट के दौरान थ्रॉटलिंग से बचने के लिए टेस्ट फ़ोन नंबरों को रजिस्टर करने का सुझाव दिया जाता है.
अगर आपने पहले से अपने ऐप्लिकेशन के डोमेन को अनुमति नहीं दी है, तो उसे Firebase कंसोल के पुष्टि करने > सेटिंग पेज पर जाकर, अनुमति वाली सूची में जोड़ें.
अपने ऐप्लिकेशन की पुष्टि करना
Firebase को इस बात की पुष्टि करनी होगी कि एसएमएस के अनुरोध आपके ऐप्लिकेशन से आ रहे हैं. आप दो तरीकों से ऐसा कर सकते हैं:
साइलेंट एपीएन सूचनाएं: जब किसी उपयोगकर्ता में पहली बार साइन इन किया जाता है, तो Firebase उपयोगकर्ता के डिवाइस पर साइलेंट पुश नोटिफ़िकेशन भेज सकता है. ऐप्लिकेशन को सूचना मिलने पर पुष्टि की जा सकती है. ध्यान दें कि iOS 8.0 और इसके बाद के वर्शन में, इस तरीके का इस्तेमाल करने के लिए आपको उपयोगकर्ता से पुश नोटिफ़िकेशन भेजने की अनुमति देने की ज़रूरत नहीं है.
re कैप्चा की पुष्टि करना: अगर आप बिना आवाज़ के सूचना नहीं भेज पा रहे हैं (जैसे, जब उपयोगकर्ता ने बैकग्राउंड रीफ़्रेश की सुविधा बंद कर दी हो या iOS सिम्युलेटर में अपने ऐप्लिकेशन की जांच की जा रही हो), तो आप reCAPTCHA का इस्तेमाल कर सकते हैं. कई मामलों में, re कैप्चा अपने-आप उपयोगकर्ता के इंटरैक्शन के बिना ही हल हो जाएगा.
सूचनाओं के लिए आवाज़ बंद होने की सुविधा इस्तेमाल करना
Firebase के साथ इस्तेमाल करने से जुड़ी एपीएन की सूचनाएं पाने की सुविधा चालू करने के लिए:
Xcode में, अपने प्रोजेक्ट के लिए पुश नोटिफ़िकेशन चालू करें.
Firebase कंसोल का इस्तेमाल करके, अपने एपीएन की पुष्टि करने वाली कुंजी अपलोड करें (आपके किए गए बदलाव, Google Cloud Firebase पर अपने-आप लागू हो जाएंगे). अगर आपके पास पहले से अपनी एपीएन पुष्टि करने वाली कुंजी नहीं है, तो उसे पाने का तरीका जानने के लिए FCM के साथ एपीएन कॉन्फ़िगर करना देखें.
Firebase कंसोल खोलें.
प्रोजेक्ट सेटिंग पर जाएं.
क्लाउड से मैसेज टैब चुनें.
APNs पुष्टि कुंजी के तहत, iOS ऐप्लिकेशन कॉन्फ़िगरेशन सेक्शन में, अपलोड करें पर क्लिक करें.
अपनी कुंजी चुनें.
कुंजी के लिए कुंजी आईडी जोड़ें. कुंजी के आईडी को Apple Developer Member Center में सर्टिफ़िकेट, आइडेंटिफ़ायर, और प्रोफ़ाइलें में देखा जा सकता है.
अपलोड करें पर क्लिक करें.
अगर आपके पास पहले से कोई एपीएन सर्टिफ़िकेट है, तो सर्टिफ़िकेट को अपलोड करें.
reCAPTCHA की मदद से पुष्टि करना
क्लाइंट SDK टूल को reCAPTCHA का इस्तेमाल करने की अनुमति देने के लिए:
अपने प्रोजेक्ट कॉन्फ़िगरेशन को Xcode में खोलें.
बाएं ट्री व्यू में, प्रोजेक्ट के नाम पर दो बार क्लिक करें.
टारगेट सेक्शन से अपना ऐप्लिकेशन चुनें.
जानकारी टैब चुनें.
यूआरएल टाइप सेक्शन को बड़ा करें.
+ बटन पर क्लिक करें.
यूआरएल स्कीम फ़ील्ड में, अपना रिवर्स क्लाइंट आईडी डालें. यह वैल्यू,
GoogleService-Info.plist
कॉन्फ़िगरेशन फ़ाइल मेंREVERSED_CLIENT_ID
के तौर पर देखी जा सकती है.
पूरा होने के बाद, आपका कॉन्फ़िगरेशन कुछ ऐसा दिखना चाहिए:
इसके अलावा, reCAPTCHA दिखाते समय अपने ऐप्लिकेशन के SFSafariViewController
या UIWebView
दिखाने का तरीका अपनी पसंद के मुताबिक बनाया जा सकता है. ऐसा करने के लिए, FIRAuthUIDelegate
प्रोटोकॉल के मुताबिक एक कस्टम क्लास बनाएं और उसे verifyPhoneNumber:UIDelegate:completion:
को पास करें.
रजिस्ट्रेशन का पैटर्न चुनना
आपके पास यह चुनने का विकल्प है कि आपके ऐप्लिकेशन के लिए बहु-स्तरीय पुष्टि (MFA) की ज़रूरत है या नहीं. साथ ही, यह भी चुनें कि आपके उपयोगकर्ताओं को कैसे और कब रजिस्टर करना है. कुछ सामान्य पैटर्न में ये शामिल हैं:
रजिस्ट्रेशन के हिस्से के तौर पर, उपयोगकर्ता के दूसरे चरण को रजिस्टर करें. अगर आपके ऐप्लिकेशन को सभी उपयोगकर्ताओं के लिए बहु-स्तरीय पुष्टि (MFA) की ज़रूरत है, तो इस तरीके का इस्तेमाल करें. ध्यान दें कि दूसरे तरीके को रजिस्टर करने के लिए, आपके खाते में ऐसा ईमेल पता होना चाहिए जिसकी पुष्टि हो चुकी हो. इसलिए, आपके रजिस्ट्रेशन फ़्लो में यह जानकारी शामिल की जानी चाहिए.
रजिस्ट्रेशन के दौरान दूसरा चरण जोड़ने का विकल्प दें, जिसे स्किप किया जा सके. ऐसे ऐप्लिकेशन जो बहु-स्तरीय पुष्टि (MFA) के लिए बढ़ावा देना चाहते हैं, लेकिन ऐसा करना ज़रूरी नहीं है, वे इस तरीके को प्राथमिकता दे सकते हैं.
लोगों को साइन अप स्क्रीन के बजाय, उनके खाते या प्रोफ़ाइल मैनेजमेंट पेज पर जाकर दूसरा चरण जोड़ने की सुविधा दें. इससे रजिस्ट्रेशन की प्रक्रिया के दौरान आने वाली दिक्कतों को कम किया जाता है. साथ ही, सुरक्षा के लिए संवेदनशील उपयोगकर्ताओं के लिए बहु-स्तरीय पुष्टि (MFA) की सुविधा उपलब्ध कराई जाती है.
जब उपयोगकर्ता बढ़ी हुई सुरक्षा ज़रूरतों वाली सुविधाओं को ऐक्सेस करना चाहता है, तो दूसरे चरण को बढ़ाना ज़रूरी होता है.
पुष्टि करने का दूसरा चरण रजिस्टर करना
किसी उपयोगकर्ता के लिए कोई नया सेकंडरी फ़ैक्टर रजिस्टर करने के लिए:
उपयोगकर्ता की फिर से पुष्टि करें.
उपयोगकर्ता से उसका फ़ोन नंबर डालने के लिए कहें.
उपयोगकर्ता के लिए एक से ज़्यादा तरीकों वाला सेशन पाएं:
Swift
authResult.user.multiFactor.getSessionWithCompletion() { (session, error) in // ... }
Objective-C
[authResult.user.multiFactor getSessionWithCompletion:^(FIRMultiFactorSession * _Nullable session, NSError * _Nullable error) { // ... }];
उपयोगकर्ता के फ़ोन पर पुष्टि करने के लिए एक मैसेज भेजें. पक्का करें कि फ़ोन नंबर को पहले
+
से फ़ॉर्मैट किया गया हो. साथ ही, उसमें कोई और विराम चिह्न या खाली सफ़ेद जगह न हो (जैसे:+15105551234
)Swift
// Send SMS verification code. PhoneAuthProvider.provider().verifyPhoneNumber( phoneNumber, uiDelegate: nil, multiFactorSession: session) { (verificationId, error) in // verificationId will be needed for enrollment completion. }
Objective-C
// Send SMS verification code. [FIRPhoneAuthProvider.provider verifyPhoneNumber:phoneNumber UIDelegate:nil multiFactorSession:session completion:^(NSString * _Nullable verificationID, NSError * _Nullable error) { // verificationId will be needed for enrollment completion. }];
हालांकि ऐसा करना ज़रूरी नहीं है, लेकिन सबसे सही तरीका यह है कि आप उपयोगकर्ताओं को पहले ही यह बता दें कि उन्हें एसएमएस मिलेगा और सामान्य दरें लागू होंगी.
verifyPhoneNumber()
तरीका, साइलेंट पुश नोटिफ़िकेशन का इस्तेमाल करके बैकग्राउंड में ऐप्लिकेशन की पुष्टि करने की प्रक्रिया शुरू करता है. अगर साइलेंट पुश नोटिफ़िकेशन उपलब्ध नहीं है,तो reCAPTCHA चैलेंज जारी किया जाता है.एसएमएस कोड भेजने के बाद, उपयोगकर्ता से कोड की पुष्टि करने के लिए कहें. इसके बाद,
PhoneAuthCredential
बनाने के लिए उनके जवाब का इस्तेमाल करें:Swift
// Ask user for the verification code. Then: let credential = PhoneAuthProvider.provider().credential( withVerificationID: verificationId, verificationCode: verificationCode)
Objective-C
// Ask user for the SMS verification code. Then: FIRPhoneAuthCredential *credential = [FIRPhoneAuthProvider.provider credentialWithVerificationID:verificationID verificationCode:kPhoneSecondFactorVerificationCode];
दावा ऑब्जेक्ट शुरू करें:
Swift
let assertion = PhoneMultiFactorGenerator.assertion(with: credential)
Objective-C
FIRMultiFactorAssertion *assertion = [FIRPhoneMultiFactorGenerator assertionWithCredential:credential];
रजिस्टर करने की प्रोसेस पूरी करें. इसके अलावा, आपके पास दूसरे फ़ैक्टर के लिए डिसप्ले नेम तय करने का भी विकल्प है. यह उन उपयोगकर्ताओं के लिए बहुत काम का है जिनके कई सेकंड होते हैं, क्योंकि पुष्टि करने के दौरान फ़ोन नंबर मास्क होता है (उदाहरण के लिए, +1******1234).
Swift
// Complete enrollment. This will update the underlying tokens // and trigger ID token change listener. user.multiFactor.enroll(with: assertion, displayName: displayName) { (error) in // ... }
Objective-C
// Complete enrollment. This will update the underlying tokens // and trigger ID token change listener. [authResult.user.multiFactor enrollWithAssertion:assertion displayName:nil completion:^(NSError * _Nullable error) { // ... }];
यहां दिए गए कोड में, दूसरे फ़ैक्टर को रजिस्टर करने का पूरा उदाहरण दिया गया है:
Swift
let user = Auth.auth().currentUser
user?.multiFactor.getSessionWithCompletion({ (session, error) in
// Send SMS verification code.
PhoneAuthProvider.provider().verifyPhoneNumber(
phoneNumber,
uiDelegate: nil,
multiFactorSession: session
) { (verificationId, error) in
// verificationId will be needed for enrollment completion.
// Ask user for the verification code.
let credential = PhoneAuthProvider.provider().credential(
withVerificationID: verificationId!,
verificationCode: phoneSecondFactorVerificationCode)
let assertion = PhoneMultiFactorGenerator.assertion(with: credential)
// Complete enrollment. This will update the underlying tokens
// and trigger ID token change listener.
user?.multiFactor.enroll(with: assertion, displayName: displayName) { (error) in
// ...
}
}
})
Objective-C
FIRUser *user = FIRAuth.auth.currentUser;
[user.multiFactor getSessionWithCompletion:^(FIRMultiFactorSession * _Nullable session,
NSError * _Nullable error) {
// Send SMS verification code.
[FIRPhoneAuthProvider.provider
verifyPhoneNumber:phoneNumber
UIDelegate:nil
multiFactorSession:session
completion:^(NSString * _Nullable verificationID, NSError * _Nullable error) {
// verificationId will be needed for enrollment completion.
// Ask user for the verification code.
// ...
// Then:
FIRPhoneAuthCredential *credential =
[FIRPhoneAuthProvider.provider credentialWithVerificationID:verificationID
verificationCode:kPhoneSecondFactorVerificationCode];
FIRMultiFactorAssertion *assertion =
[FIRPhoneMultiFactorGenerator assertionWithCredential:credential];
// Complete enrollment. This will update the underlying tokens
// and trigger ID token change listener.
[user.multiFactor enrollWithAssertion:assertion
displayName:displayName
completion:^(NSError * _Nullable error) {
// ...
}];
}];
}];
बधाई! आपने उपयोगकर्ता के लिए पुष्टि करने का दूसरा तरीका रजिस्टर कर लिया है.
दूसरे चरण से उपयोगकर्ताओं को साइन इन करना
दो-तरीकों से मैसेज (एसएमएस) की मदद से पुष्टि करने वाले उपयोगकर्ता को साइन इन करने के लिए:
उपयोगकर्ता को उसके पहले कारक से साइन इन करने दें, फिर यह बताने वाली गड़बड़ी को देखें कि बहु-स्तरीय पुष्टि (MFA) की ज़रूरत है. इस गड़बड़ी में एक रिज़ॉल्वर, रजिस्टर किए गए दूसरे फ़ैक्टर पर संकेत, और एक मौजूदा सेशन शामिल होता है, जो यह साबित करता है कि पहले चरण से उपयोगकर्ता की पुष्टि हो गई है.
उदाहरण के लिए, अगर उपयोगकर्ता ने सबसे पहले ईमेल और पासवर्ड पर साइन इन किया था:
Swift
Auth.auth().signIn( withEmail: email, password: password ) { (result, error) in let authError = error as NSError if authError?.code == AuthErrorCode.secondFactorRequired.rawValue { // The user is a multi-factor user. Second factor challenge is required. let resolver = authError!.userInfo[AuthErrorUserInfoMultiFactorResolverKey] as! MultiFactorResolver // ... } else { // Handle other errors such as wrong password. } }
Objective-C
[FIRAuth.auth signInWithEmail:email password:password completion:^(FIRAuthDataResult * _Nullable authResult, NSError * _Nullable error) { if (error == nil || error.code != FIRAuthErrorCodeSecondFactorRequired) { // User is not enrolled with a second factor and is successfully signed in. // ... } else { // The user is a multi-factor user. Second factor challenge is required. } }];
अगर उपयोगकर्ता का पहला फ़ैक्टर, OAuth जैसी फ़ेडरेटेड प्रोवाइडर है, तो
getCredentialWith()
को कॉल करने के बाद गड़बड़ी का पता लगाएं.अगर उपयोगकर्ता ने कई सेकंडरी फ़ैक्टर को रजिस्टर किया है, तो उससे पूछें कि किसको इस्तेमाल करना है. मास्क वाला फ़ोन नंबर
resolver.hints[selectedIndex].phoneNumber
से और डिसप्ले नेमresolver.hints[selectedIndex].displayName
से मिल सकता है.Swift
// Ask user which second factor to use. Then: if resolver.hints[selectedIndex].factorID == PhoneMultiFactorID { // User selected a phone second factor. // ... } else if resolver.hints[selectedIndex].factorID == TotpMultiFactorID { // User selected a TOTP second factor. // ... } else { // Unsupported second factor. }
Objective-C
FIRMultiFactorResolver *resolver = (FIRMultiFactorResolver *) error.userInfo[FIRAuthErrorUserInfoMultiFactorResolverKey]; // Ask user which second factor to use. Then: FIRPhoneMultiFactorInfo *hint = (FIRPhoneMultiFactorInfo *) resolver.hints[selectedIndex]; if (hint.factorID == FIRPhoneMultiFactorID) { // User selected a phone second factor. // ... } else if (hint.factorID == FIRTOTPMultiFactorID) { // User selected a TOTP second factor. // ... } else { // Unsupported second factor. }
उपयोगकर्ता के फ़ोन पर पुष्टि करने के लिए एक मैसेज भेजें:
Swift
// Send SMS verification code. let hint = resolver.hints[selectedIndex] as! PhoneMultiFactorInfo PhoneAuthProvider.provider().verifyPhoneNumber( with: hint, uiDelegate: nil, multiFactorSession: resolver.session ) { (verificationId, error) in // verificationId will be needed for sign-in completion. }
Objective-C
// Send SMS verification code [FIRPhoneAuthProvider.provider verifyPhoneNumberWithMultiFactorInfo:hint UIDelegate:nil multiFactorSession:resolver.session completion:^(NSString * _Nullable verificationID, NSError * _Nullable error) { if (error != nil) { // Failed to verify phone number. } }];
एसएमएस कोड भेजे जाने के बाद, उपयोगकर्ता से कोड की पुष्टि करने और
PhoneAuthCredential
बनाने के लिए इसका इस्तेमाल करने के लिए कहें:Swift
// Ask user for the verification code. Then: let credential = PhoneAuthProvider.provider().credential( withVerificationID: verificationId!, verificationCode: verificationCodeFromUser)
Objective-C
// Ask user for the SMS verification code. Then: FIRPhoneAuthCredential *credential = [FIRPhoneAuthProvider.provider credentialWithVerificationID:verificationID verificationCode:verificationCodeFromUser];
क्रेडेंशियल के साथ दावा ऑब्जेक्ट शुरू करें:
Swift
let assertion = PhoneMultiFactorGenerator.assertion(with: credential)
Objective-C
FIRMultiFactorAssertion *assertion = [FIRPhoneMultiFactorGenerator assertionWithCredential:credential];
साइन इन की समस्या हल करें. इसके बाद, साइन इन करने के ओरिजनल नतीजे को ऐक्सेस किया जा सकता है. इसमें, सेवा देने वाली कंपनी का खास डेटा और पुष्टि करने के क्रेडेंशियल शामिल होते हैं:
Swift
// Complete sign-in. This will also trigger the Auth state listeners. resolver.resolveSignIn(with: assertion) { (authResult, error) in // authResult will also contain the user, additionalUserInfo, optional // credential (null for email/password) associated with the first factor sign-in. // For example, if the user signed in with Google as a first factor, // authResult.additionalUserInfo will contain data related to Google provider that // the user signed in with. // user.credential contains the Google OAuth credential. // user.credential.accessToken contains the Google OAuth access token. // user.credential.idToken contains the Google OAuth ID token. }
Objective-C
// Complete sign-in. [resolver resolveSignInWithAssertion:assertion completion:^(FIRAuthDataResult * _Nullable authResult, NSError * _Nullable error) { if (error != nil) { // User successfully signed in with the second factor phone number. } }];
यहां दिया गया कोड, एक से ज़्यादा तरीकों से साइन इन करने वाले उपयोगकर्ता के लिए साइन इन करने का पूरा उदाहरण दिखाता है:
Swift
Auth.auth().signIn(
withEmail: email,
password: password
) { (result, error) in
let authError = error as NSError?
if authError?.code == AuthErrorCode.secondFactorRequired.rawValue {
let resolver =
authError!.userInfo[AuthErrorUserInfoMultiFactorResolverKey] as! MultiFactorResolver
// Ask user which second factor to use.
// ...
// Then:
let hint = resolver.hints[selectedIndex] as! PhoneMultiFactorInfo
// Send SMS verification code
PhoneAuthProvider.provider().verifyPhoneNumber(
with: hint,
uiDelegate: nil,
multiFactorSession: resolver.session
) { (verificationId, error) in
if error != nil {
// Failed to verify phone number.
}
// Ask user for the SMS verification code.
// ...
// Then:
let credential = PhoneAuthProvider.provider().credential(
withVerificationID: verificationId!,
verificationCode: verificationCodeFromUser)
let assertion = PhoneMultiFactorGenerator.assertion(with: credential)
// Complete sign-in.
resolver.resolveSignIn(with: assertion) { (authResult, error) in
if error != nil {
// User successfully signed in with the second factor phone number.
}
}
}
}
}
Objective-C
[FIRAuth.auth signInWithEmail:email
password:password
completion:^(FIRAuthDataResult * _Nullable authResult,
NSError * _Nullable error) {
if (error == nil || error.code != FIRAuthErrorCodeSecondFactorRequired) {
// User is not enrolled with a second factor and is successfully signed in.
// ...
} else {
FIRMultiFactorResolver *resolver =
(FIRMultiFactorResolver *) error.userInfo[FIRAuthErrorUserInfoMultiFactorResolverKey];
// Ask user which second factor to use.
// ...
// Then:
FIRPhoneMultiFactorInfo *hint = (FIRPhoneMultiFactorInfo *) resolver.hints[selectedIndex];
// Send SMS verification code
[FIRPhoneAuthProvider.provider
verifyPhoneNumberWithMultiFactorInfo:hint
UIDelegate:nil
multiFactorSession:resolver.session
completion:^(NSString * _Nullable verificationID,
NSError * _Nullable error) {
if (error != nil) {
// Failed to verify phone number.
}
// Ask user for the SMS verification code.
// ...
// Then:
FIRPhoneAuthCredential *credential =
[FIRPhoneAuthProvider.provider
credentialWithVerificationID:verificationID
verificationCode:kPhoneSecondFactorVerificationCode];
FIRMultiFactorAssertion *assertion =
[FIRPhoneMultiFactorGenerator assertionWithCredential:credential];
// Complete sign-in.
[resolver resolveSignInWithAssertion:assertion
completion:^(FIRAuthDataResult * _Nullable authResult,
NSError * _Nullable error) {
if (error != nil) {
// User successfully signed in with the second factor phone number.
}
}];
}];
}
}];
बधाई! आपने बहु-स्तरीय पुष्टि (MFA) की सुविधा का इस्तेमाल करके एक उपयोगकर्ता खाते में साइन इन कर लिया है.
आगे क्या करना है
- एडमिन SDK की मदद से, मल्टी-फ़ैक्टर उपयोगकर्ताओं को मैनेज करें.