Audit Event Details
This Document provides details of each audit event and its attributes.
First the attributes that are present in all audits are provided. Next the attributes that are repeated with each audit of a microservice are provided. Finally, every audit specific argument is presented.
Common attributes:
The following are common attributes in all audit events.
Attributes:
- SSH-PrivX-service: microservice that the Audit originates form
- audit-exposure: for normal audits "SSH-PRIVX-AUDIT" and for sensitive audits "SSH-PRIVX-SENSITIVE-AUDIT"
- instanceName: instance name
- severity: event Severity (Critical(2), Alert(1), Warning(4), Info(6))
- userID: PrivX user ID
- username: PrivX username
- sessionID: session ID
- timestamp: timestamp of event
- version: PrivX version number
Microservice specific attributes:
Depending on what Microservice the audit originates form it will have some additional attributes that will always be present.
SSH Proxy
The following are common attributes in all audit events originating from SSH Proxy microservice.
Attributes:
- connectionID: connection ID
- accessGroupID: target AccessGroupID or default AccessGroupID (if no target)
- hostID: host ID (if target available)
- hostAddress: target hostname and port if non-standard
- remoteAddress: connection client address
- targetUsername: target username
- connectionType: "SSH"
- connectionMode: "UI"
- tags: tags (if available)
SSH Bastion
The following are common attributes in all audit events originating from SSH Bastion microservice.
Attributes:
- connectionID: connection ID,
- accessGroupID: target AccessGroupID or default AccessGroupID (if no target)
- hostID: host ID (if target available)
- hostAddress: target hostname and port if non-standard
- remoteAddress: connection client address
- targetUsername: target username
- connectionType: "SSH"
- connectionMode: "TUNNEL" or "MITM"
- tags: tags (if available)
RDP Proxy
The following are common attributes in all audit events originating from RDP Proxy microservice.
Attributes:
- connectionID: connection ID
- accessGroupID: target AccessGroupID or default AccessGroupID (if no target)
- hostID: host ID
- hostAddress: target hostname and port if non-standard
- remoteAddress: connection client address
- targetUsername: target username
- connectionType: "RDP"
- connectionMode: "UI"
- tags: tags (if available)
RDP Bastion
The following are common attributes in all audit events originating from RDP Bastion microservice.
Attributes:
- connectionID: connection ID
- accessGroupID: target AccessGroupID or default AccessGroupID (if no target)
- hostID: host ID
- hostAddress: target hostname and port if non-standard
- remoteAddress: connection client address
- targetUsername: target username
- connectionType: "RDP"
- connectionMode: "MITM"
- tags: tags (if available)
Audit events
This section describes the attributes for each audit event.
API-client-added
Attributes:
- clientID: ID of the api client being added
- message: description of the event
- name: api client name
- roles: ID of roles separated by comma
API-client-credential-created
Attributes:
- message
API-client-credential-deleted
Attributes:
- message
API-client-credential-modified
Attributes:
- message
- modifications: a json data containing the old and new value of modified fields
API-client-modified
Attributes:
- clientID: ID of the api client being modified
- message: description of the event
- modifications: a json data containing the old and new value of modified fields
- name: api client name
API-client-removed
Attributes:
- clientID: ID of the api client being deleted
- message: description of the event
- name: api client name
API-proxy-session-closed
Attributes:
- message
- reason
API-proxy-session-recording-closed
Attributes:
- message
API-proxy-session-recording-fatal-failure
Attributes:
- error
- message
API-proxy-session-recording-started
Attributes:
- message
API-proxy-session-started
Attributes:
- message
API-target-created
Attributes:
- message
API-target-deleted
Attributes:
- message
API-target-modified
Attributes:
- message
- modifications: a json data containing the old and new value of modified fields
Access-group-created
Attributes:
- accessGroupID: ID of the access group being created
- message: description of the event
Access-group-deleted
Attributes:
- accessGroupID: ID of the access group being deleted
- message: description of the event
Access-group-modified
Attributes:
- accessGroupID: ID of the access group being modified
- message: description of the event
- modifications: a json data containing the old and new value of modified fields
Access-role-granted
This event is logged when a closed connection is granted a role for auditing
Attributes:
- connectionID: ID of the connection
- roleID: ID of the role granted to audit the connection
Access-role-revoked
Attributes:
- connectionID: ID of the connection
- connectionIDs: ID of the connections
- roleID: ID of the role revoked from auditing the connection
Access-token-granted
This event is logged when access to PrivX is granted
Attributes:
Auditevent-removed
This event is logged when audit events that are out of retention period are removed by a housekeeping task
Attributes:
- appID: the UUID of the monitor-service instance
- message: internally logged message, contains number of events that are removed
Authorization-certificate-granted
Attributes:
- accessGroupID
- authority-keyid
- connectionID: ID of the connection
- criticalOptions: certificate critical options
- extensions: certificate extensions
- hostAddress: targer host address
- issuer: certificate issuer
- keyID
- key-usage
- message: description of the event and type of certificate
- principals
- public-key
- serial: certificate serial
- sha1-fingerprint
- sha256-fingerprint
- signature-algorithm
- signature-key
- subject
- subject-keyid
- target: user remote address
- upn: The User Principal Name (UPN) and generally takes the form of user@domain.com
- valid: provides the validity period using not before and not after values
Authorization-passphrase-returned
Attributes:
- accessGroupID
- connectionID: ID of the connection
- hostAddress: targer host address
- hostID
- message: description of the event
- target: user remote address
- targetUsername
Authorization-rejected
Attributes:
- address: client remote address