History

CPAM History tracks detailed information for each session run in the server. This includes Internal User connection history and the services accessed during each session. Service-specific activities, such as file transfers, deletions, and file renaming, are also recorded.

History contains the following tabs:

  • Connection History: Enables you to visualize all the existing and past connections made from the server.

  • My Connection History: Enables you to visualize only the connections you have made.

Shows a complete record of all access sessions in your system. Administrators and audit users can review:

  • Who accessed what systems

  • When connections started and ended

  • How long each connection lasted

  • Which credentials were used

  • Associated audit logs

Shows only the connections you personally initiated. Use this to:

  • Review your own access activity

  • Verify connection times and duration

  • Access audit logs for your sessions

  • Export your personal access records

The Audit Log page displays session metadata (user, host, service, start and end times, duration) alongside the Video Options panel.

The Video Options panel lets you choose which version of the recording to watch.

Option Description
Unabridged (whole session) The complete recording, including all idle time.
Abridged (major activity only) A condensed version with idle periods removed. Use this option to find activity in long sessions quickly.

Select the recording option you want to view. Click the video or Download Video to start the conversion. For longer sessions, this process may take a few minutes.

While the video is being converted, Download Video displays Converting and is unavailable.

When conversion is complete:

  • The video is available to play on the page.

  • You receive a browser notification and an email with a direct link back to this page.

  • Download Video becomes available for downloading the video.

  • Previously converted videos are cached on the server and load immediately on return visits. Once the cache expires, the next request triggers a fresh conversion.

Click Play in the video player to start watching. The player runs in the browser; no plugins or additional software are required.

If you selected Abridged, idle stretches are removed, so the video may be significantly shorter than the session duration shown in the session details.

Availability and Permissions

  • Viewing recordings requires the View History permission scoped to the site where the session took place.

  • The Abridged option may not be available if your administrator has disabled it for your environment.

  • If conversion fails, an error message appears describing the reason, such as a corrupted recording or insufficient server storage. Contact your system administrator if the issue persists.

Use the History Tab

  • Search: Use the search bar at the top of the table to quickly find specific records.

  • Column Customization: Add or hide columns.

    1. Click the Columns button in the toolbar.

    2. Toggle column visibility on/off.

    3. Rearrange columns by dragging.

  • Sort and Filter:

    • Sort: Click any column header to sort ascending or descending.

    • Filter: Use the search field to narrow results across multiple fields

      Results refresh automatically as you type

Export Data

Export access records for compliance, auditing, or further analysis:

To export records:

  1. Click the Export button in the toolbar.

  2. Select your date range:

    1. Click the calendar icons to choose start and end dates. The date range is inclusive of both dates.

  3. Choose file format:

    • CSV: For spreadsheet applications.

    • XLS: For Excel compatibility.

  4. Click Export to download.

My Activity

The My Activity report lists the sessions you've been connected to. This is a filtered version of the All Activity report, showing only the sessions that involve your User.

All Activity

To access a full report of all sessions, click on All Activity. This shows the complete session history for all Gatekeeper in your User Group:

Here you can see the complete session list for all users over the last 100 sessions. To view more sessions beyond the last 100, click Next Page.

The following details are provided for each session:

  • Date Created: The date the session began.

  • Duration: The length of time the session was active. If a session is still active, it shows as Active.

  • Owner: The User ID of the person who created the session.

  • Customer Name: The name of the customer for the session.

  • Gatekeeper: The name of the Gatekeeper (if applicable).

  • Status: The final status of the session.

The table below shows the status values for sessions:

Session Status Description
Active The session is currently active.
Registration This session represents the initial registration of a Gatekeeper.
Idle Timeout The session was closed due to inactivity.
Ended by User The User manually ended the session.
Ended by Customer The Customer manually ended the session.
Forced The session was forcibly terminated, typically due to network issues.
Expired The session ended because the Gatekeeper's access expiration time was reached.
No Status No status could be determined (For example, after a server restart).

Customer and Gatekeeper Activity

