2 files changed, 49 insertions, 16 deletions
diff --git a/src/DotNetOpenAuth.OAuth2/OAuth2/ChannelElements/ClientAuthenticationResult.cs b/src/DotNetOpenAuth.OAuth2/OAuth2/ChannelElements/ClientAuthenticationResult.cs
new file mode 100644
index 0000000..b0f86a9
--- /dev/null
+++ b/src/DotNetOpenAuth.OAuth2/OAuth2/ChannelElements/ClientAuthenticationResult.cs
@@ -0,0 +1,32 @@
+//-----------------------------------------------------------------------
+// <copyright file="ClientAuthenticationResult.cs" company="Andrew Arnott">
+//     Copyright (c) Andrew Arnott. All rights reserved.
+// </copyright>
+//-----------------------------------------------------------------------
+
+namespace DotNetOpenAuth.OAuth2.ChannelElements {
+	/// <summary>
+	/// Describes the various levels at which client information may be extracted from an inbound message.
+	/// </summary>
+	public enum ClientAuthenticationResult {
+		/// <summary>
+		/// No client identification or authentication was discovered.
+		/// </summary>
+		NoAuthenticationRecognized,
+
+		/// <summary>
+		/// The client identified itself, but did not attempt to authenticate itself.
+		/// </summary>
+		ClientIdNotAuthenticated,
+
+		/// <summary>
+		/// The client authenticated itself (provided compelling evidence that it was who it claims to be).
+		/// </summary>
+		ClientAuthenticated,
+
+		/// <summary>
+		/// The client failed in an attempt to authenticate itself, claimed to be an unrecognized client, or otherwise messed up.
+		/// </summary>
+		ClientAuthenticationRejected,
+	}
+}
diff --git a/src/DotNetOpenAuth.OAuth2/OAuth2/ChannelElements/IClientAuthenticationModule.cs b/src/DotNetOpenAuth.OAuth2/OAuth2/ChannelElements/IClientAuthenticationModule.cs
index b7c4792..470e533 100644
--- a/src/DotNetOpenAuth.OAuth2/OAuth2/ChannelElements/IClientAuthenticationModule.cs
+++ b/src/DotNetOpenAuth.OAuth2/OAuth2/ChannelElements/IClientAuthenticationModule.cs
@@ -1,22 +1,23 @@
-namespace DotNetOpenAuth.OAuth2.ChannelElements {
-	using System;
-	using System.Collections.Generic;
-	using System.Linq;
-	using System.Text;
-	using System.Web;
-	using DotNetOpenAuth.Messaging;
-
-	public enum ClientAuthenticationResult {
-		NoAuthenticationRecognized,
-
-		ClientIdNotAuthenticated,
+//-----------------------------------------------------------------------
+// <copyright file="IClientAuthenticationModule.cs" company="Andrew Arnott">
+//     Copyright (c) Andrew Arnott. All rights reserved.
+// </copyright>
+//-----------------------------------------------------------------------
 
-		ClientAuthenticated,
-
-		ClientAuthenticationRejected,
-	}
+namespace DotNetOpenAuth.OAuth2.ChannelElements {
+	using DotNetOpenAuth.Messaging;
 
+	/// <summary>
+	/// An interface implemented by extension that can read incoming messages and extract the client identifier and
+	/// possibly authentication information (like a shared secret, signed nonce, etc.)
+	/// </summary>
 	public interface IClientAuthenticationModule {
+		/// <summary>
+		/// Attempts to extract client identification/authentication information from a message.
+		/// </summary>
+		/// <param name="requestMessage">The incoming message.  Always an instance of <see cref="AuthenticatedClientRequestBase"/></param>
+		/// <param name="clientIdentifier">Receives the client identifier, if one was found.</param>
+		/// <returns>The level of the extracted client information.</returns>
 		ClientAuthenticationResult TryAuthenticateClient(IDirectedProtocolMessage requestMessage, out string clientIdentifier);
 	}
 }