mcs/class/System.ServiceModel/System.ServiceModel/BasicHttpBinding.cs

   1 //
   2 // BasicHttpBinding.cs
   3 //
   4 // Author:
   5 //      Atsushi Enomoto <atsushi@ximian.com>
   6 //
   7 // Copyright (C) 2005-2006 Novell, Inc.  http://www.novell.com
   8 //
   9 // Permission is hereby granted, free of charge, to any person obtaining
  10 // a copy of this software and associated documentation files (the
  11 // "Software"), to deal in the Software without restriction, including
  12 // without limitation the rights to use, copy, modify, merge, publish,
  13 // distribute, sublicense, and/or sell copies of the Software, and to
  14 // permit persons to whom the Software is furnished to do so, subject to
  15 // the following conditions:
  16 //
  17 // The above copyright notice and this permission notice shall be
  18 // included in all copies or substantial portions of the Software.
  19 //
  20 // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
  21 // EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
  22 // MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
  23 // NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
  24 // LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
  25 // OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
  26 // WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
  27 //
  28 using System;
  29 using System.Collections.Generic;
  30 using System.Net;
  31 using System.Net.Security;
  32 using System.ServiceModel.Channels;
  33 using System.ServiceModel.Description;
  34 using System.Text;
  35 using System.Xml;
  36 using System.ServiceModel.Configuration;
  37
  38 namespace System.ServiceModel
  39 {
  40         public class BasicHttpBinding : Binding,
  41                 IBindingRuntimePreferences
  42         {
  43                 bool allow_cookies, bypass_proxy_on_local;
  44                 HostNameComparisonMode host_name_comparison_mode
  45                         = HostNameComparisonMode.StrongWildcard;
  46                 long max_buffer_pool_size = 0x80000;
  47                 int max_buffer_size = 0x10000;
  48                 long max_recv_message_size = 0x10000;
  49                 WSMessageEncoding message_encoding
  50                         = WSMessageEncoding.Text;
  51                 Uri proxy_address;
  52                 XmlDictionaryReaderQuotas reader_quotas
  53                         = new XmlDictionaryReaderQuotas ();
  54                 EnvelopeVersion env_version = EnvelopeVersion.Soap11;
  55                 Encoding text_encoding = new UTF8Encoding ();
  56                 TransferMode transfer_mode
  57                          = TransferMode.Buffered;
  58                 bool use_default_web_proxy = true;
  59                 BasicHttpSecurity security;
  60
  61                 public BasicHttpBinding ()
  62                         : this (BasicHttpSecurityMode.None)
  63                 {
  64                 }
  65
  66 #if !NET_2_1
  67                 public BasicHttpBinding (string configurationName)
  68                         : this ()
  69                 {
  70                         BindingsSection bindingsSection = ConfigUtil.BindingsSection;
  71                         BasicHttpBindingElement el =
  72                                 bindingsSection.BasicHttpBinding.Bindings [configurationName];
  73
  74                         el.ApplyConfiguration (this);
  75                 }
  76 #endif
  77
  78                 public BasicHttpBinding (
  79                         BasicHttpSecurityMode securityMode)
  80                 {
  81                         security = new BasicHttpSecurity (securityMode);
  82                 }
  83
  84                 public bool AllowCookies {
  85                         get { return allow_cookies; }
  86                         set { allow_cookies = value; }
  87                 }
  88
  89                 public bool BypassProxyOnLocal {
  90                         get { return bypass_proxy_on_local; }
  91                         set { bypass_proxy_on_local = value; }
  92                 }
  93
  94 #if NET_2_1
  95                 public bool EnableHttpCookieContainer { get; set; }
  96 #endif
  97
  98                 public HostNameComparisonMode HostNameComparisonMode {
  99                         get { return host_name_comparison_mode; }
 100                         set { host_name_comparison_mode = value; }
 101                 }
 102
 103                 public long MaxBufferPoolSize {
 104                         get { return max_buffer_pool_size; }
 105                         set {
 106                                 if (value <= 0)
 107                                         throw new ArgumentOutOfRangeException ();
 108                                 max_buffer_pool_size = value;
 109                         }
 110                 }
 111
 112                 public int MaxBufferSize {
 113                         get { return max_buffer_size; }
 114                         set {
 115                                 if (value <= 0)
 116                                         throw new ArgumentOutOfRangeException ();
 117                                 max_buffer_size = value;
 118                         }
 119                 }
 120
 121                 public long MaxReceivedMessageSize {
 122                         get { return max_recv_message_size; }
 123                         set {
 124                                 if (value <= 0)
 125                                         throw new ArgumentOutOfRangeException ();
 126                                 max_recv_message_size = value;
 127                         }
 128                 }
 129
 130                 public WSMessageEncoding MessageEncoding {
 131                         get { return message_encoding; }
 132                         set { message_encoding = value; }
 133                 }
 134
 135                 public Uri ProxyAddress {
 136                         get { return proxy_address; }
 137                         set { proxy_address = value; }
 138                 }
 139
 140                 public XmlDictionaryReaderQuotas ReaderQuotas {
 141                         get { return reader_quotas; }
 142                         set { reader_quotas = value; }
 143                 }
 144
 145                 public override string Scheme {
 146                         get {
 147                                 switch (Security.Mode) {
 148                                 case BasicHttpSecurityMode.Transport:
 149                                 case BasicHttpSecurityMode.TransportWithMessageCredential:
 150                                         return Uri.UriSchemeHttps;
 151                                 default:
 152                                         return Uri.UriSchemeHttp;
 153                                 }
 154                         }
 155                 }
 156
 157                 public BasicHttpSecurity Security {
 158                         get { return security; }
 159                 }
 160
 161                 public EnvelopeVersion EnvelopeVersion {
 162                         get { return env_version; }
 163                 }
 164
 165                 public Encoding TextEncoding {
 166                         get { return text_encoding; }
 167                         set { text_encoding = value; }
 168                 }
 169
 170                 public TransferMode TransferMode {
 171                         get { return transfer_mode; }
 172                         set { transfer_mode = value; }
 173                 }
 174
 175                 public bool UseDefaultWebProxy {
 176                         get { return use_default_web_proxy; }
 177                         set { use_default_web_proxy = value; }
 178                 }
 179
 180                 public override BindingElementCollection
 181                         CreateBindingElements ()
 182                 {
 183                         var list = new List<BindingElement> ();
 184
 185                         var security = CreateSecurityBindingElement ();
 186                         if (security != null)
 187                                 list.Add (security);
 188
 189 #if NET_2_1
 190                         if (EnableHttpCookieContainer)
 191                                 list.Add (new HttpCookieContainerBindingElement ());
 192 #endif
 193
 194                         list.Add (BuildMessageEncodingBindingElement ());
 195                         list.Add (GetTransport ());
 196
 197                         return new BindingElementCollection (list.ToArray ());
 198                 }
 199
 200                 SecurityBindingElement CreateSecurityBindingElement ()
 201                 {
 202             SecurityBindingElement element;
 203                         switch (Security.Mode) {
 204 #if !NET_2_1
 205                         case BasicHttpSecurityMode.Message:
 206                                 if (Security.Message.ClientCredentialType != BasicHttpMessageCredentialType.Certificate)
 207                                         throw new InvalidOperationException ("When Message security is enabled in a BasicHttpBinding, the message security credential type must be BasicHttpMessageCredentialType.Certificate.");
 208                                 element = SecurityBindingElement.CreateMutualCertificateBindingElement (
 209                                     MessageSecurityVersion.WSSecurity10WSTrustFebruary2005WSSecureConversationFebruary2005WSSecurityPolicy11BasicSecurityProfile10);
 210                 break;
 211
 212                         case BasicHttpSecurityMode.TransportWithMessageCredential:
 213                 if (Security.Message.ClientCredentialType != BasicHttpMessageCredentialType.Certificate)
 214                     // FIXME: pass proper security token parameters.
 215                     element = SecurityBindingElement.CreateCertificateOverTransportBindingElement ();
 216                 else
 217                     element = new AsymmetricSecurityBindingElement ();
 218                 break;
 219 #endif
 220                         default:
 221                                 return null;
 222                         }
 223
 224             element.SetKeyDerivation (false);
 225             element.SecurityHeaderLayout = SecurityHeaderLayout.Lax;
 226             return element;
 227                 }
 228
 229                 MessageEncodingBindingElement BuildMessageEncodingBindingElement ()
 230                 {
 231                         if (MessageEncoding == WSMessageEncoding.Text) {
 232                                 TextMessageEncodingBindingElement tm = new TextMessageEncodingBindingElement (
 233                                         MessageVersion.CreateVersion (EnvelopeVersion, AddressingVersion.None), TextEncoding);
 234 #if !NET_2_1
 235                                 ReaderQuotas.CopyTo (tm.ReaderQuotas);
 236 #endif
 237                                 return tm;
 238                         }
 239                         else
 240 #if NET_2_1
 241                                 throw new SystemException ("INTERNAL ERROR: should not happen");
 242 #else
 243                                 return new MtomMessageEncodingBindingElement (
 244                                         MessageVersion.CreateVersion (EnvelopeVersion, AddressingVersion.None), TextEncoding);
 245 #endif
 246                 }
 247
 248                 TransportBindingElement GetTransport ()
 249                 {
 250                         HttpTransportBindingElement h;
 251                         switch (Security.Mode) {
 252                         case BasicHttpSecurityMode.Transport:
 253                         case BasicHttpSecurityMode.TransportWithMessageCredential:
 254                                 h = new HttpsTransportBindingElement ();
 255                                 break;
 256                         default:
 257                                 h = new HttpTransportBindingElement ();
 258                                 break;
 259                         }
 260
 261                         h.AllowCookies = AllowCookies;
 262                         h.BypassProxyOnLocal = BypassProxyOnLocal;
 263                         h.HostNameComparisonMode = HostNameComparisonMode;
 264                         h.MaxBufferPoolSize = MaxBufferPoolSize;
 265                         h.MaxBufferSize = MaxBufferSize;
 266                         h.MaxReceivedMessageSize = MaxReceivedMessageSize;
 267                         h.ProxyAddress = ProxyAddress;
 268                         h.UseDefaultWebProxy = UseDefaultWebProxy;
 269                         h.TransferMode = TransferMode;
 270 #if NET_4_0
 271                         h.ExtendedProtectionPolicy = Security.Transport.ExtendedProtectionPolicy;
 272 #endif
 273
 274 #if !NET_2_1
 275                         switch (Security.Mode) {
 276                         case BasicHttpSecurityMode.Transport:
 277                                 switch (Security.Transport.ClientCredentialType) {
 278                                 case HttpClientCredentialType.Basic:
 279                                         h.AuthenticationScheme = AuthenticationSchemes.Basic;
 280                                         break;
 281                                 case HttpClientCredentialType.Ntlm:
 282                                         h.AuthenticationScheme = AuthenticationSchemes.Ntlm;
 283                                         break;
 284                                 case HttpClientCredentialType.Windows:
 285                                         h.AuthenticationScheme = AuthenticationSchemes.Negotiate;
 286                                         break;
 287                                 case HttpClientCredentialType.Digest:
 288                                         h.AuthenticationScheme = AuthenticationSchemes.Digest;
 289                                         break;
 290                                 case HttpClientCredentialType.Certificate:
 291                                         var https = (HttpsTransportBindingElement) h;
 292                                         https.RequireClientCertificate = true;
 293                                         break;
 294                                 }
 295                                 break;
 296                         case BasicHttpSecurityMode.TransportCredentialOnly:
 297                                 switch (Security.Transport.ClientCredentialType) {
 298                                 case HttpClientCredentialType.Basic:
 299                                         h.AuthenticationScheme = AuthenticationSchemes.Basic;
 300                                         break;
 301                                 case HttpClientCredentialType.Ntlm:
 302                                         h.AuthenticationScheme = AuthenticationSchemes.Ntlm;
 303                                         break;
 304                                 case HttpClientCredentialType.Windows:
 305                                         h.AuthenticationScheme = AuthenticationSchemes.Negotiate;
 306                                         break;
 307                                 case HttpClientCredentialType.Digest:
 308                                         h.AuthenticationScheme = AuthenticationSchemes.Digest;
 309                                         break;
 310                                 case HttpClientCredentialType.Certificate:
 311                                         throw new InvalidOperationException ("Certificate-based client authentication is not supported by 'TransportCredentialOnly' mode.");
 312                                 }
 313                                 break;
 314                         }
 315 #endif
 316
 317                         return h;
 318                 }
 319
 320                 // explicit interface implementations
 321
 322                 bool IBindingRuntimePreferences.ReceiveSynchronously {
 323                         get { return false; }
 324                 }
 325         }
 326 }