net.java.sip.communicator.service.neomedia
Interface ZrtpControl

All Superinterfaces:

SrtpControl

All Known Implementing Classes:

ZrtpControlImpl

public interface ZrtpControl
extends SrtpControl

ZRTP based SRTP MediaStream encryption control.

Author:

Damian Minkov

Method Summary

String	getHelloHash() Return the zrtp hello hash String.
String[]	getHelloHashSep() Get the ZRTP Hello Hash data - separate strings.
byte[]	getPeerZid() Get other party's ZID (ZRTP Identifier) data This functions returns the other party's ZID that was receivied during ZRTP processing.
String	getPeerZidString() Get other party's ZID (ZRTP Identifier) data as String This functions returns the other party's ZID that was receivied during ZRTP processing.
String	getSecurityString() Gets the SAS for the current media stream.
long	getTimeoutValue() Returns the timeout value that will we will wait and fire timeout secure event if call is not secured.
boolean	isSecurityVerified() Gets the status of the SAS verification.
void	setSASVerification(boolean verified) Sets the SAS verification

Methods inherited from interface net.java.sip.communicator.service.neomedia.SrtpControl

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

Method Detail

getHelloHash

String getHelloHash()

Return the zrtp hello hash String.

Returns:

String the zrtp hello hash.

getHelloHashSep

String[] getHelloHashSep()

Get the ZRTP Hello Hash data - separate strings.

Returns:

String array containing the version string at offset 0, the Hello hash value as hex-digits at offset 1. Hello hash is available immediately after class instantiation. Returns null if ZRTP is not available.

getSecurityString

String getSecurityString()

Gets the SAS for the current media stream.

Returns:

the four character ZRTP SAS.

isSecurityVerified

boolean isSecurityVerified()

Gets the status of the SAS verification.

Returns:

true when the SAS has been verified.

setSASVerification

void setSASVerification(boolean verified)

Sets the SAS verification

Parameters:

verified - the new SAS verification status

getTimeoutValue

long getTimeoutValue()

Returns the timeout value that will we will wait and fire timeout secure event if call is not secured. The value is in milliseconds.

Returns:

the timeout value that will we will wait and fire timeout secure event if call is not secured.

getPeerZid

byte[] getPeerZid()

Get other party's ZID (ZRTP Identifier) data This functions returns the other party's ZID that was receivied during ZRTP processing. The ZID data can be retrieved after ZRTP receive the first Hello packet from the other party.

Returns:

the ZID data as byte array.

getPeerZidString

String getPeerZidString()

Get other party's ZID (ZRTP Identifier) data as String This functions returns the other party's ZID that was receivied during ZRTP processing. The ZID data can be retrieved after ZRTP receive the first Hello packet from the other party.

Returns:

the ZID data as String.