org.jitsi.service.neomedia.event

Interface SrtpListener

public interface SrtpListener

The SrtpListener is meant to be used by the media stream creator, as the name indicates in order to be notified when a security event has occurred that concerns a secure (media) transport i.e. SrtpControl such as ZRTP, SDES and DTLS-SRTP.

Author:

Yana Stamcheva

Field Summary

Fields

Modifier and Type	Field and Description
static int	ERROR This is an error message.
static int	INFORMATION This is a information message.
static int	SEVERE This is a severe error.
static int	WARNING This is a warning message.

Method Summary

Modifier and Type	Method and Description
void	securityMessageReceived(String message, String i18nMessage, int severity) Indicates that a security message has occurred associated with a failure/warning or information coming from the encryption protocol/secure transport.
void	securityNegotiationStarted(org.jitsi.utils.MediaType mediaType, SrtpControl sender) Indicates that we started the process of securing the connection.
void	securityTimeout(org.jitsi.utils.MediaType mediaType) Indicates that the other party has timed out replying to our offer to secure the connection.
void	securityTurnedOff(org.jitsi.utils.MediaType mediaType) Indicates that the security has been turned off.
void	securityTurnedOn(org.jitsi.utils.MediaType mediaType, String cipher, SrtpControl sender) Indicates that the security has been turned on.

Field Detail

INFORMATION

static final int INFORMATION

This is a information message. Security will be established.

See Also:

Constant Field Values

WARNING

static final int WARNING

This is a warning message. Security will not be established.

See Also:

Constant Field Values

SEVERE

static final int SEVERE

This is a severe error. Security will not be established.

See Also:

Constant Field Values

ERROR

static final int ERROR

This is an error message. Security will not be established.

See Also:

Constant Field Values

Method Detail

securityTurnedOn

void securityTurnedOn(org.jitsi.utils.MediaType mediaType,
                      String cipher,
                      SrtpControl sender)

Indicates that the security has been turned on. When we are in the case of using multistreams when the master stream ZRTP is initialized and established the param multiStreamData holds the data needed for the slave streams to establish their sessions. If this is a securityTurnedOn event on non master stream the multiStreamData is null.

Parameters:

mediaType - the MediaType of the call session

cipher - the security cipher that encrypts the call

sender - the control that initiated the event.

securityTurnedOff

void securityTurnedOff(org.jitsi.utils.MediaType mediaType)

Indicates that the security has been turned off.

Parameters:

mediaType - the MediaType of the call session

securityMessageReceived

void securityMessageReceived(String message,
                             String i18nMessage,
                             int severity)

Indicates that a security message has occurred associated with a failure/warning or information coming from the encryption protocol/secure transport.

Parameters:

message - the message.

i18nMessage - the internationalized message

severity - severity level

securityTimeout

void securityTimeout(org.jitsi.utils.MediaType mediaType)

Indicates that the other party has timed out replying to our offer to secure the connection.

Parameters:

mediaType - the MediaType of the call session

securityNegotiationStarted

void securityNegotiationStarted(org.jitsi.utils.MediaType mediaType,
                                SrtpControl sender)

Indicates that we started the process of securing the connection.

Parameters:

mediaType - the MediaType of the call session

sender - the control that initiated the event.