Module org.refcodes.security.alt.chaos

Package org.refcodes.security.alt.chaos

Class ChaosOptionsImpl

java.lang.Object

org.refcodes.security.alt.chaos.ChaosOptionsImpl

All Implemented Interfaces:

org.refcodes.mixin.EncodedAccessor, ChaosOptions

public class ChaosOptionsImpl
extends Object
implements ChaosOptions

The ChaosOptionsImpl provides means to create a ChaosOptions instance.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final class	ChaosOptionsImpl.Builder	Builder to build ChaosOptions instances.

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

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

Constructor Summary

Constructors

Constructor	Description
ChaosOptionsImpl(boolean isMutateS, boolean isXorNext, boolean isSalted)	Constructs the ChaosOptionsImpl with the given values.
ChaosOptionsImpl(boolean isMutateS, boolean isXorNext, boolean isSalted, short aRndPrefixSize)	Constructs the ChaosOptionsImpl with the given values.
ChaosOptionsImpl(byte[] aEncoded)	Instantiates the ChaosOptions by reversing the result of the ChaosOptions.getEncoded() operation where the byte array contains the values of the options.

Method Summary

Modifier and Type	Method	Description
static ChaosOptionsImpl.Builder	builder()	Creates builder to build ChaosOptionsImpl.
boolean	equals(Object obj)	Returns true if all the passed object is of type ChaosOptions and all the attributes from the ChaosOptions are equal to this instance's attributes (as of ChaosOptions.isMutateS(), ChaosOptions.isXorNext() and ChaosOptions.isSalted()).
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.
int	hashCode()
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()

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

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

getEncoded, hasRndPrefix, isFixedLength

Constructor Details

ChaosOptionsImpl

public ChaosOptionsImpl(byte[] aEncoded)

Instantiates the ChaosOptions by reversing the result of the ChaosOptions.getEncoded() operation where the byte array contains the values of the options. The values use a big endian representation. The byte array being passed is to be of the size as returned by ChaosOptions.getEncodedLength(). The meaning of the bits in the encoded byte are defined as in ChaosOptions.OPTIONS_BIT_MUTATE_S, ChaosOptions.OPTIONS_BIT_XOR_NEXT and ChaosOptions.OPTIONS_BIT_SALTED.

Parameters:

aEncoded - The encoded representation of the options.

ChaosOptionsImpl

public ChaosOptionsImpl(boolean isMutateS,
 boolean isXorNext,
 boolean isSalted)

Constructs the ChaosOptionsImpl with the given values.

Parameters:

isMutateS - Enables or disables the isMutateS() option.

isXorNext - Enables or disables the isXorNext() option.

isSalted - Enables or disables the isSalted() option.

ChaosOptionsImpl

public ChaosOptionsImpl(boolean isMutateS,
 boolean isXorNext,
 boolean isSalted,
 short aRndPrefixSize)

Constructs the ChaosOptionsImpl with the given values.

Parameters:

isMutateS - Enables or disables the isMutateS() option.

isXorNext - Enables or disables the isXorNext() option.

isSalted - Enables or disables the isSalted() option.

aRndPrefixSize - The number of bytes to prefix with random bytes.

Method Details

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 Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

equals

public boolean equals(Object obj)

Returns true if all the passed object is of type ChaosOptions and all the attributes from the ChaosOptions are equal to this instance's attributes (as of ChaosOptions.isMutateS(), ChaosOptions.isXorNext() and ChaosOptions.isSalted()).

Specified by:

equals in interface ChaosOptions

Overrides:

equals in class Object

Parameters:

obj - the object to compare with for equality.

Returns:

true, if equal

builder

public static ChaosOptionsImpl.Builder builder()

Creates builder to build ChaosOptionsImpl.

Returns:

created builder