1 files changed, 129 insertions, 0 deletions
diff --git a/qpid/dotnet/Qpid.Client/Client/Security/CallbackHandlerRegistry.cs b/qpid/dotnet/Qpid.Client/Client/Security/CallbackHandlerRegistry.cs
new file mode 100644
index 0000000000..9ac0381850
--- /dev/null
+++ b/qpid/dotnet/Qpid.Client/Client/Security/CallbackHandlerRegistry.cs
@@ -0,0 +1,129 @@
+/*
+ *
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ * 
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ * 
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ *
+ */
+
+using System;
+using System.Collections;
+using System.Configuration;
+using System.Text;
+using Apache.Qpid.Sasl;
+using Apache.Qpid.Sasl.Mechanisms;
+
+using Apache.Qpid.Client.Configuration;
+
+namespace Apache.Qpid.Client.Security
+{
+
+   /// <summary>
+   /// Helper class to map SASL mechanisms to our 
+   /// internal ISaslCallbackHandler implementations.
+   /// </summary>
+   /// <remarks>
+   /// The set of configured callback handlers and their order
+   /// controls the selection of the SASL mechanism used for authentication.
+   /// <para>
+   /// You can either replace the default handler for CRAM-MD5 and PLAIN
+   /// authentication (the two default options) using the application 
+   /// configuration file. Configuration is done by especifying the SASL
+   /// mechanism name (e.g PLAIN) and the type implementing the callback handler
+   /// used to provide any data required by the mechanism like username and password.
+   /// </para>
+   /// <para>
+   /// Callback handler types should implement the IAMQCallbackHandler interface.
+   /// </para>
+   /// <para>
+   /// New callbacks or authentication mechanisms can be configured like this:
+   /// </para>
+   /// <example><![CDATA[
+   /// <configuration>
+   ///   <configSections>
+   ///      <sectionGroup name="qpid.client">
+   ///         <section name="authentication" type="Apache.Qpid.Client.Configuration.AuthenticationConfigurationSectionHandler, Apache.Qpid.Client"/>
+   ///      </sectionGroup>
+   ///   </configSections>
+   ///   <qpid.client>
+   ///      <authentication>
+   ///         <add key="TEST" value="Apache.Qpid.Client.Tests.Security.TestCallbackHandler, Apache.Qpid.Client.Tests"/>
+   ///      </authentication>
+   ///   </qpid.client>
+   /// </configuration>
+   /// ]]></example>
+   /// </remarks>
+   public sealed class CallbackHandlerRegistry
+   {
+      private static CallbackHandlerRegistry _instance = 
+         new CallbackHandlerRegistry();
+      private OrderedHashTable _mechanism2HandlerMap;
+      private string[] _mechanisms;
+
+      public static CallbackHandlerRegistry Instance
+      {
+         get { return _instance; }
+      }
+
+      public string[] Mechanisms
+      {
+         get { return _mechanisms; }
+      }
+
+      private CallbackHandlerRegistry()
+      {
+         _mechanism2HandlerMap = (OrderedHashTable)
+            ConfigurationSettings.GetConfig("qpid.client/authentication");
+
+         // configure default options if not available
+         if ( _mechanism2HandlerMap == null )
+            _mechanism2HandlerMap = new OrderedHashTable();
+
+         if ( !_mechanism2HandlerMap.Contains(ExternalSaslClient.Mechanism) )
+            _mechanism2HandlerMap.Add(ExternalSaslClient.Mechanism, typeof(UsernamePasswordCallbackHandler));
+         if ( !_mechanism2HandlerMap.Contains(CramMD5SaslClient.Mechanism) )
+            _mechanism2HandlerMap.Add(CramMD5SaslClient.Mechanism, typeof(UsernamePasswordCallbackHandler));
+         if ( !_mechanism2HandlerMap.Contains(CramMD5HexSaslClient.Mechanism) )
+            _mechanism2HandlerMap.Add(CramMD5HexSaslClient.Mechanism, typeof(UsernamePasswordCallbackHandler));
+         if ( !_mechanism2HandlerMap.Contains(PlainSaslClient.Mechanism) )
+            _mechanism2HandlerMap.Add(PlainSaslClient.Mechanism, typeof(UsernamePasswordCallbackHandler));
+
+         _mechanisms = new string[_mechanism2HandlerMap.Count];
+         _mechanism2HandlerMap.OrderedKeys.CopyTo(_mechanisms, 0);
+      }
+
+      public bool IsSupportedMechanism(string mechanism)
+      {
+         return _mechanism2HandlerMap.Contains(mechanism);
+      }
+
+      public string ChooseMechanism(string mechanisms)
+      {
+         IList mechs = mechanisms.Split(' ');
+         foreach ( string supportedMech in _mechanisms )
+         {
+            if ( mechs.Contains(supportedMech) )
+               return supportedMech;
+         }
+         return null;
+      }
+
+      public Type GetCallbackHandler(string mechanism)
+      {
+         return (Type)_mechanism2HandlerMap[mechanism];
+      }
+   }
+}