com.ibm.cloud.objectstorage.services.s3.model

Class CryptoConfiguration

java.lang.Object

com.ibm.cloud.objectstorage.services.s3.model.CryptoConfiguration

All Implemented Interfaces:

Serializable, Cloneable

Deprecated.

This feature is in maintenance mode, no new updates will be released. Please see https://docs.aws.amazon.com/general/latest/gr/aws_sdk_cryptography.html for more information.

@Deprecated
public class CryptoConfiguration
extends Object
implements Cloneable, Serializable

Stores configuration parameters that will be used during encryption and decryption by the Amazon S3 Encryption Client. With this object, you can set the encryption client to use Instruction Files or Object Metadata for storing encryption information. You can also specify your own crypto provider to be used during encryption and decryption.

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
CryptoConfiguration() Deprecated. Creates a new CryptoConfiguration object with default storage mode and crypto provider settings.
CryptoConfiguration(CryptoMode cryptoMode) Deprecated.

Method Summary

Modifier and Type	Method and Description
CryptoConfiguration	clone() Deprecated.
boolean	getAlwaysUseCryptoProvider() Deprecated. Returns true if the specified crypto provider should be used in all cases.
CryptoMode	getCryptoMode() Deprecated. Returns the optionally specified crypto mode applicable only to the S3 encryption client; or null.
Provider	getCryptoProvider() Deprecated. Returns the crypto provider whose encryption implementation will be used to encrypt and decrypt data.
SecureRandom	getSecureRandom() Deprecated. Returns the SecureRandom instance that will be used to generate cryptographic parameters.
CryptoStorageMode	getStorageMode() Deprecated. Returns the current storage mode of a CryptoConfiguration object.
boolean	isIgnoreMissingInstructionFile() Deprecated. Returns true to ignore instruction file that cannot be found during a GET operation; false otherwise.
boolean	isReadOnly() Deprecated.
CryptoConfiguration	readOnly() Deprecated. Returns a read-only copy of this configuration.
void	setAlwaysUseCryptoProvider(boolean value) Deprecated. Sets whether the specified crypto provider should be used in all cases.
void	setCryptoMode(CryptoMode cryptoMode) Deprecated. Sets the crypto mode; applicable only to the S3 encryption client.
void	setCryptoProvider(Provider cryptoProvider) Deprecated. Sets the crypto provider to the specified provider.
void	setIgnoreMissingInstructionFile(boolean ignoreMissingInstructionFile) Deprecated.
void	setSecureRandom(SecureRandom secureRandom) Deprecated. Sets the secure random instance to use for generating cryptographic parameters.
void	setStorageMode(CryptoStorageMode storageMode) Deprecated. Sets the storage mode to the specified mode.
CryptoConfiguration	withAlwaysUseCryptoProvider(boolean value) Deprecated. Sets whether the specified crypto provider should be used in all cases.
CryptoConfiguration	withCryptoMode(CryptoMode cryptoMode) Deprecated. Fluent API to set the crypto mode; applicable only to the S3 encryption client.
CryptoConfiguration	withCryptoProvider(Provider cryptoProvider) Deprecated. Sets the crypto provider to the specified provider, and returns the updated CryptoConfiguration object.
CryptoConfiguration	withIgnoreMissingInstructionFile(boolean ignoreMissingInstructionFile) Deprecated. Fluent API to set the property to ignore instruction file that cannot be found during a GET operation.
CryptoConfiguration	withSecureRandom(SecureRandom secureRandom) Deprecated. Sets the secure random instance to use for generating cryptographic parameters, and returns this object.
CryptoConfiguration	withStorageMode(CryptoStorageMode storageMode) Deprecated. Sets the storage mode to the specified mode, and returns the updated CryptoConfiguration object.

Methods inherited from class java.lang.Object

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

Constructor Detail

CryptoConfiguration

public CryptoConfiguration()

Deprecated.

Creates a new CryptoConfiguration object with default storage mode and crypto provider settings. The default storage mode is the Object Metadata storage mode, and the default crypto provider is the JCE provider.

CryptoConfiguration

public CryptoConfiguration(CryptoMode cryptoMode)

Deprecated.

Parameters:

cryptoMode - cryptographic mode to be used

Throws:

UnsupportedOperationException - if the necessary security provider cannot be found or the necessary cryptographic operations are not supported for the specified crypto mode.

Method Detail

setStorageMode

public void setStorageMode(CryptoStorageMode storageMode)

Deprecated.

Sets the storage mode to the specified mode.

Parameters:

storageMode - The storage mode to be used for storing encryption information.

withStorageMode

public CryptoConfiguration withStorageMode(CryptoStorageMode storageMode)

Deprecated.

Sets the storage mode to the specified mode, and returns the updated CryptoConfiguration object.

Parameters:

storageMode - The storage mode to be used for storing encryption information.

