Package org.wildfly.security.util

Class PasswordBasedEncryptionUtil.Builder

java.lang.Object

org.wildfly.security.util.PasswordBasedEncryptionUtil.Builder

Enclosing class:

PasswordBasedEncryptionUtil

public static class PasswordBasedEncryptionUtil.Builder
extends Object

Builder class to build PasswordBasedEncryptionUtil class with all necessary parameters to support password based encryption algorithms.

Constructor Summary

Constructors

Constructor	Description
Builder()

Method Summary

Modifier and Type	Method	Description
PasswordBasedEncryptionUtil.Builder	algorithmParameters(AlgorithmParameters algorithmParameters)	Set algorithm parameters for Cipher initialization.
PasswordBasedEncryptionUtil.Builder	alphabet(Alphabet alphabet)	Set the alphabet to encode/decode result of encryption/decryption.
PasswordBasedEncryptionUtil	build()	Builds PBE utility class instance
PasswordBasedEncryptionUtil.Builder	cipherIteration(int cipherIteration)	Set the number of iterations for Cipher
PasswordBasedEncryptionUtil.Builder	cipherSalt(byte[] cipherSalt)	Set salt for the Cipher
PasswordBasedEncryptionUtil.Builder	cipherSalt(String cipherSalt)	Set salt for the Cipher
PasswordBasedEncryptionUtil.Builder	decryptMode()	Set decryption mode for chosen Cipher
PasswordBasedEncryptionUtil.Builder	encodingPadded()	Use padding when encoding/decoding binary data.
PasswordBasedEncryptionUtil.Builder	encryptMode()	Set encryption mode for chosen Cipher
PasswordBasedEncryptionUtil.Builder	iteration(int iteration)	Set number of iteration for key derivation.
PasswordBasedEncryptionUtil.Builder	iv(byte[] iv)	Set initialization vector for use with AES algorithms
PasswordBasedEncryptionUtil.Builder	iv(String encodedIV)	Set initialization vector for use with AES algorithms
PasswordBasedEncryptionUtil.Builder	keyAlgorithm(String keyAlgorithm)	Set the key derivation algorithm.
PasswordBasedEncryptionUtil.Builder	keyLength(int keyLength)	Set the key length.
PasswordBasedEncryptionUtil.Builder	parametersAlgorithm(String parametersAlgorithm)	Set the name of parameter's algorithm to initialize the Cipher
PasswordBasedEncryptionUtil.Builder	password(char[] password)	Set password to use to generate the encryption key
PasswordBasedEncryptionUtil.Builder	password(String password)	Set password to use to generate the encryption key
PasswordBasedEncryptionUtil.Builder	picketBoxCompatibility()	Use PicketBox compatibility mode for producing exact output as using PBE for MASK- purpose.
PasswordBasedEncryptionUtil.Builder	provider(String providerName)	Set the JCA provider name which contains all classes needed by built utility class.
PasswordBasedEncryptionUtil.Builder	provider(Provider provider)	Set the JCA provider which contains all classes needed by built utility class.
PasswordBasedEncryptionUtil.Builder	salt(byte[] salt)	Set salt for key derivation.
PasswordBasedEncryptionUtil.Builder	salt(String salt)	Set salt for key derivation.
PasswordBasedEncryptionUtil.Builder	transformation(String transformation)	Transformation name to use as Cipher parameter.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

Builder

public Builder()

Method Details

password

public PasswordBasedEncryptionUtil.Builder password(char[] password)

Set password to use to generate the encryption key

Parameters:

password - the password

Returns:

this Builder

password

public PasswordBasedEncryptionUtil.Builder password(String password)

Set password to use to generate the encryption key

Parameters:

password - the password

Returns:

this Builder

iv

public PasswordBasedEncryptionUtil.Builder iv(byte[] iv)

Set initialization vector for use with AES algorithms

Parameters:

iv - the raw IV

Returns:

this Builder

iv

public PasswordBasedEncryptionUtil.Builder iv(String encodedIV)

Set initialization vector for use with AES algorithms

Parameters:

