Crate salvo_session

source ·
Expand description

§Salvo session support

Salvo session middleware is built on top of async-session.

An example: session-login

Sessions allows salvo to securely attach data to a browser session allowing for retrieval and modification of this data within salvo on subsequent visits. Session data is generally only retained for the duration of a browser session.


It is highly recommended that salvo applications use an external-datastore-backed session storage. For a list of currently available session stores, see the documentation for async-session.


Although each session store may have different security implications, the general approach of salvo’s session system is as follows: On each request, salvo checks the cookie configurable as cookie_name on the handler.

A cryptographically random cookie value is generated. A cookie is set on the outbound response and signed with an HKDF key derived from the secret provided on creation of the SessionHandler. The configurable session store uses a SHA256 digest of the cookie value and stores the session along with a potential expiry.

The hkdf derived signing key is used to verify the cookie value’s signature. If it verifies, it is then passed to the session store to retrieve a Session. For most session stores, this will involve taking a SHA256 digest of the cookie value and retrieving a serialized Session from an external datastore based on that digest.


In addition to setting an expiry on the session cookie, salvo sessions include the same expiry in their serialization format. If an adversary were able to tamper with the expiry of a cookie, salvo sessions would still check the expiry on the contained session before using it

§If anything goes wrong with the above process

If there are any failures in the above session retrieval process, a new empty session is generated for the request, which proceeds through the application as normal.

§Stale/expired session cleanup

Any session store other than the cookie store will accumulate stale sessions. Although the salvo session handler ensures that they will not be used as valid sessions, For most session stores, it is the salvo application’s responsibility to call cleanup on the session store if it requires it.

Read more: