ZrtpCallback.h File Reference

#include <string>
#include <libzrtpcpp/ZrtpPacketBase.h>

Go to the source code of this file.

Classes

struct srtpSecrets

class ZrtpCallback

Typedefs

typedef srtpSecrets SrtpSecret_t

Enumerations

enum MessageSeverity { Info = 1, Warning, Error, Alert }

enum Role { Responder = 1, Initiator }

enum EnableSecurity { ForReceiver = 1, ForSender = 2 }

Typedef Documentation

typedef struct srtpSecrets SrtpSecret_t

This structure contains pointers to the SRTP secrets and the role info.
About the role and what the meaning of the role is refer to the of the enum Role. The pointers to the secrets are valid as long as the ZRtp object is active. To use these data after the ZRtp object's lifetime you may copy the data into a save place. The destructor of ZRtp clears the data.

Enumeration Type Documentation

enum EnableSecurity

Enumerator:

ForReceiver

ForSender

Definition at line 117 of file ZrtpCallback.h.
00117 { 00118 ForReceiver = 1, 00119 ForSender = 2 00120 };

enum MessageSeverity

This enum defines the information message severity.
The ZRTP implementation issues information messages to inform the user about ongoing processing, unusual behavior, or alerts in case of severe problems. The severity levels and their meaning are:

Info

keeps the user informed about ongoing processing and security setup.

Warning

is an information about some security issues, e.g. if an AES 256 encryption is request but only DH 3072 as public key scheme is supported. ZRTP will establish a secure session (SRTP).

Error

is used if an error occured during ZRTP protocol usage. For example if an unknown or unsupported alogrithm is offerd. In case of Error ZRTP will not establish a secure session.

Alert

shows a real security problem. This probably falls into a MitM category. ZRTP of course will not establish a secure session.

Enumerator:

Info

Warning

Error

Alert

Definition at line 67 of file ZrtpCallback.h.
00067 { 00068 Info = 1, 00069 Warning, 00070 Error, 00071 Alert 00072 };

enum Role

This enum defines which role a ZRTP peer has.
According to the ZRTP specification the role determines which keys to use to encrypt or decrypt SRTP data.

The Initiator encrypts SRTP data using the keyInitiator and the saltInitiator data, the Responder uses these data to decrypt.

The Responder encrypts SRTP data using the keyResponder and the saltResponder data, the Initiator uses these data to decrypt.

Enumerator:

Responder

Initiator

Definition at line 89 of file ZrtpCallback.h.
00089 { 00090 Responder = 1, 00091 Initiator 00092 } Role;


Classes
struct	srtpSecrets
class	ZrtpCallback
Typedefs
typedef srtpSecrets	SrtpSecret_t
Enumerations
enum	MessageSeverity { Info = 1, Warning, Error, Alert }
enum	Role { Responder = 1, Initiator }
enum	EnableSecurity { ForReceiver = 1, ForSender = 2 }