View audit log

This endpoint requests a list of events. Events can include the following:

  • audit.log.view—The system received and processed an audit-log request.
  • session.create—The system created a session for the user. This event can be triggered by user login or authentication using an API key.
  • session.delete—The session expired, or the user ended the session.
  • session.impersonation.end—An administrator ended a session where they impersonated another user.
  • session.impersonation.start—An administrator started a session where they impersonated another user.
  • user.authenticate.mfa—The two-factor authentication challenge was successful, and login allowed.
  • user.authenticate.password—The user authenticated a session start using a password.
  • user.create—An administrator created a new user account.
  • users.delete—An administrator deleted the user account.
  • user.impersonation.end—An administrator stopped impersonating another user.
  • user.impersonation.start—An administrator started impersonating another user.
  • user.logout—The user logged out of the session.
  • user.update—Either an administrator or the user updated the user account.

You can specify various filters to limit the events that are returned, as well as the number of events. By default, a maximum of 50 events is returned.

Note: If you configure SSO authentication, Tenable.io does not log user actions to the audit log. This information may be available from the identity services provider you use. For more information, see SSO Authentication.

Requires ADMINISTRATOR [64] user permissions. See Permissions.

Language
Authentication
Header
Click Try It! to start a request and see the response here!