Package software.amazon.awssdk.crt.cal

Class EccKeyPair

java.lang.Object

software.amazon.awssdk.crt.CrtResource

software.amazon.awssdk.crt.cal.EccKeyPair

All Implemented Interfaces:

AutoCloseable

public final class EccKeyPair
extends CrtResource

This class puts an opaque wrapper around aws_ecc_key_pair from aws-c-cal. Currently, it is only intended to be cached and returned to native code by a signing invocation. If there's a compelling reason, we can add accessors and conversions to/from Java's KeyPair.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	EccKeyPair.AwsEccCurve	Enum for supported ECC curves Needs to stay in sync with aws_ecc_curve_name

Nested classes/interfaces inherited from class software.amazon.awssdk.crt.CrtResource

CrtResource.ResourceInstance

Method Summary

Modifier and Type	Method	Description
protected boolean	canReleaseReferencesImmediately()	Determines whether a resource releases its dependencies at the same time the native handle is released or if it waits.
static EccKeyPair	newDeriveFromCredentials(Credentials credentials, EccKeyPair.AwsEccCurve curve)	Derives the associated ECC key from a pair of AWS credentials according to the sigv4a ecc key derivation specification.
protected void	releaseNativeHandle()	Releases the instance's reference to the underlying native key pair
byte[]	signMessage(byte[] message)	Sign a message using the ECC key pair via ECDSA

Methods inherited from class software.amazon.awssdk.crt.CrtResource

acquireNativeHandle, addRef, addReferenceTo, close, collectNativeResource, collectNativeResources, decRef, getNativeHandle, getResourceLogDescription, isNull, logNativeResources, releaseReferences, removeReferenceTo, setDescription, swapReferenceTo, waitForNoResources

Methods inherited from class java.lang.Object

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

Method Detail

canReleaseReferencesImmediately

protected boolean canReleaseReferencesImmediately()

Determines whether a resource releases its dependencies at the same time the native handle is released or if it waits. Resources that wait are responsible for calling releaseReferences() manually.

Specified by:

canReleaseReferencesImmediately in class CrtResource

Returns:

true if this resource releases synchronously, false if this resource performs async shutdown

releaseNativeHandle

protected void releaseNativeHandle()

Releases the instance's reference to the underlying native key pair

Specified by:

releaseNativeHandle in class CrtResource

newDeriveFromCredentials

public static EccKeyPair newDeriveFromCredentials(Credentials credentials,
                                                  EccKeyPair.AwsEccCurve curve)

Derives the associated ECC key from a pair of AWS credentials according to the sigv4a ecc key derivation specification.

Parameters:

credentials - AWS credentials to derive the associated key for

curve - ECC curve to use (only P256 is currently supported)

Returns:

derived ecc key pair associated with the AWS credentials

signMessage

public byte[] signMessage(byte[] message)

Sign a message using the ECC key pair via ECDSA

Parameters:

message - message to sign

Returns:

the ECDSA signature of the message