Quản lý phiên người dùng

Các phiên Xác thực Firebase tồn tại trong thời gian dài. Mỗi khi người dùng đăng nhập, thông tin đăng nhập của người dùng sẽ được gửi đến phần phụ trợ Xác thực Firebase và được đổi lấy mã thông báo mã nhận dạng Firebase (JWT) và mã làm mới. Mã thông báo mã nhận dạng Firebase chỉ tồn tại trong thời gian ngắn và tồn tại trong một giờ; mã làm mới có thể được dùng để truy xuất mã thông báo mã nhận dạng mới. Mã làm mới chỉ hết hạn khi một trong các trường hợp sau xảy ra:

• Người dùng đã bị xoá
• Người dùng bị vô hiệu hoá
• Đã phát hiện thấy sự thay đổi lớn về tài khoản đối với người dùng. Thông tin này bao gồm các sự kiện như thông tin cập nhật về mật khẩu hoặc địa chỉ email.

SDK quản trị của Firebase cho phép thu hồi mã làm mới đối với người dùng đã chỉ định. Ngoài ra, chúng tôi cũng cung cấp một API để kiểm tra việc thu hồi mã thông báo giá trị nhận dạng. Với các chức năng này, bạn có nhiều quyền kiểm soát hơn đối với các phiên hoạt động của người dùng. SDK này cho phép thêm các quy tắc hạn chế để ngăn việc sử dụng các phiên trong trường hợp đáng ngờ, cũng như cơ chế khôi phục khỏi nguy cơ bị đánh cắp mã thông báo.

Thu hồi mã làm mới

Bạn có thể thu hồi mã làm mới hiện có của người dùng khi người dùng báo cáo thiết bị bị mất hoặc bị lấy cắp. Tương tự, nếu phát hiện một lỗ hổng bảo mật chung hoặc nghi ngờ có sự cố rò rỉ mã thông báo đang hoạt động trên diện rộng, bạn có thể sử dụng API listUsers để tra cứu tất cả người dùng và thu hồi mã thông báo của họ đối với dự án đã chỉ định.

Việc đặt lại mật khẩu cũng sẽ thu hồi các mã thông báo hiện có của người dùng. Tuy nhiên, phần phụ trợ Xác thực của Firebase sẽ tự động xử lý việc thu hồi trong trường hợp đó. Khi thu hồi, người dùng sẽ đăng xuất và được nhắc xác thực lại.

Dưới đây là một ví dụ về cách triển khai sử dụng SDK dành cho quản trị viên để thu hồi mã làm mới của một người dùng cụ thể. Để khởi chạy SDK dành cho quản trị viên, hãy làm theo hướng dẫn trên trang thiết lập.

Node.js

// 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}`);
  });

Java

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);

Python

# 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))

Tiến hành

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)
auth.go

C#

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

Phát hiện việc thu hồi mã thông báo giá trị nhận dạng

Vì mã thông báo mã nhận dạng Firebase là JWT không có trạng thái, nên bạn có thể xác định rằng mã thông báo đã bị thu hồi chỉ bằng cách yêu cầu trạng thái của mã thông báo từ phần phụ trợ của tính năng Xác thực Firebase. Vì lý do này, việc thực hiện quy trình kiểm tra này trên máy chủ của bạn là một thao tác tiêu tốn nhiều tài nguyên, đòi hỏi bạn phải sử dụng thêm một lượt khứ hồi mạng. Bạn có thể tránh việc đưa ra yêu cầu mạng này bằng cách thiết lập Quy tắc bảo mật của Firebase để kiểm tra việc thu hồi thay vì sử dụng SDK dành cho quản trị viên để kiểm tra.

Phát hiện việc thu hồi mã thông báo mã nhận dạng trong Quy tắc bảo mật của Firebase

Để có thể phát hiện việc thu hồi mã thông báo giá trị nhận dạng bằng Quy tắc bảo mật, trước tiên, chúng tôi phải lưu trữ một số siêu dữ liệu dành riêng cho người dùng.

