Added OpenID pluggable behaviors support, including a sample PPID generator.

1 files changed, 20 insertions, 2 deletions

diff --git a/samples/OpenIdProviderMvc/Code/AnonymousIdentifierProvider.cs b/samples/OpenIdProviderMvc/Code/AnonymousIdentifierProvider.cs
index bed4e82..6dc210d 100644
--- a/samples/OpenIdProviderMvc/Code/AnonymousIdentifierProvider.cs
+++ b/samples/OpenIdProviderMvc/Code/AnonymousIdentifierProvider.cs
@@ -1,16 +1,29 @@
 namespace OpenIdProviderMvc.Code {
 	using System;
 	using System.Web.Security;
-	using DotNetOpenAuth.ApplicationBlock.Provider;
 	using DotNetOpenAuth.OpenId;
 	using DotNetOpenAuth.OpenId.Provider;
 	using OpenIdProviderMvc.Models;
 
 	internal class AnonymousIdentifierProvider : PrivatePersonalIdentifierProviderBase {
+		/// <summary>
+		/// Initializes a new instance of the <see cref="AnonymousIdentifierProvider"/> class.
+		/// </summary>
 		internal AnonymousIdentifierProvider()
 			: base(Util.GetAppPathRootedUri("anon?id=")) {
 		}
 
+		/// <summary>
+		/// Gets the salt to use for generating an anonymous identifier for a given OP local identifier.
+		/// </summary>
+		/// <param name="localIdentifier">The OP local identifier.</param>
+		/// <returns>The salt to use in the hash.</returns>
+		/// <remarks>
+		/// It is important that this method always return the same value for a given
+		/// <paramref name="localIdentifier"/>.
+		/// New salts can be generated for local identifiers without previously assigned salt
+		/// values by calling <see cref="CreateSalt"/> or by a custom method.
+		/// </remarks>
 		protected override byte[] GetHashSaltForLocalIdentifier(Identifier localIdentifier) {
 			// This is just a sample with no database... a real web app MUST return 
 			// a reasonable salt here and have that salt be persistent for each user.
@@ -18,7 +31,12 @@
 			string username = User.GetUserFromClaimedIdentifier(new Uri(localIdentifier));
 			string salt = membership.GetSalt(username);
 			return Convert.FromBase64String(salt);
-			////return AnonymousIdentifierProviderBase.GetNewSalt(5);
+
+			// If users were encountered without a salt, one could be generated like this,
+			// and would also need to be saved to the user's account.
+			//// var newSalt = AnonymousIdentifierProviderBase.GetNewSalt(5);
+			//// user.Salt = newSalt;
+			//// return newSalt;
 		}
 	}
 }