Share via


RTCDtlsParameters object

[Some information relates to pre-released product which may be substantially modified before it's commercially released. Microsoft makes no warranties, express or implied, with respect to the information provided here.]

Exposes information relating to DTLS configuration.

Syntax

dictionary RTCDtlsParameters {
             RTCDtlsRole                  role = "auto";
             sequence<RTCDtlsFingerprint> fingerprints;
};

Standards information

Dictionary

Member Type Description
fingerprints sequence<RTCDtlsFingerprint> Sequence of fingerprints.
role RTCDtlsRole Indicates the role of the DTLS transport, with a default of auto.
ValueDescription
auto
The DTLS role is determined based on the resolved ICE role: the "controlled" role acts as the DTLS client, the "controlling" role acts as the DTLS server. Since RTCDtlsRole is initialized to "auto" on construction of an RTCDtlsTransport object, transport.getLocalParameters().RTCDtlsRole will have an initial value of "auto".
client
The DTLS client role. A transition to "client" will occur if start(remoteParameters) is called with remoteParameters.RTCDtlsRole having a value of "server". If RTCDtlsRole had previously had a value of "server" (e.g. due to the RTCDtlsTransport having previously received packets from a DTLS client), then the DTLS session is reset prior to transitioning to the "client" role.
server
The DTLS server role. If RTCDtlsRole has a value of "auto" and the RTCDtlsTransport receives a DTLS client_helo packet, RTCDtlsRole will transition to "server", even before start() is called. A transition from "auto" to "server" will also occur if start(remoteParameters) is called with remoteParameters.RTCDtlsRole having a value of "client".

 

 

See also

RTCDtlsTransport