io.minio

Class ServerSideEncryption

java.lang.Object

io.minio.ServerSideEncryption

All Implemented Interfaces:

Destroyable

Direct Known Subclasses:

ServerSideEncryptionCustomerKey

public abstract class ServerSideEncryption
extends Object
implements Destroyable

Server-side encryption options.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	ServerSideEncryption.Type The types of server-side encryption.

Field Summary

Fields

Modifier and Type	Field and Description
protected boolean	destroyed

Constructor Summary

Constructors

Constructor and Description
ServerSideEncryption()

Method Summary

Modifier and Type	Method and Description
static ServerSideEncryption	atRest() Create a new server-side-encryption object for encryption at rest (a.k.a.
Map<String,String>	copySourceHeaders() Returns server side encryption headers for source object in Put Object - Copy.
abstract Map<String,String>	headers() Returns server side encryption headers.
boolean	isDestroyed()
abstract ServerSideEncryption.Type	type() Returns server side encryption type.
static ServerSideEncryptionCustomerKey	withCustomerKey(SecretKey key) Create a new server-side-encryption object for encryption with customer provided keys (a.k.a.
static ServerSideEncryption	withManagedKeys(String keyId, Map<String,String> context) Create a new server-side-encryption object for encryption using a KMS (a.k.a.

Methods inherited from class java.lang.Object

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

Methods inherited from interface javax.security.auth.Destroyable

destroy

Field Detail

destroyed

protected boolean destroyed

Constructor Detail

ServerSideEncryption

public ServerSideEncryption()

Method Detail

type

public abstract ServerSideEncryption.Type type()

Returns server side encryption type.

headers

public abstract Map<String,String> headers()

Returns server side encryption headers.

copySourceHeaders

public Map<String,String> copySourceHeaders()
                                     throws IllegalArgumentException

Returns server side encryption headers for source object in Put Object - Copy.

Throws:

IllegalArgumentException

isDestroyed

public boolean isDestroyed()

Specified by:

isDestroyed in interface Destroyable

withCustomerKey

public static ServerSideEncryptionCustomerKey withCustomerKey(SecretKey key)
                                                       throws InvalidKeyException,
                                                              NoSuchAlgorithmException

Create a new server-side-encryption object for encryption with customer provided keys (a.k.a. SSE-C).

Parameters:

key - The secret AES-256 key.

Returns:

An instance of ServerSideEncryption implementing SSE-C.

Throws:

InvalidKeyException - if the provided secret key is not a 256 bit AES key.

NoSuchAlgorithmException - if the crypto provider does not implement MD5.

atRest

public static ServerSideEncryption atRest()

Create a new server-side-encryption object for encryption at rest (a.k.a. SSE-S3).

Returns:

an instance of ServerSideEncryption implementing SSE-S3

withManagedKeys

public static ServerSideEncryption withManagedKeys(String keyId,
                                                   Map<String,String> context)
                                            throws IllegalArgumentException,
                                                   UnsupportedEncodingException

Create a new server-side-encryption object for encryption using a KMS (a.k.a. SSE-KMS).

Parameters:

keyId - specifies the customer-master-key (CMK) and must not be null.

context - is the encryption context. If the context is null no context is used.

Returns:

an instance of ServerSideEncryption implementing SSE-KMS.

Throws:

IllegalArgumentException

UnsupportedEncodingException