- All Known Subinterfaces:
AuditProvider.TracedAuditEvent
public interface AuditEvent
An audit event to store using an Audit provider.
You should provide your own implementation class.
- See Also:
-
Nested Class Summary
Nested ClassesModifier and TypeInterfaceDescriptionstatic final classNamed parameters of audit event.static enumSeverity ofAuditEvent. -
Field Summary
FieldsModifier and TypeFieldDescriptionstatic final StringReserved event type prefix for audit events.static final StringReserved event type prefix for authentication events.static final StringReserved event type prefix for authorization events.static final StringReserved event type prefix for outbound security (such as identity propagation) events.static final StringReserved event type prefix for security component. -
Method Summary
Modifier and TypeMethodDescriptionGets the type of thisAuditEvent.Gets the message format of thisAuditEventto 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 anThrowableobject 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
AuditEventrepresented as String.
-
throwable
Gets anThrowableobject from which additional audit information can be obtained.- Returns:
- an
Throwablewith 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 thisAuditEventto 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
-