Module org.refcodes.security.alt.chaos
Package org.refcodes.security.alt.chaos

Enum Class ChaosMode

java.lang.Object
java.lang.Enum<ChaosMode>
org.refcodes.security.alt.chaos.ChaosMode
All Implemented Interfaces:
Serializable, Comparable<ChaosMode>, Constable, org.refcodes.mixin.EncodedAccessor, ChaosOptions
public enum ChaosMode extends Enum<ChaosMode> implements ChaosOptions
The ChaosMode specifies the mode of operation of a ChaosKey when using Chaos-based encryption/decryption. Attention: Comparing a ChaosMode with a different implementation of the ChaosOptions only functions as expected when passing the ChaosMode as argument to that different ChaosOptions implementation's ChaosOptions.equals(Object) method as the Enum.equals(Object) method of the ChaosMode enumeration cannot be overwritten (the Enum.equals(Object) method of an enumeration cannot be overridden)!

  • Nested Class Summary

    Nested classes/interfaces inherited from class java.lang.Enum

    Enum.EnumDesc<E extends Enum<E>>

    Nested classes/interfaces inherited from interface org.refcodes.mixin.EncodedAccessor

    org.refcodes.mixin.EncodedAccessor.EncodedBuilder<B extends org.refcodes.mixin.EncodedAccessor.EncodedBuilder<B>>, org.refcodes.mixin.EncodedAccessor.EncodedMutator, org.refcodes.mixin.EncodedAccessor.EncodedProperty

  • Enum Constant Summary

    Enum Constants
    Enum Constant
    Description
    MUTATE
    A MUTATION operation as of isMutateS() is being applied.
    MUTATE_XOR
    Combination of the XOR mode alongside the MUTATE mode.
    NONE
    No additions are to be applied to the raw Chaos-based encryption/decryption.
    SALTED
    A SALTING operation as of isSalted() is being applied where applicable.
    SALTED_MUTATE
    Combination of the SALTED mode alongside the MUTATE mode.
    SALTED_MUTATE_XOR
    Combination of the SALTED mode as well as the XOR mode alongside the MUTATE mode.
    SALTED_XOR
    Combination of the SALTED mode alongside the XOR mode.
    XOR
    XOR obfuscation as of isXorNext() is being applied.

  • Field Summary

    Fields inherited from interface org.refcodes.security.alt.chaos.ChaosOptions

    ENCODED_LENGTH, OPTIONS_BIT_MUTATE_S, OPTIONS_BIT_RND_PREFIX, OPTIONS_BIT_SALTED, OPTIONS_BIT_XOR_NEXT, OPTIONS_BYTES, PREFIX_SIZE_BYZES

  • Method Summary

    Modifier and Type
    Method
    Description
    short
    getRndPrefixSize()
    Sets the number of random bytes to be prefixed upon a PREFIX operation of decrypted (raw) data when encrypting with the accordingly configured ChaosKey: Prefixing with random bytes will cause the same (succeeding) decrypted (raw) data to be encrypted differently even when using the same ChaosKey configuration.
    boolean
    isMutateS()
    Determines whether a MUTATION operation of the ChaosKey's S value is to be applied with the previous byte value (before its encryption or zero 0 in case of the first value being processed), S then varies by +127 to -128 by each iteration: Nearly equal encrypted datasets will differ chaotically beginning with the the first occurrence of a different byte.
    boolean
    isSalted()
    Determines whether an additional SALTING operation with an additional salting (random) ChaosKey is to be applied: The salting ChaosKey's encoded bytes representation (as of ChaosKey.getEncoded()) is prefixed to the actual data which in a first pass is encoded with the this very salting ChaosKey.
    boolean
    isXorNext()
    Determines whether an XOR obfuscation of the next byte value to be encrypted is to be applied with the previous byte value (before its encryption or zero 0 in case of the first value being processed).
    String
    toString()
    static ChaosMode
    valueOf(String name)
    Returns the enum constant of this class with the specified name.
    static ChaosMode[]
    values()
    Returns an array containing the constants of this enum class, in the order they are declared.

    Methods inherited from class java.lang.Enum

    clone, compareTo, describeConstable, equals, finalize, getDeclaringClass, hashCode, name, ordinal, valueOf

    Methods inherited from class java.lang.Object

    getClass, notify, notifyAll, wait, wait, wait

    Methods inherited from interface org.refcodes.security.alt.chaos.ChaosOptions

    equals, getEncoded, hasRndPrefix, isFixedLength

  • Enum Constant Details

    • NONE

      public static final ChaosMode NONE
      No additions are to be applied to the raw Chaos-based encryption/decryption.

    • MUTATE

      public static final ChaosMode MUTATE
      A MUTATION operation as of isMutateS() is being applied.

    • XOR

      public static final ChaosMode XOR
      XOR obfuscation as of isXorNext() is being applied.

    • MUTATE_XOR

      public static final ChaosMode MUTATE_XOR
      Combination of the XOR mode alongside the MUTATE mode.

    • SALTED

      public static final ChaosMode SALTED
      A SALTING operation as of isSalted() is being applied where applicable.

    • SALTED_MUTATE

      public static final ChaosMode SALTED_MUTATE
      Combination of the SALTED mode alongside the MUTATE mode.

    • SALTED_XOR

      public static final ChaosMode SALTED_XOR
      Combination of the SALTED mode alongside the XOR mode.

    • SALTED_MUTATE_XOR

      public static final ChaosMode SALTED_MUTATE_XOR
      Combination of the SALTED mode as well as the XOR mode alongside the MUTATE mode.

  • Method Details

    • values

      public static ChaosMode[] 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 ChaosMode 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

    • isXorNext

      public boolean isXorNext()
      Determines whether an XOR obfuscation of the next byte value to be encrypted is to be applied with the previous byte value (before its encryption or zero 0 in case of the first value being processed). XOR does not seem to be too effective obfuscating similar encrypted data with the same ChaosKey, though for low capability devices it can be handy to add that little extra obfuscation to make it hard to interpolate between two similar but different messages. Disclaimer: Using this option "stand alone" in a ChaosKey not in combination with ChaosOptions.isSalted() either in this ChaosKey or in combination with another ChaosKey not completely closes the "comparison" attack vector (see "https://www.metacodes.pro/funcodes/chaos-based_encryption_revisited")
      Specified by:
      isXorNext in interface ChaosOptions
      Returns:
      True in case XOR obfuscation is to be established.

    • isMutateS

      public boolean isMutateS()
      Determines whether a MUTATION operation of the ChaosKey's S value is to be applied with the previous byte value (before its encryption or zero 0 in case of the first value being processed), S then varies by +127 to -128 by each iteration: Nearly equal encrypted datasets will differ chaotically beginning with the the first occurrence of a different byte. Disclaimer: Using this option "stand alone" in a ChaosKey not in combination with ChaosOptions.isSalted() either in this ChaosKey or in combination with another ChaosKey not completely closes the "comparison" attack vector (see "https://www.metacodes.pro/funcodes/chaos-based_encryption_revisited")
      Specified by:
      isMutateS in interface ChaosOptions
      Returns:
      True in case ADD obfuscation is to be established.

    • isSalted

      public boolean isSalted()
      Determines whether an additional SALTING operation with an additional salting (random) ChaosKey is to be applied: The salting ChaosKey's encoded bytes representation (as of ChaosKey.getEncoded()) is prefixed to the actual data which in a first pass is encoded with the this very salting ChaosKey. The salting ChaosKey encoded bytes representation as well as the succeeding initially encoded (salted) data then is encoded with the actual encryption ChaosKey, ensuring that the prefixed salting ChaosKey bytes are encoded. Decryption then is applied in reverse order. Currently only the ChaosEncryptionOutputStream and the ChaosDecryptionInputStream support salting! The ChaosEncrypter and ChaosDecrypter ignore this option!
      Specified by:
      isSalted in interface ChaosOptions
      Returns:
      True in case SALTING is to be established.

    • getRndPrefixSize

      public short getRndPrefixSize()
      Sets the number of random bytes to be prefixed upon a PREFIX operation of decrypted (raw) data when encrypting with the accordingly configured ChaosKey: Prefixing with random bytes will cause the same (succeeding) decrypted (raw) data to be encrypted differently even when using the same ChaosKey configuration. Valid values range from {1..256} representable by one byte as of {0x00..0xFF}. Disclaimer: Using this option "stand alone" in a ChaosKey not in combination with ChaosOptions.isSalted() either in this ChaosKey or in combination with another ChaosKey not close by any means the "comparison" attack vector (see "https://www.metacodes.pro/funcodes/chaos-based_encryption_revisited")
      Specified by:
      getRndPrefixSize in interface ChaosOptions
      Returns:
      The number of bytes for establishing the PREFIX functionality, 0 if no prefixing is to be applied at all.

    • toString

      public String toString()
      Overrides:
      toString in class Enum<ChaosMode>