NetHttpsBinding.cs 10 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300
  1. // <copyright>
  2. // Copyright (c) Microsoft Corporation. All rights reserved.
  3. // </copyright>
  4. namespace System.ServiceModel
  5. {
  6. using System;
  7. using System.ComponentModel;
  8. using System.Configuration;
  9. using System.Runtime;
  10. using System.ServiceModel.Channels;
  11. using System.ServiceModel.Configuration;
  12. using System.Xml;
  13. public class NetHttpsBinding : HttpBindingBase
  14. {
  15. BinaryMessageEncodingBindingElement binaryMessageEncodingBindingElement;
  16. ReliableSessionBindingElement session;
  17. OptionalReliableSession reliableSession;
  18. NetHttpMessageEncoding messageEncoding;
  19. BasicHttpsSecurity basicHttpsSecurity;
  20. public NetHttpsBinding()
  21. : this(BasicHttpsSecurity.DefaultMode)
  22. {
  23. }
  24. public NetHttpsBinding(BasicHttpsSecurityMode securityMode)
  25. : base()
  26. {
  27. this.Initialize();
  28. this.basicHttpsSecurity.Mode = securityMode;
  29. }
  30. public NetHttpsBinding(BasicHttpsSecurityMode securityMode, bool reliableSessionEnabled)
  31. : this(securityMode)
  32. {
  33. this.ReliableSession.Enabled = reliableSessionEnabled;
  34. }
  35. public NetHttpsBinding(string configurationName)
  36. : base()
  37. {
  38. this.Initialize();
  39. this.ApplyConfiguration(configurationName);
  40. }
  41. [DefaultValue(NetHttpMessageEncoding.Binary)]
  42. public NetHttpMessageEncoding MessageEncoding
  43. {
  44. get { return this.messageEncoding; }
  45. set { this.messageEncoding = value; }
  46. }
  47. public BasicHttpsSecurity Security
  48. {
  49. get
  50. {
  51. return this.basicHttpsSecurity;
  52. }
  53. set
  54. {
  55. if (value == null)
  56. {
  57. throw FxTrace.Exception.ArgumentNull("value");
  58. }
  59. this.basicHttpsSecurity = value;
  60. }
  61. }
  62. internal override BasicHttpSecurity BasicHttpSecurity
  63. {
  64. get
  65. {
  66. return this.basicHttpsSecurity.BasicHttpSecurity;
  67. }
  68. }
  69. public OptionalReliableSession ReliableSession
  70. {
  71. get
  72. {
  73. return this.reliableSession;
  74. }
  75. set
  76. {
  77. if (value == null)
  78. {
  79. throw FxTrace.Exception.ArgumentNull("value");
  80. }
  81. this.reliableSession.CopySettings(value);
  82. }
  83. }
  84. public WebSocketTransportSettings WebSocketSettings
  85. {
  86. get
  87. {
  88. return this.InternalWebSocketSettings;
  89. }
  90. }
  91. public override IChannelFactory<TChannel> BuildChannelFactory<TChannel>(BindingParameterCollection parameters)
  92. {
  93. if ((this.BasicHttpSecurity.Mode == BasicHttpSecurityMode.Transport ||
  94. this.BasicHttpSecurity.Mode == BasicHttpSecurityMode.TransportCredentialOnly) &&
  95. this.BasicHttpSecurity.Transport.ClientCredentialType == HttpClientCredentialType.InheritedFromHost)
  96. {
  97. throw FxTrace.Exception.AsError(new InvalidOperationException(SR.GetString(SR.HttpClientCredentialTypeInvalid, this.BasicHttpSecurity.Transport.ClientCredentialType)));
  98. }
  99. return base.BuildChannelFactory<TChannel>(parameters);
  100. }
  101. public override BindingElementCollection CreateBindingElements()
  102. {
  103. this.CheckSettings();
  104. // return collection of BindingElements
  105. BindingElementCollection bindingElements = new BindingElementCollection();
  106. // order of BindingElements is important
  107. // add session
  108. if (this.reliableSession.Enabled)
  109. {
  110. bindingElements.Add(this.session);
  111. }
  112. // add security (*optional)
  113. SecurityBindingElement messageSecurity = this.BasicHttpSecurity.CreateMessageSecurity();
  114. if (messageSecurity != null)
  115. {
  116. bindingElements.Add(messageSecurity);
  117. }
  118. // add encoding
  119. switch (this.MessageEncoding)
  120. {
  121. case NetHttpMessageEncoding.Text:
  122. bindingElements.Add(this.TextMessageEncodingBindingElement);
  123. break;
  124. case NetHttpMessageEncoding.Mtom:
  125. bindingElements.Add(this.MtomMessageEncodingBindingElement);
  126. break;
  127. default:
  128. bindingElements.Add(this.binaryMessageEncodingBindingElement);
  129. break;
  130. }
  131. // add transport (http or https)
  132. bindingElements.Add(this.GetTransport());
  133. return bindingElements.Clone();
  134. }
  135. [EditorBrowsable(EditorBrowsableState.Never)]
  136. public bool ShouldSerializeReliableSession()
  137. {
  138. return this.ReliableSession.Ordered != ReliableSessionDefaults.Ordered
  139. || this.ReliableSession.InactivityTimeout != ReliableSessionDefaults.InactivityTimeout
  140. || this.ReliableSession.Enabled != ReliableSessionDefaults.Enabled;
  141. }
  142. [EditorBrowsable(EditorBrowsableState.Never)]
  143. public bool ShouldSerializeSecurity()
  144. {
  145. return this.Security.InternalShouldSerialize();
  146. }
  147. internal override void SetReaderQuotas(XmlDictionaryReaderQuotas readerQuotas)
  148. {
  149. readerQuotas.CopyTo(this.binaryMessageEncodingBindingElement.ReaderQuotas);
  150. }
  151. internal override EnvelopeVersion GetEnvelopeVersion()
  152. {
  153. return EnvelopeVersion.Soap12;
  154. }
  155. internal override void CheckSettings()
  156. {
  157. base.CheckSettings();
  158. // In the Win8 profile, Mtom is not supported.
  159. if ((this.MessageEncoding == NetHttpMessageEncoding.Mtom) && UnsafeNativeMethods.IsTailoredApplication.Value)
  160. {
  161. throw DiagnosticUtility.ExceptionUtility.ThrowHelperError(new NotSupportedException(SR.GetString(SR.UnsupportedBindingProperty, "MessageEncoding", this.MessageEncoding)));
  162. }
  163. }
  164. void Initialize()
  165. {
  166. this.messageEncoding = NetHttpBindingDefaults.MessageEncoding;
  167. this.binaryMessageEncodingBindingElement = new BinaryMessageEncodingBindingElement() { MessageVersion = MessageVersion.Soap12WSAddressing10 };
  168. this.TextMessageEncodingBindingElement.MessageVersion = MessageVersion.Soap12WSAddressing10;
  169. this.MtomMessageEncodingBindingElement.MessageVersion = MessageVersion.Soap12WSAddressing10;
  170. this.session = new ReliableSessionBindingElement();
  171. this.reliableSession = new OptionalReliableSession(this.session);
  172. this.InternalWebSocketSettings.TransportUsage = NetHttpBindingDefaults.TransportUsage;
  173. this.InternalWebSocketSettings.SubProtocol = WebSocketTransportSettings.SoapSubProtocol;
  174. this.basicHttpsSecurity = new BasicHttpsSecurity();
  175. }
  176. void InitializeFrom(HttpTransportBindingElement transport, MessageEncodingBindingElement encoding, ReliableSessionBindingElement session)
  177. {
  178. this.InitializeFrom(transport, encoding);
  179. if (encoding is BinaryMessageEncodingBindingElement)
  180. {
  181. this.messageEncoding = NetHttpMessageEncoding.Binary;
  182. BinaryMessageEncodingBindingElement binary = (BinaryMessageEncodingBindingElement)encoding;
  183. this.ReaderQuotas = binary.ReaderQuotas;
  184. }
  185. if (encoding is TextMessageEncodingBindingElement)
  186. {
  187. this.messageEncoding = NetHttpMessageEncoding.Text;
  188. }
  189. else if (encoding is MtomMessageEncodingBindingElement)
  190. {
  191. this.messageEncoding = NetHttpMessageEncoding.Mtom;
  192. }
  193. if (session != null)
  194. {
  195. // only set properties that have standard binding manifestations
  196. this.session.InactivityTimeout = session.InactivityTimeout;
  197. this.session.Ordered = session.Ordered;
  198. }
  199. }
  200. bool IsBindingElementsMatch(HttpTransportBindingElement transport, MessageEncodingBindingElement encoding, ReliableSessionBindingElement session)
  201. {
  202. if (this.reliableSession.Enabled)
  203. {
  204. if (!this.session.IsMatch(session))
  205. {
  206. return false;
  207. }
  208. }
  209. else if (session != null)
  210. {
  211. return false;
  212. }
  213. switch (this.MessageEncoding)
  214. {
  215. case NetHttpMessageEncoding.Text:
  216. if (!this.TextMessageEncodingBindingElement.IsMatch(encoding))
  217. {
  218. return false;
  219. }
  220. break;
  221. case NetHttpMessageEncoding.Mtom:
  222. if (!this.MtomMessageEncodingBindingElement.IsMatch(encoding))
  223. {
  224. return false;
  225. }
  226. break;
  227. default: // NetHttpMessageEncoding.Binary
  228. if (!this.binaryMessageEncodingBindingElement.IsMatch(encoding))
  229. {
  230. return false;
  231. }
  232. break;
  233. }
  234. if (!this.GetTransport().IsMatch(transport))
  235. {
  236. return false;
  237. }
  238. return true;
  239. }
  240. void ApplyConfiguration(string configurationName)
  241. {
  242. NetHttpsBindingCollectionElement section = NetHttpsBindingCollectionElement.GetBindingCollectionElement();
  243. NetHttpsBindingElement element = section.Bindings[configurationName];
  244. if (element == null)
  245. {
  246. throw FxTrace.Exception.AsError(new ConfigurationErrorsException(SR.GetString(
  247. SR.ConfigInvalidBindingConfigurationName,
  248. configurationName,
  249. ConfigurationStrings.NetHttpBindingCollectionElementName)));
  250. }
  251. else
  252. {
  253. element.ApplyConfiguration(this);
  254. }
  255. }
  256. }
  257. }