- All Known Subinterfaces:
AuditProvider.TracedAuditEvent
public interface AuditEvent
An audit event to store using an Audit provider.
You should provide your own implementation class.
-
Nested Class Summary
Modifier and TypeInterfaceDescriptionstatic final class
Named parameters of audit event.static enum
Severity ofAuditEvent
. -
Field Summary
Modifier and TypeFieldDescriptionstatic final String
Reserved event type prefix for audit events.static final String
Reserved event type prefix for authentication events.static final String
Reserved event type prefix for authorization events.static final String
Reserved event type prefix for outbound security (such as identity propagation) events.static final String
Reserved event type prefix for security component. -
Method Summary
Modifier and TypeMethodDescriptionGets the type of thisAuditEvent
.Gets the message format of thisAuditEvent
to be used withString.format(String, Object...)
.params()
Parameters of this audit event, used inString.format(String, Object...)
when creating the audit message.severity()
Gets the severity of thisAuditEvent
.Gets anThrowable
object from which additional audit information can be obtained.
-
Field Details
-
SECURITY_TYPE_PREFIX
Reserved event type prefix for security component.- See Also:
-
AUTHN_TYPE_PREFIX
Reserved event type prefix for authentication events. You may trigger such audit events (e.g. when writing an authentication provider, or from app), yet they MUST be related to authentication.- See Also:
-
AUTHZ_TYPE_PREFIX
Reserved event type prefix for authorization events. You may trigger such audit events (e.g. when writing an authorization provider, or from app), yet they MUST be related to authorization.- See Also:
-
OUTBOUND_TYPE_PREFIX
Reserved event type prefix for outbound security (such as identity propagation) events. You may trigger such audit events (e.g. when writing an identity propagation provider, or from app), yet they MUST be related to identity propagation.- See Also:
-
AUDIT_TYPE_PREFIX
Reserved event type prefix for audit events. You may trigger such events ONLY when writing audit providers.- See Also:
-
-
Method Details
-
eventType
String eventType()Gets the type of thisAuditEvent
.- Returns:
- the type of this
AuditEvent
represented as String.
-
throwable
Gets anThrowable
object from which additional audit information can be obtained.- Returns:
- an
Throwable
with additional information if available.
-
params
List<AuditEvent.AuditParam> params()Parameters of this audit event, used inString.format(String, Object...)
when creating the audit message.- Returns:
- parameters of this audit message
-
messageFormat
String messageFormat()Gets the message format of thisAuditEvent
to be used withString.format(String, Object...)
.- Returns:
- English message format (this is a fallback if internationalization is not configured).
-
severity
AuditEvent.AuditSeverity severity()Gets the severity of thisAuditEvent
.- Returns:
- severity
-