92 lines
3.7 KiB
C++
92 lines
3.7 KiB
C++
/*
|
||
* Copyright (c) 2011 The WebRTC project authors. All Rights Reserved.
|
||
*
|
||
* Use of this source code is governed by a BSD-style license
|
||
* that can be found in the LICENSE file in the root of the source
|
||
* tree. An additional intellectual property rights grant can be found
|
||
* in the file PATENTS. All contributing project authors may
|
||
* be found in the AUTHORS file in the root of the source tree.
|
||
*/
|
||
|
||
// This sub-API supports the following functionalities:
|
||
// - Secure RTP (SRTP).
|
||
// - External encryption and decryption.
|
||
|
||
|
||
#ifndef WEBRTC_VIDEO_ENGINE_MAIN_INTERFACE_VIE_ENCRYPTION_H_
|
||
#define WEBRTC_VIDEO_ENGINE_MAIN_INTERFACE_VIE_ENCRYPTION_H_
|
||
|
||
#include "common_types.h"
|
||
|
||
namespace webrtc
|
||
{
|
||
class VideoEngine;
|
||
|
||
// ----------------------------------------------------------------------------
|
||
// ViEEncryption
|
||
// ----------------------------------------------------------------------------
|
||
|
||
class WEBRTC_DLLEXPORT ViEEncryption
|
||
{
|
||
public:
|
||
enum
|
||
{
|
||
kMaxSrtpKeyLength = 30
|
||
};
|
||
|
||
// Factory for the ViEEncryption sub‐API and increases an internal reference
|
||
// counter if successful. Returns NULL if the API is not supported or if
|
||
// construction fails.
|
||
static ViEEncryption* GetInterface(VideoEngine* videoEngine);
|
||
|
||
// Releases the ViEEncryption sub-API and decreases an internal reference
|
||
// counter.
|
||
// Returns the new reference count. This value should be zero
|
||
// for all sub-API:s before the VideoEngine object can be safely deleted.
|
||
virtual int Release() = 0;
|
||
|
||
// This function enables SRTP on send packets for a specific channel.
|
||
virtual int EnableSRTPSend(const int videoChannel,
|
||
const CipherTypes cipherType,
|
||
const unsigned int cipherKeyLength,
|
||
const AuthenticationTypes authType,
|
||
const unsigned int authKeyLength,
|
||
const unsigned int authTagLength,
|
||
const SecurityLevels level,
|
||
const unsigned char key[kMaxSrtpKeyLength],
|
||
const bool useForRTCP = false) = 0;
|
||
|
||
// This function disables SRTP for the specified channel.
|
||
virtual int DisableSRTPSend(const int videoChannel) = 0;
|
||
|
||
// This function enables SRTP on the received packets for a specific
|
||
// channel.
|
||
virtual int EnableSRTPReceive(const int videoChannel,
|
||
const CipherTypes cipherType,
|
||
const unsigned int cipherKeyLength,
|
||
const AuthenticationTypes authType,
|
||
const unsigned int authKeyLength,
|
||
const unsigned int authTagLength,
|
||
const SecurityLevels level,
|
||
const unsigned char key[kMaxSrtpKeyLength],
|
||
const bool useForRTCP = false) = 0;
|
||
|
||
// This function disables SRTP on received packets for a specific channel.
|
||
virtual int DisableSRTPReceive(const int videoChannel) = 0;
|
||
|
||
// This function registers a encryption derived instance and enables
|
||
// external encryption for the specified channel.
|
||
virtual int RegisterExternalEncryption(const int videoChannel,
|
||
Encryption& encryption) = 0;
|
||
|
||
// This function deregisters a registered encryption derived instance
|
||
// and disables external encryption.
|
||
virtual int DeregisterExternalEncryption(const int videoChannel) = 0;
|
||
|
||
protected:
|
||
ViEEncryption() {};
|
||
virtual ~ViEEncryption() {};
|
||
};
|
||
} // namespace webrtc
|
||
#endif // WEBRTC_VIDEO_ENGINE_MAIN_INTERFACE_VIE_ENCRYPTION_H_
|