उपयोगकर्ता सत्र प्रबंधित करें

फायरबेस प्रमाणीकरण सत्र लंबे समय तक चलते हैं। जब भी कोई उपयोगकर्ता साइन इन करता है, तो उपयोगकर्ता क्रेडेंशियल्स को फायरबेस प्रमाणीकरण बैकएंड पर भेजा जाता है और फायरबेस आईडी टोकन (एक जेडब्ल्यूटी) और रीफ्रेश टोकन के लिए एक्सचेंज किया जाता है। फायरबेस आईडी टोकन अल्पकालिक होते हैं और एक घंटे तक चलते हैं; ताज़ा टोकन का उपयोग नए आईडी टोकन पुनः प्राप्त करने के लिए किया जा सकता है। रिफ्रेश टोकन केवल तभी समाप्त होते हैं जब निम्न में से कोई एक होता है:

  • उपयोगकर्ता हटा दिया गया है
  • उपयोगकर्ता अक्षम है
  • उपयोगकर्ता के लिए एक प्रमुख खाता परिवर्तन का पता चला है। इसमें पासवर्ड या ईमेल एड्रेस अपडेट जैसी घटनाएं शामिल हैं।

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

ताज़ा टोकन निरस्त करें

जब कोई उपयोगकर्ता किसी खोए हुए या चोरी हुए डिवाइस की रिपोर्ट करता है तो आप उपयोगकर्ता के मौजूदा रीफ्रेश टोकन को रद्द कर सकते हैं। इसी तरह, यदि आपको कोई सामान्य भेद्यता का पता चलता है या सक्रिय टोकन के व्यापक पैमाने पर रिसाव का संदेह है, तो आप सभी उपयोगकर्ताओं को देखने और निर्दिष्ट प्रोजेक्ट के लिए उनके टोकन रद्द करने के लिए listUsers API का उपयोग कर सकते हैं।

पासवर्ड रीसेट उपयोगकर्ता के मौजूदा टोकन को भी रद्द कर देता है; हालाँकि, फायरबेस प्रमाणीकरण बैकएंड उस स्थिति में निरस्तीकरण को स्वचालित रूप से संभालता है। निरस्तीकरण पर, उपयोगकर्ता को साइन आउट कर दिया जाता है और पुनः प्रमाणित करने के लिए कहा जाता है।

यहां एक उदाहरण कार्यान्वयन है जो किसी दिए गए उपयोगकर्ता के रीफ्रेश टोकन को रद्द करने के लिए एडमिन एसडीके का उपयोग करता है। एडमिन एसडीके को आरंभ करने के लिए सेटअप पृष्ठ पर दिए गए निर्देशों का पालन करें।

नोड.जे.एस

// Revoke all refresh tokens for a specified user for whatever reason.
// Retrieve the timestamp of the revocation, in seconds since the epoch.
getAuth()
  .revokeRefreshTokens(uid)
  .then(() => {
    return getAuth().getUser(uid);
  })
  .then((userRecord) => {
    return new Date(userRecord.tokensValidAfterTime).getTime() / 1000;
  })
  .then((timestamp) => {
    console.log(`Tokens revoked at: ${timestamp}`);
  });

जावा

FirebaseAuth.getInstance().revokeRefreshTokens(uid);
UserRecord user = FirebaseAuth.getInstance().getUser(uid);
// Convert to seconds as the auth_time in the token claims is in seconds too.
long revocationSecond = user.getTokensValidAfterTimestamp() / 1000;
System.out.println("Tokens revoked at: " + revocationSecond);

अजगर

# Revoke tokens on the backend.
auth.revoke_refresh_tokens(uid)
user = auth.get_user(uid)
# Convert to seconds as the auth_time in the token claims is in seconds.
revocation_second = user.tokens_valid_after_timestamp / 1000
print('Tokens revoked at: {0}'.format(revocation_second))

जाना

client, err := app.Auth(ctx)
if err != nil {
	log.Fatalf("error getting Auth client: %v\n", err)
}
if err := client.RevokeRefreshTokens(ctx, uid); err != nil {
	log.Fatalf("error revoking tokens for user: %v, %v\n", uid, err)
}
// accessing the user's TokenValidAfter
u, err := client.GetUser(ctx, uid)
if err != nil {
	log.Fatalf("error getting user %s: %v\n", uid, err)
}
timestamp := u.TokensValidAfterMillis / 1000
log.Printf("the refresh tokens were revoked at: %d (UTC seconds) ", timestamp)

