Enum Class SecurityEventKind

java.lang.Object
java.lang.Enum<SecurityEventKind>
com.iizix.security.SecurityEventKind
All Implemented Interfaces:
Serializable, Comparable<SecurityEventKind>, Constable

public enum SecurityEventKind extends Enum<SecurityEventKind>
What kind of thing a security event records (CC-SIGNIN-RECORDS-AND-SECURITY-LOG, order 556). The kind is stored by its name, so a kind is never renamed; one may be added.
Author:
Christopher Mindus
  • Nested Class Summary

    Nested classes/interfaces inherited from class Enum

    Enum.EnumDesc<E>
  • Enum Constant Summary

    Enum Constants
    Enum Constant
    Description
    An account reached the limit of failed sign-ins and is locked: no attempt on it is evaluated for a time that grows at every further failure; the account is not disabled (CC-FIX-ADMIN-LOCKOUT, order 563).
    An account was unlocked before its time: by an administrator in ServerAdmin, by a completed password reset, or by the break-glass file at a server start.
    The break-glass path of the lone administrator was used, or an administrator's sign-in methods were reset.
    The enrollment of a second factor was asked in a sign-in that waits for a second factor the user has, and was refused (CC-FIX-STRONG-HELD-PASSKEY): the password was right, and no screen of a sign-in asks for this - a changed client does.
    A sign-in far from the user's usual places (dormant until the location check, SNP-8).
    Anything else an application reports.
    A password was changed or reset.
    A sign-in policy or setting of the server changed.
    A recovery code was used in place of the second factor.
    A second factor was presented and failed: a wrong code, a wrong recovery code, a passkey that did not verify.
    A session was taken over by another client of the same user (dormant until the hub's take-over lands, 447 S-2).
    A user signed in, or signed in again in a session that had the user already.
    A sign-in was refused: wrong password, unknown user, disabled user, no access to the application, too many attempts.
    A user signed out, or a device of the user was signed out by the user or an administrator.
  • Method Summary

    Modifier and Type
    Method
    Description
    of(String name)
    Gets a kind from its stored name, tolerant of a name this release does not know.
    Returns the enum constant of this class with the specified name.
    Returns an array containing the constants of this enum class, in the order they are declared.

    Methods inherited from class Object

    getClass, notify, notifyAll, wait, wait, wait
  • Enum Constant Details

    • SIGN_IN

      public static final SecurityEventKind SIGN_IN
      A user signed in, or signed in again in a session that had the user already.
    • SIGN_IN_REFUSED

      public static final SecurityEventKind SIGN_IN_REFUSED
      A sign-in was refused: wrong password, unknown user, disabled user, no access to the application, too many attempts.
    • SECOND_FACTOR_FAILED

      public static final SecurityEventKind SECOND_FACTOR_FAILED
      A second factor was presented and failed: a wrong code, a wrong recovery code, a passkey that did not verify.
    • RECOVERY_CODE_USED

      public static final SecurityEventKind RECOVERY_CODE_USED
      A recovery code was used in place of the second factor.
    • SESSION_TAKEN_OVER

      public static final SecurityEventKind SESSION_TAKEN_OVER
      A session was taken over by another client of the same user (dormant until the hub's take-over lands, 447 S-2).
    • POLICY_CHANGED

      public static final SecurityEventKind POLICY_CHANGED
      A sign-in policy or setting of the server changed.
    • BREAK_GLASS_USED

      public static final SecurityEventKind BREAK_GLASS_USED
      The break-glass path of the lone administrator was used, or an administrator's sign-in methods were reset.
    • FAR_AWAY_SIGN_IN

      public static final SecurityEventKind FAR_AWAY_SIGN_IN
      A sign-in far from the user's usual places (dormant until the location check, SNP-8).
    • SIGN_OUT

      public static final SecurityEventKind SIGN_OUT
      A user signed out, or a device of the user was signed out by the user or an administrator.
    • PASSWORD_CHANGED

      public static final SecurityEventKind PASSWORD_CHANGED
      A password was changed or reset.
    • ACCOUNT_HELD

      public static final SecurityEventKind ACCOUNT_HELD
      An account reached the limit of failed sign-ins and is locked: no attempt on it is evaluated for a time that grows at every further failure; the account is not disabled (CC-FIX-ADMIN-LOCKOUT, order 563). The event carries the attacker's address and place.
    • ACCOUNT_HOLD_ENDED

      public static final SecurityEventKind ACCOUNT_HOLD_ENDED
      An account was unlocked before its time: by an administrator in ServerAdmin, by a completed password reset, or by the break-glass file at a server start.
    • OTHER

      public static final SecurityEventKind OTHER
      Anything else an application reports.
    • ENROLLMENT_REFUSED

      public static final SecurityEventKind ENROLLMENT_REFUSED
      The enrollment of a second factor was asked in a sign-in that waits for a second factor the user has, and was refused (CC-FIX-STRONG-HELD-PASSKEY): the password was right, and no screen of a sign-in asks for this - a changed client does. The event carries the account. (It stands after OTHER: a kind is stored by its name, the order says nothing.)
  • Method Details

    • values

      public static SecurityEventKind[] values()
      Returns an array containing the constants of this enum class, in the order they are declared.
      Returns:
      an array containing the constants of this enum class, in the order they are declared
    • valueOf

      public static SecurityEventKind valueOf(String name)
      Returns the enum constant of this class with the specified name. The string must match exactly an identifier used to declare an enum constant in this class. (Extraneous whitespace characters are not permitted.)
      Parameters:
      name - the name of the enum constant to be returned.
      Returns:
      the enum constant with the specified name
      Throws:
      IllegalArgumentException - if this enum class has no constant with the specified name
      NullPointerException - if the argument is null
    • of

      public static SecurityEventKind of(String name)
      Gets a kind from its stored name, tolerant of a name this release does not know.
      Parameters:
      name - The name, possibly null.
      Returns:
      The kind, OTHER for null or an unknown name.