org.eclipse.californium.scandium.dtls

Class EcdhPskClientKeyExchange

java.lang.Object

org.eclipse.californium.scandium.dtls.AbstractMessage

org.eclipse.californium.scandium.dtls.HandshakeMessage

org.eclipse.californium.scandium.dtls.ClientKeyExchange

org.eclipse.californium.scandium.dtls.ECDHClientKeyExchange

org.eclipse.californium.scandium.dtls.EcdhPskClientKeyExchange

All Implemented Interfaces:

DTLSMessage

public final class EcdhPskClientKeyExchange
extends ECDHClientKeyExchange

ClientKeyExchange message for PSK-ECDH based key exchange methods. Contains the client's ephemeral public key as encoded point and the PSK idenity. See RFC 5489 for details. It is assumed, that the client's ECDH public key is not in the client's certificate, so it must be provided here. According RFC 8422, 5.1.1. Supported Elliptic Curves Extension only "named curves" are valid, the "prime" and "char2" curve descriptions are deprecated. Also only "UNCOMPRESSED" as point format is valid, the other formats have been deprecated.

Field Summary

Fields inherited from class org.eclipse.californium.scandium.dtls.HandshakeMessage

FRAGMENT_LENGTH_BITS, FRAGMENT_OFFSET_BITS, MESSAGE_HEADER_LENGTH_BYTES, MESSAGE_LENGTH_BITS, MESSAGE_SEQ_BITS, MESSAGE_TYPE_BITS

Constructor Summary

Constructors

Constructor and Description
EcdhPskClientKeyExchange(PskPublicInformation identity, byte[] encodedPoint, InetSocketAddress peerAddress) Creates a new key exchange message for an identity hint and a public key.

Method Summary

Methods

Modifier and Type	Method and Description
static HandshakeMessage	fromReader(org.eclipse.californium.elements.util.DatagramReader reader, InetSocketAddress peerAddress) Creates a new client key exchange instance from its byte representation.
PskPublicInformation	getIdentity() This method returns the PSK identity as public information.
int	getMessageLength() Must be implemented by each subclass.
String	toString()
protected void	writeFragment(org.eclipse.californium.elements.util.DatagramWriter writer) Write fragment to writer.

Methods inherited from class org.eclipse.californium.scandium.dtls.ECDHClientKeyExchange

fragmentToByteArray, getEncodedPoint, readEncodedPoint

Methods inherited from class org.eclipse.californium.scandium.dtls.ClientKeyExchange

getMessageType

Methods inherited from class org.eclipse.californium.scandium.dtls.HandshakeMessage

fragmentChanged, fromByteArray, fromGenericHandshakeMessage, getContentType, getFragmentLength, getFragmentOffset, getMessageSeq, getNextHandshakeMessage, getRawMessage, setMessageSeq, setNextHandshakeMessage, size, toByteArray, writeTo

Methods inherited from class org.eclipse.californium.scandium.dtls.AbstractMessage

getPeer

Methods inherited from class java.lang.Object

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

Constructor Detail

EcdhPskClientKeyExchange

public EcdhPskClientKeyExchange(PskPublicInformation identity,
                        byte[] encodedPoint,
                        InetSocketAddress peerAddress)

Creates a new key exchange message for an identity hint and a public key.

Parameters:

identity - PSK identity as public information

encodedPoint - ephemeral public key as encoded point

peerAddress - peer's address

Throws:

NullPointerException - if either identity or clietPublicKey are null

Method Detail

writeFragment

protected void writeFragment(org.eclipse.californium.elements.util.DatagramWriter writer)

Write fragment to writer. Write the encoded point. Write the identity and encoded point.

Overrides:

writeFragment in class ECDHClientKeyExchange

Parameters:

writer - writer

fromReader

public static HandshakeMessage fromReader(org.eclipse.californium.elements.util.DatagramReader reader,
                          InetSocketAddress peerAddress)

Creates a new client key exchange instance from its byte representation.

Parameters:

reader - reader for the binary encoding of the message.

peerAddress - peer address

Returns:

created client key exchange message

Throws:

NullPointerException - if peerAddress is null

getMessageLength

public int getMessageLength()

Description copied from class: HandshakeMessage

Must be implemented by each subclass. The length is given in bytes and only includes the length of the subclass' specific fields (not the handshake message header).

Overrides:

getMessageLength in class ECDHClientKeyExchange

Returns:

the length of the message in bytes.

toString

public String toString()

Overrides:

toString in class ECDHClientKeyExchange

getIdentity

public PskPublicInformation getIdentity()

This method returns the PSK identity as public information.

Returns:

psk identity