Returns:

The updated CryptoConfiguration object.

getStorageMode

public CryptoStorageMode getStorageMode()

Deprecated.

Returns the current storage mode of a CryptoConfiguration object.

Returns:

The storage mode to be used for storing encryption information.

setCryptoProvider

public void setCryptoProvider(Provider cryptoProvider)

Deprecated.

Sets the crypto provider to the specified provider.

Parameters:

cryptoProvider - The crypto provider whose encryption implementation will be used to encrypt and decrypt data.

withCryptoProvider

public CryptoConfiguration withCryptoProvider(Provider cryptoProvider)

Deprecated.

Sets the crypto provider to the specified provider, and returns the updated CryptoConfiguration object.

Parameters:

cryptoProvider - The crypto provider whose encryption implementation will be used to encrypt and decrypt data.

Returns:

The updated CryptoConfiguration object.

getCryptoProvider

public Provider getCryptoProvider()

Deprecated.

Returns the crypto provider whose encryption implementation will be used to encrypt and decrypt data.

Returns:

the crypto provider whose encryption implementation will be used to encrypt and decrypt data.

setAlwaysUseCryptoProvider

public void setAlwaysUseCryptoProvider(boolean value)

Deprecated.

Sets whether the specified crypto provider should be used in all cases. For backwards compatibility, it will be ignored if CryptoMode specified authenticated encryption.

withAlwaysUseCryptoProvider

public CryptoConfiguration withAlwaysUseCryptoProvider(boolean value)

Deprecated.

Sets whether the specified crypto provider should be used in all cases. For backwards compatibility, it will be ignored if CryptoMode specified authenticated encryption.

getAlwaysUseCryptoProvider

public boolean getAlwaysUseCryptoProvider()

Deprecated.

Returns true if the specified crypto provider should be used in all cases. For backwards compatibility, it will be ignored if CryptoMode specifies authenticated encryption.

Returns:

true if the crypto provider should always be used

getSecureRandom

public SecureRandom getSecureRandom()

Deprecated.

Returns the SecureRandom instance that will be used to generate cryptographic parameters.

setSecureRandom

public void setSecureRandom(SecureRandom secureRandom)

Deprecated.

Sets the secure random instance to use for generating cryptographic parameters.

withSecureRandom

public CryptoConfiguration withSecureRandom(SecureRandom secureRandom)

Deprecated.

Sets the secure random instance to use for generating cryptographic parameters, and returns this object.

getCryptoMode

public CryptoMode getCryptoMode()

Deprecated.

Returns the optionally specified crypto mode applicable only to the S3 encryption client; or null. This attribute is ignored if the S3 encryption client is not in use.

setCryptoMode

public void setCryptoMode(CryptoMode cryptoMode)
                   throws UnsupportedOperationException

Deprecated.

Sets the crypto mode; applicable only to the S3 encryption client.

Throws:

UnsupportedOperationException - if the necessary security provider cannot be found or the necessary cryptographic operations are not supported for the specified crypto mode. Note the crypto mode can and will still (intentionally) be set in such case, and it's up to the caller to decide what to do about it.

withCryptoMode

public CryptoConfiguration withCryptoMode(CryptoMode cryptoMode)
                                   throws UnsupportedOperationException

Deprecated.

Fluent API to set the crypto mode; applicable only to the S3 encryption client.

Throws:

UnsupportedOperationException - if the necessary security provider cannot be found or the necessary cryptographic operations are not supported for the specified crypto mode.Note the crypto mode can and will still (intentionally) be set in such case, and it's up to the caller to decide what to do about it.

isIgnoreMissingInstructionFile

public boolean isIgnoreMissingInstructionFile()

Deprecated.

Returns true to ignore instruction file that cannot be found during a GET operation; false otherwise. Default is true. This property is ignored if the crypto mode is CryptoMode.StrictAuthenticatedEncryption where missing instruction file would always cause security exception.

setIgnoreMissingInstructionFile

public void setIgnoreMissingInstructionFile(boolean ignoreMissingInstructionFile)

Deprecated.

Parameters:

ignoreMissingInstructionFile - true to ignore instruction file that cannot be found during a GET operation; false otherwise. Default is true. This property is ignored if the crypto mode is CryptoMode.StrictAuthenticatedEncryption where missing instruction file would always cause security exception.

withIgnoreMissingInstructionFile

public CryptoConfiguration withIgnoreMissingInstructionFile(boolean ignoreMissingInstructionFile)

Deprecated.

Fluent API to set the property to ignore instruction file that cannot be found during a GET operation.

isReadOnly

public boolean isReadOnly()

Deprecated.

readOnly

public CryptoConfiguration readOnly()

Deprecated.

Returns a read-only copy of this configuration.

clone

public CryptoConfiguration clone()

Deprecated.

Overrides:

clone in class Object