webrtc/api/ortc/srtptransportinterface.h
Patrik Höglund 7aee3d538c Fix ortc_api circular deps.
This will help keep ortc dependencies clean in the future, since
gn --check forces us to depend on components from which we include
headers.

cryptoparams.h moves into api/, but ortc appears to think it
should be there anyway. We could consider moving it into the ortc/ api,
but it doesn't appear to be specific to ortc.

Bug: webrtc:6828
Change-Id: Iddae438d10b5e84b2fbc52565364319e20f90613
Reviewed-on: https://webrtc-review.googlesource.com/22660
Commit-Queue: Patrik Höglund <phoglund@webrtc.org>
Reviewed-by: Karl Wiberg <kwiberg@webrtc.org>
Cr-Commit-Position: refs/heads/master@{#20686}
2017-11-15 13:31:51 +00:00

48 lines
1.8 KiB
C++

/*
* Copyright 2017 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.
*/
#ifndef API_ORTC_SRTPTRANSPORTINTERFACE_H_
#define API_ORTC_SRTPTRANSPORTINTERFACE_H_
#include "api/ortc/rtptransportinterface.h"
#include "api/rtcerror.h"
#include "api/cryptoparams.h"
namespace webrtc {
// The subclass of the RtpTransport which uses SRTP. The keying information
// is explicitly passed in from the application.
//
// If using SDP and SDES (RFC4568) for signaling, then after applying the
// answer, the negotiated keying information from the offer and answer would be
// set and the SRTP would be active.
//
// Note that Edge's implementation of ORTC provides a similar API point, called
// RTCSrtpSdesTransport:
// https://msdn.microsoft.com/en-us/library/mt502527(v=vs.85).aspx
class SrtpTransportInterface : public RtpTransportInterface {
public:
virtual ~SrtpTransportInterface() {}
// There are some limitations of the current implementation:
// 1. Send and receive keys must use the same crypto suite.
// 2. The keys can't be changed after initially set.
// 3. The keys must be set before creating a sender/receiver using the SRTP
// transport.
// Set the SRTP keying material for sending RTP and RTCP.
virtual RTCError SetSrtpSendKey(const cricket::CryptoParams& params) = 0;
// Set the SRTP keying material for receiving RTP and RTCP.
virtual RTCError SetSrtpReceiveKey(const cricket::CryptoParams& params) = 0;
};
} // namespace webrtc
#endif // API_ORTC_SRTPTRANSPORTINTERFACE_H_