encodedIV - IV encoded using Alphabet set in this builder (or default)

Returns:

this Builder

transformation

public PasswordBasedEncryptionUtil.Builder transformation(String transformation)

Transformation name to use as Cipher parameter.

Parameters:

transformation - the name of transformation

Returns:

this Builder

parametersAlgorithm

public PasswordBasedEncryptionUtil.Builder parametersAlgorithm(String parametersAlgorithm)

Set the name of parameter's algorithm to initialize the Cipher

Parameters:

parametersAlgorithm - the name of parameter's algorithm

Returns:

this Builder

salt

public PasswordBasedEncryptionUtil.Builder salt(String salt)

Set salt for key derivation.

Parameters:

salt - the salt

Returns:

this Builder

salt

public PasswordBasedEncryptionUtil.Builder salt(byte[] salt)

Set salt for key derivation.

Parameters:

salt - the salt

Returns:

this Builder

picketBoxCompatibility

public PasswordBasedEncryptionUtil.Builder picketBoxCompatibility()

Use PicketBox compatibility mode for producing exact output as using PBE for MASK- purpose. Problem is that PicketBox is using different base64 than standard. Default is false.

Returns:

this Builder

encodingPadded

public PasswordBasedEncryptionUtil.Builder encodingPadded()

Use padding when encoding/decoding binary data.

Returns:

this Builder

iteration

public PasswordBasedEncryptionUtil.Builder iteration(int iteration)

Set number of iteration for key derivation.

Parameters:

iteration - the number of iterations

Returns:

this Builder

keyAlgorithm

public PasswordBasedEncryptionUtil.Builder keyAlgorithm(String keyAlgorithm)

Set the key derivation algorithm.

Parameters:

keyAlgorithm - the algorithm

Returns:

this Builder

keyLength

public PasswordBasedEncryptionUtil.Builder keyLength(int keyLength)

Set the key length.

Parameters:

keyLength - the length

Returns:

this Builder

cipherIteration

public PasswordBasedEncryptionUtil.Builder cipherIteration(int cipherIteration)

Set the number of iterations for Cipher

Parameters:

cipherIteration - number of iterations

Returns:

this Builder

cipherSalt

public PasswordBasedEncryptionUtil.Builder cipherSalt(byte[] cipherSalt)

Set salt for the Cipher

Parameters:

cipherSalt - the salt

Returns:

this Builder

cipherSalt

public PasswordBasedEncryptionUtil.Builder cipherSalt(String cipherSalt)

Set salt for the Cipher

Parameters:

cipherSalt - the salt

Returns:

this Builder

provider

public PasswordBasedEncryptionUtil.Builder provider(Provider provider)

Set the JCA provider which contains all classes needed by built utility class.

Parameters:

provider - the provider

Returns:

this Builder

provider

public PasswordBasedEncryptionUtil.Builder provider(String providerName)

Set the JCA provider name which contains all classes needed by built utility class.

Parameters:

providerName - the provider name

Returns:

this Builder

alphabet

public PasswordBasedEncryptionUtil.Builder alphabet(Alphabet alphabet)

Set the alphabet to encode/decode result of encryption/decryption.

Parameters:

alphabet - the Alphabet instance

Returns:

this Builder

encryptMode

public PasswordBasedEncryptionUtil.Builder encryptMode()

Set encryption mode for chosen Cipher

Returns:

this Builder

decryptMode

public PasswordBasedEncryptionUtil.Builder decryptMode()

Set decryption mode for chosen Cipher

Returns:

this Builder

algorithmParameters

public PasswordBasedEncryptionUtil.Builder algorithmParameters(AlgorithmParameters algorithmParameters)

Set algorithm parameters for Cipher initialization.

Parameters:

algorithmParameters - the algorithm parameters instance in form required by the used Cipher

Returns:

this Builder

build

public PasswordBasedEncryptionUtil build()
                                  throws GeneralSecurityException

Builds PBE utility class instance

Returns:

PBE utility class instance PasswordBasedEncryptionUtil

Throws:

GeneralSecurityException - when something goes wrong while initializing encryption related objects