org.jitsi.service.neomedia

Interface SDesControl

All Superinterfaces:

SrtpControl

All Known Implementing Classes:

SDesControlImpl

public interface SDesControl
extends SrtpControl

SDES based SRTP MediaStream encryption control.

Author:

Ingo Bauersachs

Nested Class Summary

Nested classes/interfaces inherited from interface org.jitsi.service.neomedia.SrtpControl

SrtpControl.TransformEngine

Field Summary

Fields

Modifier and Type	Field and Description
static String	SDES_CIPHER_SUITES Name of the config setting that supplies the default enabled cipher suites.

Fields inherited from interface org.jitsi.service.neomedia.SrtpControl

RTP_SAVP, RTP_SAVPF

Method Summary

Modifier and Type	Method and Description
ch.imvs.sdes4j.srtp.SrtpCryptoAttribute	getInAttribute() Gets the crypto attribute of the incoming MediaStream.
ch.imvs.sdes4j.srtp.SrtpCryptoAttribute[]	getInitiatorCryptoAttributes() Returns the crypto attributes enabled on this computer.
ch.imvs.sdes4j.srtp.SrtpCryptoAttribute	getOutAttribute() Gets the crypto attribute of the outgoing MediaStream.
Iterable<String>	getSupportedCryptoSuites() Gets all supported cipher suites.
ch.imvs.sdes4j.srtp.SrtpCryptoAttribute	initiatorSelectAttribute(Iterable<ch.imvs.sdes4j.srtp.SrtpCryptoAttribute> peerAttributes) Selects the local crypto attribute from the initial offering (getInitiatorCryptoAttributes()) based on the peer's first matching cipher suite.
ch.imvs.sdes4j.srtp.SrtpCryptoAttribute	responderSelectAttribute(Iterable<ch.imvs.sdes4j.srtp.SrtpCryptoAttribute> peerAttributes) Chooses a supported crypto attribute from the peer's list of supplied attributes and creates the local crypto attribute.
void	setEnabledCiphers(Iterable<String> ciphers) Sets the enabled SDES ciphers.

Methods inherited from interface org.jitsi.service.neomedia.SrtpControl

cleanup, getSecureCommunicationStatus, getSrtpControlType, getSrtpListener, getTransformEngine, registerUser, requiresSecureSignalingTransport, setConnector, setMasterSession, setMultistream, setSrtpListener, start

Field Detail

SDES_CIPHER_SUITES

static final String SDES_CIPHER_SUITES

Name of the config setting that supplies the default enabled cipher suites. Cipher suites are comma-separated.

See Also:

Constant Field Values

Method Detail

getInAttribute

ch.imvs.sdes4j.srtp.SrtpCryptoAttribute getInAttribute()

Gets the crypto attribute of the incoming MediaStream.

Returns:

the crypto attribute of the incoming MediaStream.

getInitiatorCryptoAttributes

ch.imvs.sdes4j.srtp.SrtpCryptoAttribute[] getInitiatorCryptoAttributes()

Returns the crypto attributes enabled on this computer.

Returns:

The crypto attributes enabled on this computer.

getOutAttribute

ch.imvs.sdes4j.srtp.SrtpCryptoAttribute getOutAttribute()

Gets the crypto attribute of the outgoing MediaStream.

Returns:

the crypto attribute of the outgoing MediaStream.

getSupportedCryptoSuites

Iterable<String> getSupportedCryptoSuites()

Gets all supported cipher suites.

Returns:

all supported cipher suites.

initiatorSelectAttribute

ch.imvs.sdes4j.srtp.SrtpCryptoAttribute initiatorSelectAttribute(Iterable<ch.imvs.sdes4j.srtp.SrtpCryptoAttribute> peerAttributes)

Selects the local crypto attribute from the initial offering (getInitiatorCryptoAttributes()) based on the peer's first matching cipher suite.

Parameters:

peerAttributes - The peer's crypto offers.

Returns:

A SrtpCryptoAttribute when a matching cipher suite was found; null, otherwise.

responderSelectAttribute

ch.imvs.sdes4j.srtp.SrtpCryptoAttribute responderSelectAttribute(Iterable<ch.imvs.sdes4j.srtp.SrtpCryptoAttribute> peerAttributes)

Chooses a supported crypto attribute from the peer's list of supplied attributes and creates the local crypto attribute. Used when the control is running in the role as responder.

Parameters:

peerAttributes - The peer's crypto attribute offering.

Returns:

The local crypto attribute for the answer of the offer or null if no matching cipher suite could be found.

setEnabledCiphers

void setEnabledCiphers(Iterable<String> ciphers)

Sets the enabled SDES ciphers.

Parameters:

ciphers - The list of enabled ciphers.