Managing brokered sessions

Prev Next

Viewing and terminating active sessions

The Active Brokered Sessions page (Usage > Active Brokered Sessions) lists each active session with the Username, Type, Site, Entitlement, Host, and Start Time. To update the list automatically, turn on Auto-Refresh. Select the Action icon (Three circular shapes stacked vertically on a dark background, selected to access a menu.) next to a session to see the following options:

  • Go to Active Session Details. Opens the Active Session Details page for the session.

  • Terminate. Opens the Terminate Brokered Session window. Select a predefined Reason for Termination, or select Other and enter your own reason. Then select Terminate to end the session. AppGate ZTNA records the reason in the audit log. The user sees a message that a supervisor terminated the session.

If monitoring is turned on for a session, select the session to open the Brokered Session Window. From this window, you can view the session in real time or terminate it.

NOTE

Terminating a session does not remove access. The user can start a new session immediately. To remove access, change or disable the entitlement.

NOTE

Changes to a brokered entitlement apply to new sessions only. To apply a change to an active session, terminate the session and have the user start a new one.


Playing and downloading recorded sessions

The Recorded Brokered Sessions page (Usage > Recorded Brokered Sessions) lists each recording with the recording date and time, Username, Identity Provider, Type, Hostname, Duration, Size, and End Reason. End reasons include User ended and Supervisor terminated. The page header shows the used and free storage on the Gateway.

You can filter searches on the page by keyword, username, and end reason.

To play a recording, select it. The Recorded Brokered Session window shows the playback controls, Session Started, Username, Hostname, and Reason for Termination.

Recorded brokered session displays an Ubuntu terminal with session details, username, hostname, and user-ended termination status.

Select the Action icon (Three circular shapes stacked vertically on a dark background, selected to access a menu.) next to a recording to see the following options:

  • Convert to MP4. Converts the recording to MP4 format and makes it available for download.

    • When the conversion is complete, the option changes to Download MP4 and an MP4 icon will also appear next to the recording’s size in the Size column. Select Download MP4 to save the file in the following format: recording-<date>, <time>.mp4

  • Download typescript. Downloads the typescript for the session.

  • Delete MP4. Appears after you convert a recording to MP4. Deletes only the MP4 file, not the original recording.

CAUTION

The Gateway stores recordings, and recording length has no limit. Monitor Gateway disk usage, because a full disk prevents recorded sessions from starting.