org.eclipse.californium.scandium.dtls

Class EcdhPskServerKeyExchange

java.lang.Object

org.eclipse.californium.scandium.dtls.AbstractMessage

org.eclipse.californium.scandium.dtls.HandshakeMessage

org.eclipse.californium.scandium.dtls.ServerKeyExchange

org.eclipse.californium.scandium.dtls.ECDHServerKeyExchange

org.eclipse.californium.scandium.dtls.EcdhPskServerKeyExchange

All Implemented Interfaces:

DTLSMessage

public final class EcdhPskServerKeyExchange
extends ECDHServerKeyExchange

ServerKeyExchange message for PSK-ECDH based key exchange methods. Contains the server's ephemeral public key as encoded point and the PSK hint. See RFC 5489 for details. It is assumed, that the server's ECDH public key is not in the servers'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.

Nested Class Summary

Nested classes/interfaces inherited from class org.eclipse.californium.scandium.dtls.ECDHServerKeyExchange

ECDHServerKeyExchange.EcdhData

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
EcdhPskServerKeyExchange(PskPublicInformation pskHint, XECDHECryptography ecdhe, InetSocketAddress peerAddress) Creates a new key exchange message with psk hint as clear text and ServerDHParams.

Method Summary

Methods

Modifier and Type	Method and Description
byte[]	fragmentToByteArray() The serialization of the handshake body (without the handshake header).
static HandshakeMessage	fromReader(org.eclipse.californium.elements.util.DatagramReader reader, InetSocketAddress peerAddress) Creates a new server key exchange instance from its byte representation.
PskPublicInformation	getHint() This method returns the preshared key hint used by server in ServerKeyExchange message.
int	getMessageLength() Must be implemented by each subclass.
String	toString()

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

getEncodedPoint, getNamedCurveLength, getSupportedGroup, readNamedCurve, updateSignatureForNamedCurve, writeNamedCurve

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

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

EcdhPskServerKeyExchange

public EcdhPskServerKeyExchange(PskPublicInformation pskHint,
                        XECDHECryptography ecdhe,
                        InetSocketAddress peerAddress)

Creates a new key exchange message with psk hint as clear text and ServerDHParams.

Parameters:

pskHint - preshared key hint in clear text

ecdhe - XECDHECryptography including the supported group and the peer's public key

peerAddress - peer's address

Throws:

NullPointerException - if the arguments pskHint or ecdhe are null

See Also:

RFC 4279

Method Detail

fragmentToByteArray

public byte[] fragmentToByteArray()

Description copied from class: HandshakeMessage

The serialization of the handshake body (without the handshake header). Must be implemented by each subclass. Except the ClientHello, the fragments are considered to be not modified. If a modification is required, call HandshakeMessage.fragmentChanged().

Specified by:

fragmentToByteArray in class HandshakeMessage

Returns:

the raw byte representation of the handshake body.

fromReader

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

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

Parameters:

reader - reader for the binary encoding of the message.

peerAddress - peer address

Returns:

EcdhPskServerKeyExchange

Throws:

HandshakeException - if the byte array includes unsupported curve

NullPointerException - if either byteArray or 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).

Specified by:

getMessageLength in class HandshakeMessage

Returns:

the length of the message in bytes.

getHint

public PskPublicInformation getHint()

This method returns the preshared key hint used by server in ServerKeyExchange message. If psk hint not present this will return an empty string.

Returns:

preshared key hint as clear text.

toString

public String toString()

Overrides:

toString in class ECDHServerKeyExchange