| /* |
| * Copyright 2019 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_PACKET_SOCKET_FACTORY_H_ |
| #define API_PACKET_SOCKET_FACTORY_H_ |
| |
| #include <memory> |
| #include <string> |
| #include <vector> |
| |
| #include "api/async_dns_resolver.h" |
| #include "rtc_base/async_packet_socket.h" |
| #include "rtc_base/proxy_info.h" |
| #include "rtc_base/system/rtc_export.h" |
| |
| namespace rtc { |
| |
| class SSLCertificateVerifier; |
| class AsyncResolverInterface; |
| |
| struct PacketSocketTcpOptions { |
| PacketSocketTcpOptions() = default; |
| ~PacketSocketTcpOptions() = default; |
| |
| int opts = 0; |
| std::vector<std::string> tls_alpn_protocols; |
| std::vector<std::string> tls_elliptic_curves; |
| // An optional custom SSL certificate verifier that an API user can provide to |
| // inject their own certificate verification logic (not available to users |
| // outside of the WebRTC repo). |
| SSLCertificateVerifier* tls_cert_verifier = nullptr; |
| }; |
| |
| class RTC_EXPORT PacketSocketFactory { |
| public: |
| enum Options { |
| OPT_STUN = 0x04, |
| |
| // The TLS options below are mutually exclusive. |
| OPT_TLS = 0x02, // Real and secure TLS. |
| OPT_TLS_FAKE = 0x01, // Fake TLS with a dummy SSL handshake. |
| OPT_TLS_INSECURE = 0x08, // Insecure TLS without certificate validation. |
| |
| // Deprecated, use OPT_TLS_FAKE. |
| OPT_SSLTCP = OPT_TLS_FAKE, |
| }; |
| |
| PacketSocketFactory() = default; |
| virtual ~PacketSocketFactory() = default; |
| |
| virtual AsyncPacketSocket* CreateUdpSocket(const SocketAddress& address, |
| uint16_t min_port, |
| uint16_t max_port) = 0; |
| virtual AsyncListenSocket* CreateServerTcpSocket( |
| const SocketAddress& local_address, |
| uint16_t min_port, |
| uint16_t max_port, |
| int opts) = 0; |
| |
| // TODO(tommi): Remove once implementations outside of webrtc have been moved |
| // over to the `CreateClientTcpSocket` variant that does not use ProxyInfo. |
| [[deprecated]] virtual AsyncPacketSocket* CreateClientTcpSocket( |
| const SocketAddress& local_address, |
| const SocketAddress& remote_address, |
| const ProxyInfo& proxy_info, |
| const std::string& user_agent, |
| const PacketSocketTcpOptions& tcp_options) { |
| return CreateClientTcpSocket(local_address, remote_address, tcp_options); |
| } |
| |
| // TODO(tommi): Make pure virtual. This temporary implementation is for |
| // derived classes outside of webrtc that don't override this function but |
| // override the deprecated version instead. |
| virtual AsyncPacketSocket* CreateClientTcpSocket( |
| const SocketAddress& local_address, |
| const SocketAddress& remote_address, |
| const PacketSocketTcpOptions& tcp_options) { |
| #pragma clang diagnostic push |
| #pragma clang diagnostic ignored "-Wdeprecated-declarations" |
| return CreateClientTcpSocket(local_address, remote_address, ProxyInfo(), |
| std::string(), tcp_options); |
| #pragma clang diagnostic pop |
| } |
| |
| virtual std::unique_ptr<webrtc::AsyncDnsResolverInterface> |
| CreateAsyncDnsResolver() = 0; |
| |
| private: |
| PacketSocketFactory(const PacketSocketFactory&) = delete; |
| PacketSocketFactory& operator=(const PacketSocketFactory&) = delete; |
| }; |
| |
| } // namespace rtc |
| |
| #endif // API_PACKET_SOCKET_FACTORY_H_ |