1 /* 2 * libjingle 3 * Copyright 2012 Google Inc. All rights reserved. 4 * 5 * Redistribution and use in source and binary forms, with or without 6 * modification, are permitted provided that the following conditions are met: 7 * 8 * 1. Redistributions of source code must retain the above copyright notice, 9 * this list of conditions and the following disclaimer. 10 * 2. Redistributions in binary form must reproduce the above copyright notice, 11 * this list of conditions and the following disclaimer in the documentation 12 * and/or other materials provided with the distribution. 13 * 3. The name of the author may not be used to endorse or promote products 14 * derived from this software without specific prior written permission. 15 * 16 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED 17 * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF 18 * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO 19 * EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, 20 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, 21 * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; 22 * OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, 23 * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR 24 * OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF 25 * ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 26 */ 27 28 #ifndef TALK_P2P_BASE_TRANSPORTDESCRIPTIONFACTORY_H_ 29 #define TALK_P2P_BASE_TRANSPORTDESCRIPTIONFACTORY_H_ 30 31 #include "talk/p2p/base/transportdescription.h" 32 33 namespace talk_base { 34 class SSLIdentity; 35 } 36 37 namespace cricket { 38 39 struct TransportOptions { 40 TransportOptions() : ice_restart(false) {} 41 bool ice_restart; 42 }; 43 44 // Creates transport descriptions according to the supplied configuration. 45 // When creating answers, performs the appropriate negotiation 46 // of the various fields to determine the proper result. 47 class TransportDescriptionFactory { 48 public: 49 // Default ctor; use methods below to set configuration. 50 TransportDescriptionFactory(); 51 SecurePolicy secure() const { return secure_; } 52 // The identity to use when setting up DTLS. 53 talk_base::SSLIdentity* identity() const { return identity_; } 54 55 // Specifies the transport protocol to be use. 56 void set_protocol(TransportProtocol protocol) { protocol_ = protocol; } 57 // Specifies the transport security policy to use. 58 void set_secure(SecurePolicy s) { secure_ = s; } 59 // Specifies the identity to use (only used when secure is not SEC_DISABLED). 60 void set_identity(talk_base::SSLIdentity* identity) { identity_ = identity; } 61 // Specifies the algorithm to use when creating an identity digest. 62 void set_digest_algorithm(const std::string& alg) { digest_alg_ = alg; } 63 64 // Creates a transport description suitable for use in an offer. 65 TransportDescription* CreateOffer(const TransportOptions& options, 66 const TransportDescription* current_description) const; 67 // Create a transport description that is a response to an offer. 68 TransportDescription* CreateAnswer( 69 const TransportDescription* offer, 70 const TransportOptions& options, 71 const TransportDescription* current_description) const; 72 73 private: 74 bool CreateIdentityDigest(TransportDescription* description) const; 75 76 TransportProtocol protocol_; 77 SecurePolicy secure_; 78 talk_base::SSLIdentity* identity_; 79 std::string digest_alg_; 80 }; 81 82 } // namespace cricket 83 84 #endif // TALK_P2P_BASE_TRANSPORTDESCRIPTIONFACTORY_H_ 85