Redis Keys

Last updated


This page lists every key the package writes to Redis, with TTLs and write timing, for monitoring and debugging.

Key List


KeyValueTTL
refresh:<refresh_id>RefreshData JSONrefreshTokenExpires
revoke:<access_token>"1"accessTokenExpires

Write Timing


OperationKeyTTL
CreateJWT()refresh:<id>, version: 1refreshTokenExpires
Refresh (no rotation)refresh:<id>, version + 1Reset to refreshTokenExpires
Refresh (rotation)Old refresh:<id>5 seconds
Refresh (rotation)New refresh:<id>, version: 0refreshTokenExpires
RevokeJWT()refresh:<id>5 seconds
RevokeJWT()revoke:<access_token>accessTokenExpires

Debugging Commands


  1. # List all sessions
  2. redis-cli --scan --pattern 'refresh:*'
  3. # Inspect a Refresh ID and its remaining seconds
  4. redis-cli GET 'refresh:<refresh_id>'
  5. redis-cli TTL 'refresh:<refresh_id>'
  6. # Force a session to end
  7. redis-cli DEL 'refresh:<refresh_id>'

After deleting refresh:<id>, the session can no longer refresh once its Access Token expires; an unexpired Access Token still passes verification until it expires.

Capacity


revoke: keys are named after the full Access Token, so each entry is roughly the token length (a few hundred bytes); under heavy logout volume, accessTokenExpires bounds how long they are kept.
Related: Refresh Token Rotation, Token Revocation
中文