Cập nhật siêu dữ liệu theo từng người dùng trong Cơ sở dữ liệu theo thời gian thực của Firebase.

Lưu dấu thời gian thu hồi mã thông báo làm mới. Việc này là cần thiết để theo dõi việc thu hồi mã thông báo mã nhận dạng thông qua Quy tắc bảo mật của Firebase. Điều này cho phép kiểm tra hiệu quả trong cơ sở dữ liệu. Trong các mã mẫu bên dưới, hãy dùng uid và thời gian thu hồi thu được ở phần trước.

Node.js

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

Java

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

Python

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

Thêm chế độ kiểm tra vào Quy tắc bảo mật của Firebase

Để thực thi quy trình kiểm tra này, hãy thiết lập một quy tắc không có quyền ghi ứng dụng để lưu trữ thời gian thu hồi trên mỗi người dùng. Bạn có thể cập nhật giá trị này bằng dấu thời gian UTC của thời gian thu hồi gần nhất như trong các ví dụ trước:

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

Mọi dữ liệu yêu cầu quyền truy cập đã xác thực đều phải được định cấu hình quy tắc sau. Logic này chỉ cho phép người dùng đã xác thực có mã thông báo mã nhận dạng chưa được thu hồi truy cập vào dữ liệu được bảo vệ:

{
  "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()
        )",
      }
    }
  }
}

Phát hiện việc thu hồi mã thông báo mã nhận dạng trong SDK.

Trong máy chủ của bạn, hãy triển khai logic sau để thu hồi mã làm mới và xác thực mã thông báo mã nhận dạng:

Khi mã thông báo giá trị nhận dạng của người dùng được xác minh, cờ boolean checkRevoked bổ sung phải được truyền cho verifyIdToken. Nếu mã thông báo của người dùng bị thu hồi, người dùng sẽ phải đăng xuất trên ứng dụng hoặc được yêu cầu xác thực lại bằng cách sử dụng API xác thực lại do SDK ứng dụng xác thực Firebase cung cấp.

Để khởi chạy SDK dành cho quản trị viên cho nền tảng của bạn, hãy làm theo hướng dẫn trên trang thiết lập. Ví dụ về cách truy xuất mã thông báo mã nhận dạng có trong phần verifyIdToken.

Node.js

// 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.
    }
  });

Java

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.
  }
}

Python

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

Tiến hành

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)
auth.go

C#

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.
    }
}
FirebaseAuthSnippets.cs

Phản hồi yêu cầu thu hồi mã thông báo trên ứng dụng

Nếu mã thông báo bị thu hồi thông qua SDK quản trị, thì ứng dụng sẽ nhận được thông báo về việc thu hồi và người dùng cần xác thực lại hoặc đăng xuất:

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.
    });
}

Bảo mật nâng cao: Thực thi các quy định hạn chế về địa chỉ IP

Một cơ chế bảo mật phổ biến để phát hiện hành vi đánh cắp mã thông báo là theo dõi nguồn gốc của địa chỉ IP của yêu cầu. Ví dụ: nếu các yêu cầu luôn đến từ cùng một địa chỉ IP (máy chủ thực hiện lệnh gọi), thì hệ thống có thể thực thi các phiên địa chỉ IP duy nhất. Hoặc bạn có thể thu hồi mã thông báo của người dùng nếu phát hiện thấy địa chỉ IP của người dùng đột ngột thay đổi vị trí địa lý hoặc bạn nhận được yêu cầu từ một nguồn đáng ngờ.

Để thực hiện các quy trình kiểm tra bảo mật dựa trên địa chỉ IP, đối với mọi yêu cầu đã xác thực, hãy kiểm tra mã thông báo mã nhận dạng và kiểm tra xem địa chỉ IP của yêu cầu có khớp với địa chỉ IP đáng tin cậy trước đó hoặc nằm trong phạm vi đáng tin cậy trước khi cho phép truy cập vào dữ liệu bị hạn chế. Ví dụ:

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!' })
      });
    }
  });
});