Package org.apache.hadoop.fs.azurebfs.extensions

Interface EncryptionContextProvider

All Superinterfaces:

javax.security.auth.Destroyable

public interface EncryptionContextProvider
extends javax.security.auth.Destroyable

This interface has two roles:

• To create new encryptionContext from a given path: To be used in case of create file as there is no encryptionContext in remote server to refer to for encryptionKey creation.
• To create encryptionKey using encryptionContext.

Method Summary

Modifier and Type	Method	Description
ABFSKey	getEncryptionContext(java.lang.String path)	Fetch encryption context for a given path.
ABFSKey	getEncryptionKey(java.lang.String path, ABFSKey encryptionContext)	Fetch encryption key in-exchange for encryption context.
void	initialize(org.apache.hadoop.conf.Configuration configuration, java.lang.String accountName, java.lang.String fileSystem)	Initialize instance.

Methods inherited from interface javax.security.auth.Destroyable

destroy, isDestroyed

Method Detail

initialize

void initialize(org.apache.hadoop.conf.Configuration configuration,
                java.lang.String accountName,
                java.lang.String fileSystem)
         throws java.io.IOException

Initialize instance.

Parameters:

configuration - rawConfig instance

accountName - Account Name (with domain)

fileSystem - container name

Throws:

java.io.IOException - error in initialization

getEncryptionContext

ABFSKey getEncryptionContext(java.lang.String path)
                      throws java.io.IOException

Fetch encryption context for a given path.

Parameters:

path - file path from filesystem root

Returns:

encryptionContext key

Throws:

java.io.IOException - error in fetching encryption context

getEncryptionKey

ABFSKey getEncryptionKey(java.lang.String path,
                         ABFSKey encryptionContext)
                  throws java.io.IOException

Fetch encryption key in-exchange for encryption context.

Parameters:

path - file path from filesystem root

encryptionContext - encryptionContext fetched from server

Returns:

Encryption key

Throws:

java.io.IOException - error in fetching encryption key