Skip to main content
Version: 4.32.x.x LTS

Session Termination Polling and Actor Identification

Upon receiving an AUTH_DONE response state together with a SecToken, nevisProxy identifies the user session as an authenticated session. Further requests may only cross nevisProxy. Therefore, nevisProxy holds the master session. This means, if a logout is detected, either instructed by the user or a back-end application. nevisProxy is then responsible for sending a logout or kill request to nevisAuth.

However, it is also possible that nevisAuth decides to terminate the session. This might happen, for example, if the nevisAuth session reaper detects a timed-out session. In this case, the session coordination between nevisProxy and nevisAuth can be achieved using the poll_terminated_sessions method.

An external server (usually nevisProxy) can use this method to collect notifications of terminated sessions. The method handler will postpone sending a response until at least a minimal duration has passed (since this notification mechanism is understood to be near-real-time only) and, if no sessions have been terminated since the last call, it will wait up to a maximal duration for the termination of new events. Both minimal and maximal durations can be specified with the request.

To keep track of termination notifications and administer which notifications have been consumed by which actor, each external server must be identified with a unique actorId. This is done via the HTTP header actorId (in SOAP deployment) or, as a fallback, via the SubjectDN in the transport layer client certificate used by the actor.