Manage Authentication History

This page contains instructions on how to manage authentication history.

Manage overall authentication history

To manage the overall authentication history of all the accounts logged in the system, click the Authentication History icon. The page provides three controls:

Clear logs

You may remove the login logs from the database using one of the following criteria:

• Clear logs starting from <date> To <date>: Clear the logs recorded in a certain period of time. Use the available text boxes or the calendar buttons to specify the interval's start and end date. The accepted date format is yyyy-mm-dd.
• Clear logs older than <number> <period>: Clear the logs older than the specified <number> of days/weeks/months/years. Use the drop-down list to select the <period>.

View sessions

The Sessions table displays the active sessions of users authenticated in the system with details on their account level (user or admin), username, IP and authentication date.

The logs are added to the login history list based on the settings you have made in the Log Messages on Level drop-down list from the Unified Communications → Monitoring → System Authentication → Login Preferences page.

For more information, please read the System Login Preferences section.

Search for a session

You can filter the list of existing sessions using the IP of the user:

1. Enter the IP of the session in the text box located above the table.
2. Click the  Search button. The system remembers the search criteria when a new search is performed and even after the user logs out.

Remove session

Please note that cannot delete your own sessions, but only those of the other users connected to the server.

To remove a session:

1. Select the session from the table and click the Remove selected link on top of the table.
2. To finalize it, select the Confirm removal checkbox and click OK. To return to the previous page without removing the session, click Cancel.

Check authentication history

To view the history of authenticated session of a specific account, go to Unified Communications → Web Interface Sessions → Authentication History.  The page provides three controls:

Clear logs

You may remove the authentication logs from the database using one of the following criteria:

• Clear logs starting from <date> To <date>: Clear the logs recorded in a certain period of time. Use the text boxes or the calendar buttons to specify the interval's start and end date. The accepted date format is yyyy-mm-dd.
• Clear logs older than <number> <period>: Clear the logs older than the specified <number> of days/weeks/months/years. Use the drop-down list to select the <period>.

View authentication history

The authentication history of a particular account is displayed in a table. It lists all the authentication times of the selected account, either successful or not.

Search for an authentication log

You can filter the list of authentication logs using the IP of the user, taking into account the User Login and/or the APIs (i.e. SystemAPI, UnifiedAPI, HubgetsAPI) used by applications to send authentication requests on behalf of the user:

1. Enter the IP of the session in the text box located above the table and select User Login or one of the APIs from the drop-down list above the Authentication History table
2. Then click on the Search button.

The result will detail the authentication time and the login resource, e.g Interface/Auth/Login or Interface/Auth/Logout, SystemAPI/Auth/Login, HG/Auth/Login, etc. While "Interface" refers to user authentication via VoipNow interface, "HG" refers to user authentication from Hubgets. 

The system remembers the search criteria when a new search is performed and even after the user logs out.