java.lang.Object | |
↳ | org.springframework.security.core.token.KeyBasedPersistenceTokenService |
Basic implementation of TokenService
that is compatible with clusters and across machine restarts,
without requiring database persistence.
Keys are produced in the format:
Base64(creationTime + ":" + hex(pseudoRandomNumber) + ":" + extendedInformation + ":" + Sha512Hex(creationTime + ":" + hex(pseudoRandomNumber) + ":" + extendedInformation + ":" + serverSecret) )
In the above, creationTime
, tokenKey
and extendedInformation
are equal to that stored in Token
. The Sha512Hex
includes the same payload,
plus a serverSecret
.
The serverSecret
varies every millisecond. It relies on two static server-side secrets. The first
is a password, and the second is a server integer. Both of these must remain the same for any issued keys
to subsequently be recognised. The applicable serverSecret
in any millisecond is computed by
password
+ ":" + (creationTime
% serverInteger
). This approach
further obfuscates the actual server secret and renders attempts to compute the server secret more
limited in usefulness (as any false tokens would be forced to have a creationTime
equal
to the computed hash). Recall that framework features depending on token services should reject tokens
that are relatively old in any event.
A further consideration of this class is the requirement for cryptographically strong pseudo-random numbers.
To this end, the use of SecureRandomFactoryBean
is recommended to inject the property.
This implementation uses UTF-8 encoding internally for string manipulation.
Public Constructors | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Public Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Forces the allocation of a new
Token . | |||||||||||
Permits verification the <
getKey() was issued by this TokenService and
reconstructs the corresponding Token . |
[Expand]
Inherited Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
From class
java.lang.Object
| |||||||||||
From interface
org.springframework.beans.factory.InitializingBean
| |||||||||||
From interface
org.springframework.security.core.token.TokenService
|
Forces the allocation of a new Token
.
extendedInformation | the extended information desired in the token
(cannot be null , but can be empty) |
---|
verifyToken(String)
at any future time.
pseudoRandomNumberBits | changes the number of bits issued (must be >= 0; defaults to 256) |
---|
serverSecret | the new secret, which can contain a ":" if desired (never being sent to the client) |
---|