Class SessionStorage

Storage singleton for internal HTTP sessions

Inheritance

object

SessionStorage

Implements

ISessionStorage

Inherited Members

object.Equals(object)

object.Equals(object, object)

object.GetHashCode()

object.GetType()

object.MemberwiseClone()

object.ReferenceEquals(object, object)

object.ToString()

Namespace: DuetWebServer.Singletons

Assembly: DuetWebServer.dll

Syntax

public class SessionStorage : ISessionStorage

Constructors

SessionStorage(ILogger<SessionStorage>)

Constructor of the session storage singleton

Declaration

public SessionStorage(ILogger<SessionStorage> logger)

Parameters

Type	Name	Description
ILogger<SessionStorage>	logger	Logger instance

Methods

CacheMessage(string)

Cache an incoming generic message

Declaration

public void CacheMessage(string message)

Parameters

Type	Name	Description
string	message	Message to cache

CheckSessionKey(string, bool)

Check if the given session key provides the requested access to the given policy

Declaration

public bool CheckSessionKey(string key, bool readWrite)

Parameters

Type	Name	Description
string	key	Session key
bool	readWrite	If readWrite or readOnly policy is requested

Returns

Type	Description
bool	True if access is granted

GetCachedMessages(ClaimsPrincipal)

Retrieve the cached messages of a given user

Declaration

public string GetCachedMessages(ClaimsPrincipal user)

Parameters

Type	Name	Description
ClaimsPrincipal	user

Returns

Type	Description
string	Cached messages

GetSessionId(string)

Get a session ID from the given key

Declaration

public int GetSessionId(string key)

Parameters

Type	Name	Description
string	key	Key to query

Returns

Type	Description
int	Session ID or -1

GetTicketFromIpAddress(string)

Get a ticket from the given IP address

Declaration

public AuthenticationTicket? GetTicketFromIpAddress(string ipAddress)

Parameters

Type	Name	Description
string	ipAddress	IP address to query

Returns

Type	Description
AuthenticationTicket	Authentication ticket or null

GetTicketFromKey(string)

Get a ticket from the given key

Declaration

public AuthenticationTicket? GetTicketFromKey(string key)

Parameters

Type	Name	Description
string	key	Key to query

Returns

Type	Description
AuthenticationTicket	Authentication ticket or null

MaintainSessions(TimeSpan, string)

Remove sessions that are no longer active

Declaration

public void MaintainSessions(TimeSpan sessionTimeout, string socketPath)

Parameters

Type	Name	Description
TimeSpan	sessionTimeout	Timeout for HTTP sessions
string	socketPath	API socket path

MakeSessionKey(int, string, bool)

Make a new session key and register it if the session ID is valid

Declaration

public string MakeSessionKey(int sessionId, string ipAddress, bool readWrite)

Parameters

Type	Name	Description
int	sessionId	DSF session ID
string	ipAddress	Optional IP address if the request came from a RRF HTTP request
bool	readWrite	Whether the client has read-write or read-only access

Returns

Type	Description
string	Authentication ticket

MakeSessionTicket(int, string, bool)

Make a new session ticket and register it if the session ID is valid

Declaration

public AuthenticationTicket MakeSessionTicket(int sessionId, string ipAddress, bool readWrite)

Parameters

Type	Name	Description
int	sessionId	DSF session ID
string	ipAddress	Optional IP address if the request came from a RRF HTTP request
bool	readWrite	Whether the client has read-write or read-only access

Returns

Type	Description
AuthenticationTicket	Authentication ticket

RemoveTicket(ClaimsPrincipal)

Remove a session ticket returning the corresponding session ID

Declaration

public int RemoveTicket(ClaimsPrincipal user)

Parameters

Type	Name	Description
ClaimsPrincipal	user

Returns

Type	Description
int	Session ID or 0 if none was found

SetLongRunningHttpRequest(ClaimsPrincipal, bool)

Set whether a potentially long-running HTTP request has started or finished

Declaration

public void SetLongRunningHttpRequest(ClaimsPrincipal user, bool requestStarted)

Parameters

Type	Name	Description
ClaimsPrincipal	user	Principal user
bool	requestStarted	Whether a WebSocket is connected

SetWebSocketState(string, bool)

Set whether a given socket is connected over WebSocket

Declaration

public void SetWebSocketState(string key, bool webSocketConnected)

Parameters

Type	Name	Description
string	key	Session key
bool	webSocketConnected	Whether a WebSocket is connected

Implements

ISessionStorage