Sessions

The Sessions resource (meta_md_session) is part of the System Monitor module of iTopia. The Sessions view tracks Web browser sessions that are currently active. The records in this table cannot be maintained. (User access tokens are generated from this table.)

  • The Terminate Session action allows a user with sufficient permission to terminate or log a user off, if necessary.

  • The Delete action allows a user with sufficient permission to delete sessions, but this is not recommended. Only a terminated session can be deleted.

Note: If a user logs out of the iTopia session improperly, a record still displays in this table. The record is automatically cleared from the table after a period of time.

The following list defines every field available in the sessions (md_session) table in alphabetical order:

  • Applications - a link to the Session Applications view.

  • Client Host Name - the client host name.

  • Client IP Address - the client IP address.

  • Client Mode - this field is not maintainable. When a session is created, the client mode identifies the type of emulation used by the session. The following options are available:

    • Not Applicable (default)
    • Desktop
    • Voice
    • Handheld
    • CE

    For sessions created by Web services and background processes, the value is set to Not Applicable.

  • Client User Name - the client user name.

  • Created By - displays the name of the user who created the record you are viewing or maintaining. May not be overridden.

  • Created On - displays the date on which the record that you are creating or maintaining was created. May not be overridden. May also represent the creation date of the records you are attempting to retrieve.

  • Current Session - indicates whether or not a given record belongs to the current session. The following options are available: Yes or No.

  • Extra Attributes - a CLOB-type field used to store additional JSON information.

  • ID - the unique identifier for a given session. This is for internal use.

  • Instance Name - the unique application server instance name. Note: An application server instance is automatically created the first time a session refers to it.

  • Last Access Time - the last time the user accessed the system.

  • Public Session Token - this field is not maintainable. A unique identifier for a given session to be used by Web services.

  • Session Attributes - an expression column that provides details of the attributes associated with this session.

    • When the field is personalized in the search results of a view, it shows the number of attributes. It is linkable to the Session Attributes view, and provides a hover preview.

    • When the field is personalized in the Details page, the information is embedded into the page and may not be modified.

  • Session Type - this field is not maintainable. The following options are available:

    • Not Applicable (default)

    • Interactive - indicates that the client mode is set to Desktop, Voice, Handheld, or CE.

    • Background Service - indicates that the session was created by a queue, a timer, or a task. In this case, the client mode is set to Not Applicable.

    • Web Services - indicates that the session was create by a Web service request. In this case, the client mode is set to Not Applicable.

  • Single Sign-On - this field is not maintainable. The following options are available: Yes and No (default).

    • A value of Yes indicates that single sign-on authentication was used for the user login.

    • A value of No indicates that single sign-on authentication was not used for the user login.

  • System Login - the system login flag. The following options are available: Yes and No.

    • A system login is a login performed by the application in a background process. It is independent of a user logging into the system. System login sessions are not counted when verifying the active sessions against those which are permitted by the license.

  • Terminated On - this field is not maintainable. The time at which the session was terminated. This field contains no value in the case of an active session.

  • Termination Action - this field is not maintainable. The following options are available:

    • Not Terminated (default) - indicates that the session is still active and not yet terminated.

    • Requested by User - indicates that the session was terminated by the user using the Logout action.

    • Requested by Administrator - indicates that the session was terminated using the Terminate Session action.

    • Oldest Session Terminated - indicates that the session was terminated by the system as the user exceeded the maximum number of sessions allowed. This restriction is imposed by licensing. When this occurs, the user's oldest session is automatically terminated or logged out.

    • Expired Session Terminated - indicates that the session was terminated by the system session cleanup as the session inactivity time exceeded the session timeout.

    • Terminated by System - indicates that the session was terminated by the system. These are sessions which were created by the system for background processes.

  • Timeout On - this field is not maintainable. The time at which the session will expire if it becomes inactive based on the value in the Last Access Time field.

  • User Agent - this field is not maintainable. The user agent, which helps to identify the browser and browser version used.

    • When a session is created, this field is set to the client's browser user agent.

    • For example, the user agent Mozilla/5.0 (Windows NT 6.1; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/42.0.2311.135 Safari/537.36 is from a Chrome browser with version 42.0.2311.135.

  • User Name - the user id of the user logged into iTopia.

For the functionality of each action (i.e. button) available on this view, refer to the About the Actions topic.