Package wsgitools :: Module digest :: Class MemoryNonceStore

Class MemoryNonceStore

Simple in-memory mechanism to store nonces.

>>> s = MemoryNonceStore(maxuses=1)
>>> n = s.newnonce()
>>> s.checknonce("spam")
False
>>> s.checknonce(n)
True
>>> s.checknonce(n)
False

Instance Methods

__init__(self, maxage=300, maxuses=5)

source code

_cleanup(self)
internal methods cleaning list of valid nonces

source code

str

newnonce(self, ident=None)
Generates a new nonce string.

source code

bool

checknonce(self, nonce, count=1, ident=None)
Do a check for whether the provided string is a nonce and increase usage count on returning True.

source code

Method Details

Parameters:

maxage (int) - is the number of seconds a nonce may be valid. Choosing a large value may result in more memory usage whereas a smaller value results in more requests. Defaults to 5 minutes.
maxuses (int) - is the number of times a nonce may be used (with different nc values). A value of 1 makes nonces usable exactly once resulting in more requests. Defaults to 5.

Generates a new nonce string.

Parameters:

Returns: str

Overrides: NonceStoreBase.newnonce

Do a check for whether the provided string is a nonce and increase usage count on returning True.

Parameters:

count (int) - indicates how often the nonce has been used (including this check)
ident (None or str) - it is also checked that the nonce was associated to this identifier when given
nonce (str)

Returns: bool

Overrides: NonceStoreBase.checknonce