Index: webrtc/p2p/base/transport.cc |
diff --git a/webrtc/p2p/base/transport.cc b/webrtc/p2p/base/transport.cc |
new file mode 100644 |
index 0000000000000000000000000000000000000000..7bd14c4cad1b8989755c7e6eba61f7ffcaf74c37 |
--- /dev/null |
+++ b/webrtc/p2p/base/transport.cc |
@@ -0,0 +1,472 @@ |
+/* |
+ * Copyright 2004 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. |
+ */ |
+ |
+#include <memory> |
+#include <utility> // for std::pair |
+ |
+#include "webrtc/p2p/base/transport.h" |
+ |
+#include "webrtc/p2p/base/candidate.h" |
+#include "webrtc/p2p/base/p2pconstants.h" |
+#include "webrtc/p2p/base/port.h" |
+#include "webrtc/p2p/base/transportchannelimpl.h" |
+#include "webrtc/base/bind.h" |
+#include "webrtc/base/checks.h" |
+#include "webrtc/base/logging.h" |
+ |
+namespace cricket { |
+ |
+static bool VerifyIceParams(const TransportDescription& desc) { |
+ // For legacy protocols. |
+ if (desc.ice_ufrag.empty() && desc.ice_pwd.empty()) |
+ return true; |
+ |
+ if (desc.ice_ufrag.length() < ICE_UFRAG_MIN_LENGTH || |
+ desc.ice_ufrag.length() > ICE_UFRAG_MAX_LENGTH) { |
+ return false; |
+ } |
+ if (desc.ice_pwd.length() < ICE_PWD_MIN_LENGTH || |
+ desc.ice_pwd.length() > ICE_PWD_MAX_LENGTH) { |
+ return false; |
+ } |
+ return true; |
+} |
+ |
+bool BadTransportDescription(const std::string& desc, std::string* err_desc) { |
+ if (err_desc) { |
+ *err_desc = desc; |
+ } |
+ LOG(LS_ERROR) << desc; |
+ return false; |
+} |
+ |
+bool IceCredentialsChanged(const std::string& old_ufrag, |
+ const std::string& old_pwd, |
+ const std::string& new_ufrag, |
+ const std::string& new_pwd) { |
+ // The standard (RFC 5245 Section 9.1.1.1) says that ICE restarts MUST change |
+ // both the ufrag and password. However, section 9.2.1.1 says changing the |
+ // ufrag OR password indicates an ICE restart. So, to keep compatibility with |
+ // endpoints that only change one, we'll treat this as an ICE restart. |
+ return (old_ufrag != new_ufrag) || (old_pwd != new_pwd); |
+} |
+ |
+Transport::Transport(const std::string& name, PortAllocator* allocator) |
+ : name_(name), allocator_(allocator) {} |
+ |
+Transport::~Transport() { |
+ RTC_DCHECK(channels_destroyed_); |
+} |
+ |
+void Transport::SetIceRole(IceRole role) { |
+ ice_role_ = role; |
+ for (const auto& kv : channels_) { |
+ kv.second->SetIceRole(ice_role_); |
+ } |
+} |
+ |
+std::unique_ptr<rtc::SSLCertificate> Transport::GetRemoteSSLCertificate() { |
+ if (channels_.empty()) { |
+ return nullptr; |
+ } |
+ |
+ auto iter = channels_.begin(); |
+ return iter->second->GetRemoteSSLCertificate(); |
+} |
+ |
+void Transport::SetIceConfig(const IceConfig& config) { |
+ ice_config_ = config; |
+ for (const auto& kv : channels_) { |
+ kv.second->SetIceConfig(ice_config_); |
+ } |
+} |
+ |
+bool Transport::SetLocalTransportDescription( |
+ const TransportDescription& description, |
+ ContentAction action, |
+ std::string* error_desc) { |
+ bool ret = true; |
+ |
+ if (!VerifyIceParams(description)) { |
+ return BadTransportDescription("Invalid ice-ufrag or ice-pwd length", |
+ error_desc); |
+ } |
+ |
+ local_description_.reset(new TransportDescription(description)); |
+ |
+ for (const auto& kv : channels_) { |
+ ret &= ApplyLocalTransportDescription(kv.second, error_desc); |
+ } |
+ if (!ret) { |
+ return false; |
+ } |
+ |
+ // If PRANSWER/ANSWER is set, we should decide transport protocol type. |
+ if (action == CA_PRANSWER || action == CA_ANSWER) { |
+ ret &= NegotiateTransportDescription(action, error_desc); |
+ } |
+ if (ret) { |
+ local_description_set_ = true; |
+ } |
+ |
+ return ret; |
+} |
+ |
+bool Transport::SetRemoteTransportDescription( |
+ const TransportDescription& description, |
+ ContentAction action, |
+ std::string* error_desc) { |
+ bool ret = true; |
+ |
+ if (!VerifyIceParams(description)) { |
+ return BadTransportDescription("Invalid ice-ufrag or ice-pwd length", |
+ error_desc); |
+ } |
+ |
+ remote_description_.reset(new TransportDescription(description)); |
+ for (const auto& kv : channels_) { |
+ ret &= ApplyRemoteTransportDescription(kv.second, error_desc); |
+ } |
+ |
+ // If PRANSWER/ANSWER is set, we should decide transport protocol type. |
+ if (action == CA_PRANSWER || action == CA_ANSWER) { |
+ ret = NegotiateTransportDescription(CA_OFFER, error_desc); |
+ } |
+ if (ret) { |
+ remote_description_set_ = true; |
+ } |
+ |
+ return ret; |
+} |
+ |
+TransportChannelImpl* Transport::CreateChannel(int component) { |
+ TransportChannelImpl* channel; |
+ |
+ // Create the entry if it does not exist. |
+ bool channel_exists = false; |
+ auto iter = channels_.find(component); |
+ if (iter == channels_.end()) { |
+ channel = CreateTransportChannel(component); |
+ channels_.insert(std::pair<int, TransportChannelImpl*>(component, channel)); |
+ } else { |
+ channel = iter->second; |
+ channel_exists = true; |
+ } |
+ |
+ channels_destroyed_ = false; |
+ |
+ if (channel_exists) { |
+ // If this is an existing channel, we should just return it. |
+ return channel; |
+ } |
+ |
+ // Push down our transport state to the new channel. |
+ channel->SetIceRole(ice_role_); |
+ channel->SetIceTiebreaker(tiebreaker_); |
+ channel->SetIceConfig(ice_config_); |
+ // TODO(ronghuawu): Change CreateChannel to be able to return error since |
+ // below Apply**Description calls can fail. |
+ if (local_description_) |
+ ApplyLocalTransportDescription(channel, nullptr); |
+ if (remote_description_) |
+ ApplyRemoteTransportDescription(channel, nullptr); |
+ if (local_description_ && remote_description_) |
+ ApplyNegotiatedTransportDescription(channel, nullptr); |
+ |
+ return channel; |
+} |
+ |
+TransportChannelImpl* Transport::GetChannel(int component) { |
+ auto iter = channels_.find(component); |
+ return (iter != channels_.end()) ? iter->second : nullptr; |
+} |
+ |
+bool Transport::HasChannels() { |
+ return !channels_.empty(); |
+} |
+ |
+void Transport::DestroyChannel(int component) { |
+ auto iter = channels_.find(component); |
+ if (iter == channels_.end()) |
+ return; |
+ |
+ TransportChannelImpl* channel = iter->second; |
+ channels_.erase(iter); |
+ DestroyTransportChannel(channel); |
+} |
+ |
+void Transport::MaybeStartGathering() { |
+ CallChannels(&TransportChannelImpl::MaybeStartGathering); |
+} |
+ |
+void Transport::DestroyAllChannels() { |
+ for (const auto& kv : channels_) { |
+ DestroyTransportChannel(kv.second); |
+ } |
+ channels_.clear(); |
+ channels_destroyed_ = true; |
+} |
+ |
+void Transport::CallChannels(TransportChannelFunc func) { |
+ for (const auto& kv : channels_) { |
+ (kv.second->*func)(); |
+ } |
+} |
+ |
+bool Transport::VerifyCandidate(const Candidate& cand, std::string* error) { |
+ // No address zero. |
+ if (cand.address().IsNil() || cand.address().IsAnyIP()) { |
+ *error = "candidate has address of zero"; |
+ return false; |
+ } |
+ |
+ // Disallow all ports below 1024, except for 80 and 443 on public addresses. |
+ int port = cand.address().port(); |
+ if (cand.protocol() == TCP_PROTOCOL_NAME && |
+ (cand.tcptype() == TCPTYPE_ACTIVE_STR || port == 0)) { |
+ // Expected for active-only candidates per |
+ // http://tools.ietf.org/html/rfc6544#section-4.5 so no error. |
+ // Libjingle clients emit port 0, in "active" mode. |
+ return true; |
+ } |
+ if (port < 1024) { |
+ if ((port != 80) && (port != 443)) { |
+ *error = "candidate has port below 1024, but not 80 or 443"; |
+ return false; |
+ } |
+ |
+ if (cand.address().IsPrivateIP()) { |
+ *error = "candidate has port of 80 or 443 with private IP address"; |
+ return false; |
+ } |
+ } |
+ |
+ if (!HasChannel(cand.component())) { |
+ *error = "Candidate has an unknown component: " + cand.ToString() + |
+ " for content: " + name(); |
+ return false; |
+ } |
+ |
+ return true; |
+} |
+ |
+bool Transport::VerifyCandidates(const Candidates& candidates, |
+ std::string* error) { |
+ for (const Candidate& candidate : candidates) { |
+ if (!VerifyCandidate(candidate, error)) { |
+ return false; |
+ } |
+ } |
+ return true; |
+} |
+ |
+ |
+bool Transport::GetStats(TransportStats* stats) { |
+ stats->transport_name = name(); |
+ stats->channel_stats.clear(); |
+ for (auto kv : channels_) { |
+ TransportChannelImpl* channel = kv.second; |
+ TransportChannelStats substats; |
+ substats.component = channel->component(); |
+ channel->GetSrtpCryptoSuite(&substats.srtp_crypto_suite); |
+ channel->GetSslCipherSuite(&substats.ssl_cipher_suite); |
+ if (!channel->GetStats(&substats.connection_infos)) { |
+ return false; |
+ } |
+ stats->channel_stats.push_back(substats); |
+ } |
+ return true; |
+} |
+ |
+bool Transport::AddRemoteCandidates(const std::vector<Candidate>& candidates, |
+ std::string* error) { |
+ ASSERT(!channels_destroyed_); |
+ // Verify each candidate before passing down to the transport layer. |
+ if (!VerifyCandidates(candidates, error)) { |
+ return false; |
+ } |
+ |
+ for (const Candidate& candidate : candidates) { |
+ TransportChannelImpl* channel = GetChannel(candidate.component()); |
+ if (channel != nullptr) { |
+ channel->AddRemoteCandidate(candidate); |
+ } |
+ } |
+ return true; |
+} |
+ |
+bool Transport::RemoveRemoteCandidates(const std::vector<Candidate>& candidates, |
+ std::string* error) { |
+ ASSERT(!channels_destroyed_); |
+ // Verify each candidate before passing down to the transport layer. |
+ if (!VerifyCandidates(candidates, error)) { |
+ return false; |
+ } |
+ |
+ for (const Candidate& candidate : candidates) { |
+ TransportChannelImpl* channel = GetChannel(candidate.component()); |
+ if (channel != nullptr) { |
+ channel->RemoveRemoteCandidate(candidate); |
+ } |
+ } |
+ return true; |
+} |
+ |
+bool Transport::ApplyLocalTransportDescription(TransportChannelImpl* ch, |
+ std::string* error_desc) { |
+ ch->SetIceParameters(local_description_->GetIceParameters()); |
+ return true; |
+} |
+ |
+bool Transport::ApplyRemoteTransportDescription(TransportChannelImpl* ch, |
+ std::string* error_desc) { |
+ ch->SetRemoteIceParameters(remote_description_->GetIceParameters()); |
+ return true; |
+} |
+ |
+bool Transport::ApplyNegotiatedTransportDescription( |
+ TransportChannelImpl* channel, |
+ std::string* error_desc) { |
+ channel->SetRemoteIceMode(remote_ice_mode_); |
+ return true; |
+} |
+ |
+bool Transport::NegotiateTransportDescription(ContentAction local_role, |
+ std::string* error_desc) { |
+ // TODO(ekr@rtfm.com): This is ICE-specific stuff. Refactor into |
+ // P2PTransport. |
+ |
+ // If transport is in ICEROLE_CONTROLLED and remote end point supports only |
+ // ice_lite, this local end point should take CONTROLLING role. |
+ if (ice_role_ == ICEROLE_CONTROLLED && |
+ remote_description_->ice_mode == ICEMODE_LITE) { |
+ SetIceRole(ICEROLE_CONTROLLING); |
+ } |
+ |
+ // Update remote ice_mode to all existing channels. |
+ remote_ice_mode_ = remote_description_->ice_mode; |
+ |
+ // Now that we have negotiated everything, push it downward. |
+ // Note that we cache the result so that if we have race conditions |
+ // between future SetRemote/SetLocal invocations and new channel |
+ // creation, we have the negotiation state saved until a new |
+ // negotiation happens. |
+ for (const auto& kv : channels_) { |
+ if (!ApplyNegotiatedTransportDescription(kv.second, error_desc)) { |
+ return false; |
+ } |
+ } |
+ return true; |
+} |
+ |
+bool Transport::VerifyCertificateFingerprint( |
+ const rtc::RTCCertificate* certificate, |
+ const rtc::SSLFingerprint* fingerprint, |
+ std::string* error_desc) const { |
+ if (!fingerprint) { |
+ return BadTransportDescription("No fingerprint.", error_desc); |
+ } |
+ if (!certificate) { |
+ return BadTransportDescription( |
+ "Fingerprint provided but no identity available.", error_desc); |
+ } |
+ std::unique_ptr<rtc::SSLFingerprint> fp_tmp(rtc::SSLFingerprint::Create( |
+ fingerprint->algorithm, certificate->identity())); |
+ ASSERT(fp_tmp.get() != NULL); |
+ if (*fp_tmp == *fingerprint) { |
+ return true; |
+ } |
+ std::ostringstream desc; |
+ desc << "Local fingerprint does not match identity. Expected: "; |
+ desc << fp_tmp->ToString(); |
+ desc << " Got: " << fingerprint->ToString(); |
+ return BadTransportDescription(desc.str(), error_desc); |
+} |
+ |
+bool Transport::NegotiateRole(ContentAction local_role, |
+ rtc::SSLRole* ssl_role, |
+ std::string* error_desc) const { |
+ RTC_DCHECK(ssl_role); |
+ if (!local_description() || !remote_description()) { |
+ const std::string msg = |
+ "Local and Remote description must be set before " |
+ "transport descriptions are negotiated"; |
+ return BadTransportDescription(msg, error_desc); |
+ } |
+ |
+ // From RFC 4145, section-4.1, The following are the values that the |
+ // 'setup' attribute can take in an offer/answer exchange: |
+ // Offer Answer |
+ // ________________ |
+ // active passive / holdconn |
+ // passive active / holdconn |
+ // actpass active / passive / holdconn |
+ // holdconn holdconn |
+ // |
+ // Set the role that is most conformant with RFC 5763, Section 5, bullet 1 |
+ // The endpoint MUST use the setup attribute defined in [RFC4145]. |
+ // The endpoint that is the offerer MUST use the setup attribute |
+ // value of setup:actpass and be prepared to receive a client_hello |
+ // before it receives the answer. The answerer MUST use either a |
+ // setup attribute value of setup:active or setup:passive. Note that |
+ // if the answerer uses setup:passive, then the DTLS handshake will |
+ // not begin until the answerer is received, which adds additional |
+ // latency. setup:active allows the answer and the DTLS handshake to |
+ // occur in parallel. Thus, setup:active is RECOMMENDED. Whichever |
+ // party is active MUST initiate a DTLS handshake by sending a |
+ // ClientHello over each flow (host/port quartet). |
+ // IOW - actpass and passive modes should be treated as server and |
+ // active as client. |
+ ConnectionRole local_connection_role = local_description()->connection_role; |
+ ConnectionRole remote_connection_role = remote_description()->connection_role; |
+ |
+ bool is_remote_server = false; |
+ if (local_role == CA_OFFER) { |
+ if (local_connection_role != CONNECTIONROLE_ACTPASS) { |
+ return BadTransportDescription( |
+ "Offerer must use actpass value for setup attribute.", error_desc); |
+ } |
+ |
+ if (remote_connection_role == CONNECTIONROLE_ACTIVE || |
+ remote_connection_role == CONNECTIONROLE_PASSIVE || |
+ remote_connection_role == CONNECTIONROLE_NONE) { |
+ is_remote_server = (remote_connection_role == CONNECTIONROLE_PASSIVE); |
+ } else { |
+ const std::string msg = |
+ "Answerer must use either active or passive value " |
+ "for setup attribute."; |
+ return BadTransportDescription(msg, error_desc); |
+ } |
+ // If remote is NONE or ACTIVE it will act as client. |
+ } else { |
+ if (remote_connection_role != CONNECTIONROLE_ACTPASS && |
+ remote_connection_role != CONNECTIONROLE_NONE) { |
+ return BadTransportDescription( |
+ "Offerer must use actpass value for setup attribute.", error_desc); |
+ } |
+ |
+ if (local_connection_role == CONNECTIONROLE_ACTIVE || |
+ local_connection_role == CONNECTIONROLE_PASSIVE) { |
+ is_remote_server = (local_connection_role == CONNECTIONROLE_ACTIVE); |
+ } else { |
+ const std::string msg = |
+ "Answerer must use either active or passive value " |
+ "for setup attribute."; |
+ return BadTransportDescription(msg, error_desc); |
+ } |
+ |
+ // If local is passive, local will act as server. |
+ } |
+ |
+ *ssl_role = is_remote_server ? rtc::SSL_CLIENT : rtc::SSL_SERVER; |
+ return true; |
+} |
+ |
+} // namespace cricket |