com.oracle.bmc.keymanagement

Class KmsCryptoClient

java.lang.Object

com.oracle.bmc.http.internal.BaseSyncClient

com.oracle.bmc.keymanagement.KmsCryptoClient

All Implemented Interfaces:

KmsCrypto, AutoCloseable

@Generated(value="OracleSDKGenerator",
           comments="API Version: release")
public class KmsCryptoClient
extends BaseSyncClient
implements KmsCrypto

Field Summary

Fields

Modifier and Type	Field and Description
String	clientCommonLibraryVersion Compatible SDK version, provided by the codegen.
Optional<String>	minimumClientCommonLibraryVersionFromClient Minimum compatible SDK version, maybe provided by the codegen.
static Service	SERVICE Service instance for KmsCrypto.

Constructor Summary

Constructors

Constructor and Description
KmsCryptoClient(AbstractAuthenticationDetailsProvider authenticationDetailsProvider, ClientConfiguration configuration, ClientConfigurator clientConfigurator, RequestSignerFactory defaultRequestSignerFactory) Deprecated. Use the builder instead.
KmsCryptoClient(AbstractAuthenticationDetailsProvider authenticationDetailsProvider, ClientConfiguration configuration, ClientConfigurator clientConfigurator, RequestSignerFactory defaultRequestSignerFactory, List<ClientConfigurator> additionalClientConfigurators) Deprecated. Use the builder instead.
KmsCryptoClient(AbstractAuthenticationDetailsProvider authenticationDetailsProvider, ClientConfiguration configuration, ClientConfigurator clientConfigurator, RequestSignerFactory defaultRequestSignerFactory, List<ClientConfigurator> additionalClientConfigurators, String endpoint) Deprecated. Use the builder instead.
KmsCryptoClient(AbstractAuthenticationDetailsProvider authenticationDetailsProvider, ClientConfiguration configuration, ClientConfigurator clientConfigurator, RequestSignerFactory defaultRequestSignerFactory, Map<SigningStrategy,RequestSignerFactory> signingStrategyRequestSignerFactories, List<ClientConfigurator> additionalClientConfigurators, String endpoint) Deprecated. Use the builder instead.
KmsCryptoClient(BasicAuthenticationDetailsProvider authenticationDetailsProvider) Deprecated. Use the builder instead.
KmsCryptoClient(BasicAuthenticationDetailsProvider authenticationDetailsProvider, ClientConfiguration configuration) Deprecated. Use the builder instead.
KmsCryptoClient(BasicAuthenticationDetailsProvider authenticationDetailsProvider, ClientConfiguration configuration, ClientConfigurator clientConfigurator) Deprecated. Use the builder instead.

Method Summary

Modifier and Type	Method and Description
static KmsCryptoClientBuilder	builder() Create a builder for this client.
void	close()
DecryptResponse	decrypt(DecryptRequest request) Decrypts data using the given DecryptDataDetails resource.
EncryptResponse	encrypt(EncryptRequest request) Encrypts data using the given EncryptDataDetails resource.
ExportKeyResponse	exportKey(ExportKeyRequest request) Exports a specific version of a master encryption key according to the details of the request.
GenerateDataEncryptionKeyResponse	generateDataEncryptionKey(GenerateDataEncryptionKeyRequest request) Generates a key that you can use to encrypt or decrypt data.
String	getClientCommonLibraryVersion()
protected ClientConfigurator	getDefaultConfigurator()
String	getEndpoint()
Optional<String>	getMinimumClientCommonLibraryVersionFromClient()
void	populateServiceParametersInEndpoint(String endpoint, Map<String,Object> requiredParametersMap) Populate the parameters in the endpoint with its corresponding value and update the base endpoint.
void	refreshClient() Rebuild the backing HttpClient.
void	setEndpoint(String endpoint)
protected void	setRegion(Region region)
protected void	setRegion(String regionId)
SignResponse	sign(SignRequest request) Creates a digital signature for a message or message digest by using the private key of a public-private key pair, also known as an asymmetric key.
void	updateBaseEndpoint(String endpoint) This method should be used for parameterized endpoint templates only.
void	useRealmSpecificEndpointTemplate(boolean useOfRealmSpecificEndpointTemplateEnabled) This method should be used to enable or disable the use of realm-specific endpoint template.
VerifyResponse	verify(VerifyRequest request) Verifies a digital signature that was generated by the Sign operation by using the public key of the same asymmetric key that was used to sign the data.

Methods inherited from class com.oracle.bmc.http.internal.BaseSyncClient

clientCall

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.oracle.bmc.keymanagement.KmsCrypto

getEndpoint, refreshClient, setEndpoint

Methods inherited from interface java.lang.AutoCloseable