सी#

await FirebaseAuth.DefaultInstance.RevokeRefreshTokensAsync(uid);
var user = await FirebaseAuth.DefaultInstance.GetUserAsync(uid);
Console.WriteLine("Tokens revoked at: " + user.TokensValidAfterTimestamp);

आईडी टोकन निरस्तीकरण का पता लगाएं

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

फायरबेस सुरक्षा नियमों में आईडी टोकन निरस्तीकरण का पता लगाएं

सुरक्षा नियमों का उपयोग करके आईडी टोकन निरस्तीकरण का पता लगाने में सक्षम होने के लिए, हमें पहले कुछ उपयोगकर्ता-विशिष्ट मेटाडेटा संग्रहीत करना होगा।

फायरबेस रीयलटाइम डेटाबेस में उपयोगकर्ता-विशिष्ट मेटाडेटा अपडेट करें।

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

नोड.जे.एस

const metadataRef = getDatabase().ref('metadata/' + uid);
metadataRef.set({ revokeTime: utcRevocationTimeSecs }).then(() => {
  console.log('Database updated successfully.');
});

जावा

DatabaseReference ref = FirebaseDatabase.getInstance().getReference("metadata/" + uid);
Map<String, Object> userData = new HashMap<>();
userData.put("revokeTime", revocationSecond);
ref.setValueAsync(userData);

अजगर

metadata_ref = firebase_admin.db.reference("metadata/" + uid)
metadata_ref.set({'revokeTime': revocation_second})

फायरबेस सुरक्षा नियमों में एक चेक जोड़ें

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

{
  "rules": {
    "metadata": {
      "$user_id": {
        // this could be false as it is only accessed from backend or rules.
        ".read": "$user_id === auth.uid",
        ".write": "false",
      }
    }
  }
}

किसी भी डेटा जिसके लिए प्रमाणित पहुंच की आवश्यकता होती है, उसमें निम्नलिखित नियम कॉन्फ़िगर होना चाहिए। यह तर्क केवल अप्रमाणित आईडी टोकन वाले प्रमाणित उपयोगकर्ताओं को संरक्षित डेटा तक पहुंचने की अनुमति देता है:

{
  "rules": {
    "users": {
      "$user_id": {
        ".read": "auth != null && $user_id === auth.uid && (
            !root.child('metadata').child(auth.uid).child('revokeTime').exists()
          || auth.token.auth_time > root.child('metadata').child(auth.uid).child('revokeTime').val()
        )",
        ".write": "auth != null && $user_id === auth.uid && (
            !root.child('metadata').child(auth.uid).child('revokeTime').exists()
          || auth.token.auth_time > root.child('metadata').child(auth.uid).child('revokeTime').val()
        )",
      }
    }
  }
}

एसडीके में आईडी टोकन निरस्तीकरण का पता लगाएं।

अपने सर्वर में, ताज़ा टोकन निरस्तीकरण और आईडी टोकन सत्यापन के लिए निम्नलिखित तर्क लागू करें:

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

अपने प्लेटफ़ॉर्म के लिए एडमिन एसडीके प्रारंभ करने के लिए, सेटअप पृष्ठ पर दिए गए निर्देशों का पालन करें। आईडी टोकन पुनर्प्राप्त करने के उदाहरण verifyIdToken अनुभाग में हैं।

नोड.जे.एस

// Verify the ID token while checking if the token is revoked by passing
// checkRevoked true.
let checkRevoked = true;
getAuth()
  .verifyIdToken(idToken, checkRevoked)
  .then((payload) => {
    // Token is valid.
  })
  .catch((error) => {
    if (error.code == 'auth/id-token-revoked') {
      // Token has been revoked. Inform the user to reauthenticate or signOut() the user.
    } else {
      // Token is invalid.
    }
  });

जावा

try {
  // Verify the ID token while checking if the token is revoked by passing checkRevoked
  // as true.
  boolean checkRevoked = true;
  FirebaseToken decodedToken = FirebaseAuth.getInstance()
      .verifyIdToken(idToken, checkRevoked);
  // Token is valid and not revoked.
  String uid = decodedToken.getUid();
} catch (FirebaseAuthException e) {
  if (e.getAuthErrorCode() == AuthErrorCode.REVOKED_ID_TOKEN) {
    // Token has been revoked. Inform the user to re-authenticate or signOut() the user.
  } else {
    // Token is invalid.
  }
}

