Get current sessions

Edit online

Retrieves a list of sessions for user accounts that are authenticated and logged in to the library. These may be from local user accounts or mapped remote users from LDAP or Kerberos. If a user is logged in more than once, it will show up multiple times in this list.

Request syntax

GET /v1/authentication/sessions
Retrieves list sessions for user accounts that are authenticated and logged in to with the library.

GET /v1/authentication/sessions/{name}
Retrieves list of sessions for specified user account that is logged in to the library.

Path parameters

name (string): The unique name of the user account that is logged in to the library. The message body still includes an array in this case as a single user can be logged in using multiple sessions.

Example

> GET /v1/authentication/sessions
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 45992

[
   {
      "name": "admin_bob", 
      "authenticationMethod": "local", 
      "role": "Administrator",
      "address": "156.156.10.10",
      "lastConnected": "2022-04-03T09:33:37-0700"
   }, {
        ...
      }
]

Attributes

name (string): The unique name of the user account.

authenticationMethod (string): How the user logged in to the library. This is one of local, ldap, or kerberos.

role (string): The name of the user role that defines which commands the user account is allowed to execute. For local users this is the role that is assigned to that user. For remote users, this is the role it was mapped to when it authenticated.

address (string): The IP address or hostname this user connection is logged in from.

lastConnected (string): The time and date the user account was connected to the library.