close

Field Detail

SERVICE

public static final Service SERVICE

Service instance for KmsCrypto.

clientCommonLibraryVersion

public final String clientCommonLibraryVersion

Compatible SDK version, provided by the codegen.

minimumClientCommonLibraryVersionFromClient

public final Optional<String> minimumClientCommonLibraryVersionFromClient

Minimum compatible SDK version, maybe provided by the codegen.

Constructor Detail

KmsCryptoClient

@Deprecated
public KmsCryptoClient(BasicAuthenticationDetailsProvider authenticationDetailsProvider)

Deprecated. Use the builder instead.

Create a new client instance.

Parameters:

authenticationDetailsProvider - The authentication details (see Builder#build)

KmsCryptoClient

@Deprecated
public KmsCryptoClient(BasicAuthenticationDetailsProvider authenticationDetailsProvider,
                                   ClientConfiguration configuration)

Deprecated. Use the builder instead.

Create a new client instance.

Parameters:

authenticationDetailsProvider - The authentication details (see Builder#build)

configuration - Builder#configuration

KmsCryptoClient

@Deprecated
public KmsCryptoClient(BasicAuthenticationDetailsProvider authenticationDetailsProvider,
                                   ClientConfiguration configuration,
                                   ClientConfigurator clientConfigurator)

Deprecated. Use the builder instead.

Create a new client instance.

Parameters:

authenticationDetailsProvider - The authentication details (see Builder#build)

configuration - Builder#configuration

clientConfigurator - Builder#clientConfigurator

KmsCryptoClient

@Deprecated
public KmsCryptoClient(AbstractAuthenticationDetailsProvider authenticationDetailsProvider,
                                   ClientConfiguration configuration,
                                   ClientConfigurator clientConfigurator,
                                   RequestSignerFactory defaultRequestSignerFactory)

Deprecated. Use the builder instead.

Create a new client instance.

Parameters:

authenticationDetailsProvider - The authentication details (see Builder#build)

configuration - Builder#configuration

clientConfigurator - Builder#clientConfigurator

defaultRequestSignerFactory - Builder#requestSignerFactory

KmsCryptoClient

@Deprecated
public KmsCryptoClient(AbstractAuthenticationDetailsProvider authenticationDetailsProvider,
                                   ClientConfiguration configuration,
                                   ClientConfigurator clientConfigurator,
                                   RequestSignerFactory defaultRequestSignerFactory,
                                   List<ClientConfigurator> additionalClientConfigurators)

Deprecated. Use the builder instead.

Create a new client instance.

Parameters:

authenticationDetailsProvider - The authentication details (see Builder#build)

configuration - Builder#configuration

clientConfigurator - Builder#clientConfigurator

defaultRequestSignerFactory - Builder#requestSignerFactory

additionalClientConfigurators - Builder#additionalClientConfigurators

KmsCryptoClient

@Deprecated
public KmsCryptoClient(AbstractAuthenticationDetailsProvider authenticationDetailsProvider,
                                   ClientConfiguration configuration,
                                   ClientConfigurator clientConfigurator,
                                   RequestSignerFactory defaultRequestSignerFactory,
                                   List<ClientConfigurator> additionalClientConfigurators,
                                   String endpoint)

Deprecated. Use the builder instead.

Create a new client instance.

Parameters:

authenticationDetailsProvider - The authentication details (see Builder#build)

configuration - Builder#configuration

clientConfigurator - Builder#clientConfigurator

defaultRequestSignerFactory - Builder#requestSignerFactory

additionalClientConfigurators - Builder#additionalClientConfigurators

endpoint - Builder#endpoint

KmsCryptoClient

@Deprecated
public KmsCryptoClient(AbstractAuthenticationDetailsProvider authenticationDetailsProvider,
                                   ClientConfiguration configuration,
                                   ClientConfigurator clientConfigurator,
                                   RequestSignerFactory defaultRequestSignerFactory,
                                   Map<SigningStrategy,RequestSignerFactory> signingStrategyRequestSignerFactories,
                                   List<ClientConfigurator> additionalClientConfigurators,
                                   String endpoint)

Deprecated. Use the builder instead.

Create a new client instance.

Parameters:

authenticationDetailsProvider - The authentication details (see Builder#build)

configuration - Builder#configuration

clientConfigurator - Builder#clientConfigurator

defaultRequestSignerFactory - Builder#requestSignerFactory

additionalClientConfigurators - Builder#additionalClientConfigurators

endpoint - Builder#endpoint

signingStrategyRequestSignerFactories - Builder#signingStrategyRequestSignerFactories

Method Detail

builder

public static KmsCryptoClientBuilder builder()

Create a builder for this client.

Returns:

builder

decrypt

public DecryptResponse decrypt(DecryptRequest request)

Description copied from interface: KmsCrypto

Decrypts data using the given DecryptDataDetails resource.

Specified by:

decrypt in interface KmsCrypto

Parameters:

request - The request object containing the details to send

Returns:

A response object containing details about the completed operation

encrypt

public EncryptResponse encrypt(EncryptRequest request)

Description copied from interface: KmsCrypto

Encrypts data using the given EncryptDataDetails resource. Plaintext included in the example request is a base64-encoded value of a UTF-8 string.

Specified by:

encrypt in interface KmsCrypto

Parameters:

request - The request object containing the details to send

Returns:

A response object containing details about the completed operation

exportKey

public ExportKeyResponse exportKey(ExportKeyRequest request)

Description copied from interface: KmsCrypto

Exports a specific version of a master encryption key according to the details of the request. For their protection, keys that you create and store on a hardware security module (HSM) can never leave the HSM. You can only export keys stored on the server. For export, the key version is encrypted by an RSA public key that you provide. This operation is not supported for keys having protection mode EXTERNAL.

Specified by:

exportKey in interface KmsCrypto

Parameters:

request - The request object containing the details to send

Returns:

A response object containing details about the completed operation

generateDataEncryptionKey

public GenerateDataEncryptionKeyResponse generateDataEncryptionKey(GenerateDataEncryptionKeyRequest request)

Description copied from interface: KmsCrypto

Generates a key that you can use to encrypt or decrypt data.

Specified by:

generateDataEncryptionKey in interface KmsCrypto

Parameters:

request - The request object containing the details to send

Returns:

A response object containing details about the completed operation

sign

public SignResponse sign(SignRequest request)

Description copied from interface: KmsCrypto

Creates a digital signature for a message or message digest by using the private key of a public-private key pair, also known as an asymmetric key. To verify the generated signature, you can use the Verify operation. Or, if you want to validate the signature outside of the service, you can do so by using the public key of the same asymmetric key. This operation is not supported for keys having protection mode EXTERNAL.

Specified by:

sign in interface KmsCrypto

Parameters:

request - The request object containing the details to send

Returns:

A response object containing details about the completed operation

verify

public VerifyResponse verify(VerifyRequest request)

Description copied from interface: KmsCrypto

Verifies a digital signature that was generated by the Sign operation by using the public key of the same asymmetric key that was used to sign the data. If you want to validate the digital signature outside of the service, you can do so by using the public key of the asymmetric key. This operation is not supported for keys having protection mode EXTERNAL.

Specified by:

verify in interface KmsCrypto

Parameters:

request - The request object containing the details to send

Returns:

A response object containing details about the completed operation

getDefaultConfigurator

protected ClientConfigurator getDefaultConfigurator()

useRealmSpecificEndpointTemplate

public void useRealmSpecificEndpointTemplate(boolean useOfRealmSpecificEndpointTemplateEnabled)

This method should be used to enable or disable the use of realm-specific endpoint template. The default value is null. To enable the use of endpoint template defined for the realm in use, set the flag to true To disable the use of endpoint template defined for the realm in use, set the flag to false

Parameters:

useOfRealmSpecificEndpointTemplateEnabled - This flag can be set to true or false to enable or disable the use of realm-specific endpoint template respectively

populateServiceParametersInEndpoint

public final void populateServiceParametersInEndpoint(String endpoint,
                                                      Map<String,Object> requiredParametersMap)

Populate the parameters in the endpoint with its corresponding value and update the base endpoint. The value will be populated iff the parameter in endpoint is a required request path parameter or a required request query parameter. If not, the parameter in the endpoint will be ignored and left blank.

Parameters:

endpoint - The endpoint template in use

requiredParametersMap - Map of parameter name as key and value set in request path or query parameter as value

updateBaseEndpoint

public final void updateBaseEndpoint(String endpoint)

This method should be used for parameterized endpoint templates only. This does not include {region} and {secondLevelDomain} parameters.

Parameters:

endpoint - The updated endpoint to use

setEndpoint

public final void setEndpoint(String endpoint)

getEndpoint

public final String getEndpoint()

refreshClient

public final void refreshClient()

Rebuild the backing HttpClient. This will call ClientConfigurators again, and can be used to e.g. refresh the SSL certificate.

setRegion

protected void setRegion(Region region)

setRegion

protected void setRegion(String regionId)

close

public final void close()

Specified by:

close in interface AutoCloseable

getClientCommonLibraryVersion

public String getClientCommonLibraryVersion()

getMinimumClientCommonLibraryVersionFromClient

public Optional<String> getMinimumClientCommonLibraryVersionFromClient()