अजगर

try:
    # Verify the ID token while checking if the token is revoked by
    # passing check_revoked=True.
    decoded_token = auth.verify_id_token(id_token, check_revoked=True)
    # Token is valid and not revoked.
    uid = decoded_token['uid']
except auth.RevokedIdTokenError:
    # Token revoked, inform the user to reauthenticate or signOut().
    pass
except auth.UserDisabledError:
    # Token belongs to a disabled user record.
    pass
except auth.InvalidIdTokenError:
    # Token is invalid
    pass

जाना

client, err := app.Auth(ctx)
if err != nil {
	log.Fatalf("error getting Auth client: %v\n", err)
}
token, err := client.VerifyIDTokenAndCheckRevoked(ctx, idToken)
if err != nil {
	if err.Error() == "ID token has been revoked" {
		// Token is revoked. Inform the user to reauthenticate or signOut() the user.
	} else {
		// Token is invalid
	}
}
log.Printf("Verified ID token: %v\n", token)

सी#

try
{
    // Verify the ID token while checking if the token is revoked by passing checkRevoked
    // as true.
    bool checkRevoked = true;
    var decodedToken = await FirebaseAuth.DefaultInstance.VerifyIdTokenAsync(
        idToken, checkRevoked);
    // Token is valid and not revoked.
    string uid = decodedToken.Uid;
}
catch (FirebaseAuthException ex)
{
    if (ex.AuthErrorCode == AuthErrorCode.RevokedIdToken)
    {
        // Token has been revoked. Inform the user to re-authenticate or signOut() the user.
    }
    else
    {
        // Token is invalid.
    }
}

क्लाइंट पर टोकन निरस्तीकरण का जवाब दें

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

function onIdTokenRevocation() {
  // For an email/password user. Prompt the user for the password again.
  let password = prompt('Please provide your password for reauthentication');
  let credential = firebase.auth.EmailAuthProvider.credential(
      firebase.auth().currentUser.email, password);
  firebase.auth().currentUser.reauthenticateWithCredential(credential)
    .then(result => {
      // User successfully reauthenticated. New ID tokens should be valid.
    })
    .catch(error => {
      // An error occurred.
    });
}

उन्नत सुरक्षा: आईपी पता प्रतिबंध लागू करें

टोकन चोरी का पता लगाने के लिए एक सामान्य सुरक्षा तंत्र अनुरोध आईपी पते की उत्पत्ति पर नज़र रखना है। उदाहरण के लिए, यदि अनुरोध हमेशा एक ही आईपी पते (कॉल करने वाले सर्वर) से आ रहे हैं, तो एकल आईपी पता सत्र लागू किया जा सकता है। या, यदि आपको पता चलता है कि उपयोगकर्ता का आईपी पता अचानक जियोलोकेशन बदल गया है या आपको किसी संदिग्ध स्रोत से अनुरोध प्राप्त होता है, तो आप उपयोगकर्ता का टोकन रद्द कर सकते हैं।

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

app.post('/getRestrictedData', (req, res) => {
  // Get the ID token passed.
  const idToken = req.body.idToken;
  // Verify the ID token, check if revoked and decode its payload.
  admin.auth().verifyIdToken(idToken, true).then((claims) => {
    // Get the user's previous IP addresses, previously saved.
    return getPreviousUserIpAddresses(claims.sub);
  }).then(previousIpAddresses => {
    // Get the request IP address.
    const requestIpAddress = req.connection.remoteAddress;
    // Check if the request IP address origin is suspicious relative to previous
    // IP addresses. The current request timestamp and the auth_time of the ID
    // token can provide additional signals of abuse especially if the IP address
    // suddenly changed. If there was a sudden location change in a
    // short period of time, then it will give stronger signals of possible abuse.
    if (!isValidIpAddress(previousIpAddresses, requestIpAddress)) {
      // Invalid IP address, take action quickly and revoke all user's refresh tokens.
      revokeUserTokens(claims.uid).then(() => {
        res.status(401).send({error: 'Unauthorized access. Please login again!'});
      }, error => {
        res.status(401).send({error: 'Unauthorized access. Please login again!'});
      });
    } else {
      // Access is valid. Try to return data.
      getData(claims).then(data => {
        res.end(JSON.stringify(data);
      }, error => {
        res.status(500).send({ error: 'Server error!' })
      });
    }
  });
});