Zarządzaj sesjami użytkowników

Sesje Firebase Authentication są długotrwałe. Za każdym razem, gdy użytkownik się loguje, jego dane logowania są wysyłane do backendu Firebase Authentication i wymieniane na token identyfikatora Firebase (token JWT) oraz token odświeżania. Tokeny identyfikatora Firebase są krótkotrwałe i trwają przez godzinę. Token odświeżania może służyć do pobierania nowych tokenów identyfikatora. Tokeny odświeżania wygasają tylko w jednej z tych sytuacji:

• Konto użytkownika zostało usunięte
• Użytkownik jest wyłączony
• wykryto dużą zmianę na koncie użytkownika; Obejmuje to zdarzenia takie jak aktualizacje hasła lub adresu e-mail.

Pakiet Firebase Admin SDK umożliwia odwoływanie tokenów odświeżania w przypadku określonego użytkownika. Udostępniliśmy też interfejs API do sprawdzania unieważnienia tokena tożsamości. Te funkcje dają większą kontrolę nad sesjami użytkowników. Pakiet SDK umożliwia dodawanie ograniczeń, które zapobiegają używaniu sesji w podejrzanych okolicznościach, a także mechanizm odzyskiwania w przypadku kradzieży tokena.

Unieważnianie tokenów odświeżania

Możesz cofnąć istniejący token odświeżania użytkownika, gdy zgłosi on zgubienie lub kradzież urządzenia. Podobnie, jeśli wykryjesz ogólną lukę w zabezpieczeniach lub podejrzewasz wyciek aktywnych tokenów na dużą skalę, możesz za pomocą interfejsu API listUsers wyszukać wszystkich użytkowników i unieważnić ich tokeny w określonym projekcie.

Resetowanie hasła powoduje również unieważnienie dotychczasowych tokenów użytkownika, ale w tym przypadku backend automatycznie przejmuje unieważnienie. Po cofnięciu unieważnienia użytkownik zostanie wylogowany i poprosi o ponowne uwierzytelnienie.

Oto przykładowa implementacja, która używa pakietu Admin SDK do odwoływania tokenu odświeżania danego użytkownika. Aby zainicjować pakiet Admin SDK, postępuj zgodnie z instrukcjami na stronie konfiguracji.

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

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

Wykrywanie unieważnienia tokena identyfikacyjnego

Ponieważ tokeny identyfikatora Firebase są bezstanowymi tokenami JWT, możesz sprawdzić, czy token został unieważniony, wysyłając do backendu Firebase Authentication prośbę o jego stan. Z tego powodu wykonanie tej kontroli na serwerze jest kosztowną operacją, która wymaga dodatkowego przesyłania danych przez sieć w obie strony. Aby uniknąć wysyłania tego żądania sieci, skonfiguruj Firebase Security Rules, które sprawdzają unieważnienie, zamiast używać pakietu Admin SDK do przeprowadzania tej weryfikacji.

Wykrywanie unieważnienia tokena tożsamości w Firebase Security Rules

Aby móc wykrywać odwołanie tokena identyfikacyjnego za pomocą reguł bezpieczeństwa, musimy najpierw przechowywać niektóre metadane dotyczące użytkownika.

Zaktualizuj metadane dotyczące użytkowników w Firebase Realtime Database.

Zapisz sygnaturę czasową unieważnienia tokena odświeżania. Jest to konieczne do śledzenia odwołania tokena identyfikacyjnego za pomocą Firebase Security Rules. Umożliwia to wydajne sprawdzanie bazy danych. W przykładach kodu poniżej użyj identyfikatora uid i czasu odwołania uzyskanych w poprzedniej sekcji.

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

Dodaj kontrolę do Firebase Security Rules

Aby wymusić to sprawdzanie, skonfiguruj regułę bez dostępu do zapisu na kliencie, aby przechowywać czas odwołania na poziomie użytkownika. Można ją zaktualizować, podając sygnaturę czasową UTC ostatniego czasu cofnięcia, jak w poprzednich przykładach:

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

W przypadku danych, które wymagają uwierzytelnionego dostępu, należy skonfigurować tę regułę: Ta logika umożliwia dostęp do chronionych danych tylko uwierzytelnionych użytkownikom z nieodwołanymi tokenami identyfikatorów:

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

Wykrywanie odwołania tokenu identyfikacji w pakiecie SDK.

Na serwerze zastosuj tę logikę odwołującą token odświeżania i weryfikującą token ID:

Jeśli ma zostać zweryfikowany token ID użytkownika, do checkRevoked należy przekazać dodatkowy parametr booleanowy checkRevoked. Jeśli token użytkownika został cofnięty, użytkownik powinien się wylogować z klienta lub zostać poproszony o ponowne uwierzytelnienie za pomocą interfejsów API ponownego uwierzytelnienia udostępnianych przez pakiety SDK klienta Firebase Authentication.

Aby zainicjować pakiet Admin SDK na swojej platformie, postępuj zgodnie z instrukcjami na stronie konfiguracji. Przykłady pobierania tokena identyfikacyjnego znajdziesz w sekcji 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)
auth.go

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

Odpowiedź na odebranie tokena na kliencie

Jeśli token zostanie cofnięty za pomocą pakietu Admin SDK, klient zostanie poinformowany o tym wycofaniu, a użytkownik będzie musiał ponownie uwierzytelnić się lub zostanie wylogowany:

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

Zaawansowane zabezpieczenia: egzekwowanie ograniczeń adresów IP

Typowym mechanizmem zabezpieczającym przed kradzieżą tokenów jest śledzenie pochodzenia adresów IP żądań. Jeśli na przykład żądania zawsze pochodzą z tego samego adresu IP (serwera wykonującego wywołanie), można wymusić sesje z jednym adresem IP. Możesz też cofnąć token użytkownika, jeśli wykryjesz, że jego adres IP nagle zmienił lokalizację geograficzną lub jeśli otrzymasz żądanie z podejrzanego źródła.

Aby przeprowadzać kontrole zabezpieczeń na podstawie adresu IP, przed przyznaniem dostępu do danych objętych ograniczeniami należy sprawdzić token identyfikacyjny każdej uwierzytelnionej prośby i sprawdzić, czy adres IP prośby jest zgodny z poprzednio zaufowanymi adresami IP lub czy mieści się w zakresie zaufanych adresów IP. Przykład:

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