To view the activity history for all Gatekeepers within a Customer, click View History in Customer View.

If you're looking to see the activity history for a specific Gatekeeper, click History in Gatekeeper View.

Session Details

To view session-specific information, including internal user connection history and service usage, click View. This opens the Session History Details window.

In the Session History Details window, you can see a list of each user who was connected to the session, along with detailed information such as connection time, duration, and status.

NOTE:

For detailed descriptions of each field, see All Activity.

Below is a description of the key fields in the Session Users list:

  • Name: Displays the name of the user connected to the session.

  • Start Time: Shows the date and time when the user connected to the session.

  • End Time: Shows the date and time when the user disconnected from the session.

  • Duration: Indicates how long the user was connected to the session.

  • Status: Indicates the user's connection status.

Status values:

User Status Description
Active User is currently connected to the session.
Disconnected The user manually disconnected from the session.
Session Terminated The session ended while the user was still connected.
Forced The user was forcibly disconnected, likely due to a network closure.
No Status No status could be determined (For example., server restart).

If your CPAM server is integrated with your CRM system, session-specific Connection Form field values are displayed below the Session Users list. These fields are also recorded in Gatekeeper audit reports.

Below the Session Users list, you can find a list of Session Services accessed during the session. For each service, detailed information is provided, including host and port details. Additionally, for FTP, Desktop Sharing, SSH, or Telnet services, more detailed Audit Logs may be available.

Audit Logs

The CPAM server can be configured to store detailed audit information for certain services including FTP transfers, SSH sessions, Telnet sessions, and Desktop Sharing sessions. When detailed audit information is available for a service usage, a link appears in the Audit Logs column.

If the CPAM server has been configured to store Desktop Sharing log data then you can convert this data to a playable movie by clicking on Audit Logs. Depending on the service used and server version at the time of the audit, the Movie Options or the RDP converter dialog displays.

  1. Select a file type and click Launch Java Web StartConverter. A file chooser dialog opens.

  2. Navigate to where you want to save the movie then click Save to begin the conversion process.

NOTE:

This client-side conversion can take several minutes for long sessions and is only supported on Windows systems.

If you want the video to play immediately after conversion completes, select Launch video after saving.

  1. Start both or one of the options that you would like to convert.

  2. The button changes to Converting while it converts on the server. This can take several minutes for long sessions.

  3. After completion, you are able to click Download.

  4. The user who launched the process is notified in their browser and by email.

Admin Logs

The Admin Logs section is available only to System Administrators. It provides an overview of both system-level messages and higher-level user activity on the CPAM server. By default, messages are listed in descending order by date (most recent first), and have the following properties:

Admin Log Property Description
Time The time stamp when the event or message was generated.
User ID (User Activity only) The User responsible for generating the message (only in User Activity).
Method A noun (For example, DEBUG, INFO, ERROR) for system messages or a verb (For example, CREATE, UPDATE, DELETE) for user activity.
Object Type A tag indicating the type of object or event associated with the message (For example, User, Customer).
Object Key The system-wide unique identifier for the object related to the message.
Extra Info A human-readable note containing further details about the log message.

Above the Admin Log records, you can see a list of available methods to filter the logs.

Use the Methods options to quickly filter the Admin Log records. Click All to clear the filter.

NOTE:

Methods may differ depending on the type of records being displayed.

System messages are generated by the CPAM server itself and are not attributable to any specific user. Therefore, User ID is not present in System Messages. These messages include system logins, login failures, debug information, password resets, and Desktop Sharing video recording management information.

The User Activity section of the Admin Logs helps determine "who's doing what" within the system. While the Activity Reports show the actions taken by users when connected to a Gatekeeper, the User Activity section specifically tracks changes made to system objects.

Audit Reliability

CPAM is capable of capturing audit details for every session. However, factors such as security settings, service configurations, network issues, or other aspects beyond the control of CPAM, may restrict the server's ability to provide detailed audit logs for some services.

If you have any questions or concerns regarding audit reliability, please contact the CPAM team for assistance.