/* * Copyright (c) 2020 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 TEST_NETWORK_EMULATED_TURN_SERVER_H_ #define TEST_NETWORK_EMULATED_TURN_SERVER_H_ #include #include #include #include "absl/strings/string_view.h" #include "api/environment/environment.h" #include "api/test/network_emulation/network_emulation_interfaces.h" #include "api/test/network_emulation_manager.h" #include "api/transport/stun.h" #include "p2p/test/turn_server.h" #include "rtc_base/async_packet_socket.h" #include "rtc_base/socket_address.h" #include "rtc_base/thread.h" #include "rtc_base/thread_annotations.h" namespace webrtc { namespace test { // EmulatedTURNServer wraps webrtc::TurnServer to be used inside // a emulated network. // // Packets from EmulatedEndpoint (client or peer) are received in // EmulatedTURNServer::OnPacketReceived which performs a map lookup // and delivers them into webrtc::TurnServer using // AsyncPacketSocket::SignalReadPacket // // Packets from webrtc::TurnServer to EmulatedEndpoint are sent into // using a wrapper around AsyncPacketSocket (no lookup required as the // wrapper around AsyncPacketSocket keep a pointer to the EmulatedEndpoint). class EmulatedTURNServer : public EmulatedTURNServerInterface, public TurnAuthInterface, public webrtc::EmulatedNetworkReceiverInterface { public: // Create an EmulatedTURNServer. // `thread` is a thread that will be used to run webrtc::TurnServer // that expects all calls to be made from a single thread. EmulatedTURNServer(const Environment& env, const EmulatedTURNServerConfig& config, std::unique_ptr thread, EmulatedEndpoint* client, EmulatedEndpoint* peer); ~EmulatedTURNServer() override; IceServerConfig GetIceServerConfig() const override { return ice_config_; } EmulatedEndpoint* GetClientEndpoint() const override { return client_; } SocketAddress GetClientEndpointAddress() const override { return client_address_; } EmulatedEndpoint* GetPeerEndpoint() const override { return peer_; } // webrtc::TurnAuthInterface bool GetKey(absl::string_view username, absl::string_view realm, std::string* key) override { return ComputeStunCredentialHash(std::string(username), std::string(realm), std::string(username), key); } std::unique_ptr CreatePeerSocket() { return Wrap(peer_); } // This method is called by network emulation when a packet // comes from an emulated link. void OnPacketReceived(webrtc::EmulatedIpPacket packet) override; // This is called when the TURN server deletes a socket. void Unbind(SocketAddress address); // Unbind all sockets. void Stop(); private: std::unique_ptr thread_; SocketAddress client_address_; IceServerConfig ice_config_; EmulatedEndpoint* const client_; EmulatedEndpoint* const peer_; std::unique_ptr turn_server_ RTC_GUARDED_BY(&thread_); class AsyncPacketSocketWrapper; std::map sockets_ RTC_GUARDED_BY(&thread_); // Wraps a EmulatedEndpoint in a AsyncPacketSocket to bridge interaction // with TurnServer. std::unique_ptr Wrap(EmulatedEndpoint* endpoint); }; } // namespace test } // namespace webrtc #endif // TEST_NETWORK_EMULATED_TURN_SERVER_H_