1 files changed, 40 insertions, 0 deletions
diff --git a/src/DotNetOpenAuth.OAuth.ServiceProvider/OAuth/ChannelElements/ITokenGenerator.cs b/src/DotNetOpenAuth.OAuth.ServiceProvider/OAuth/ChannelElements/ITokenGenerator.cs
new file mode 100644
index 0000000..ce22479
--- /dev/null
+++ b/src/DotNetOpenAuth.OAuth.ServiceProvider/OAuth/ChannelElements/ITokenGenerator.cs
@@ -0,0 +1,40 @@
+//-----------------------------------------------------------------------
+// <copyright file="ITokenGenerator.cs" company="Andrew Arnott">
+//     Copyright (c) Andrew Arnott. All rights reserved.
+// </copyright>
+//-----------------------------------------------------------------------
+
+namespace DotNetOpenAuth.OAuth.ChannelElements {
+	/// <summary>
+	/// An interface allowing OAuth hosts to inject their own algorithm for generating tokens and secrets.
+	/// </summary>
+	public interface ITokenGenerator {
+		/// <summary>
+		/// Generates a new token to represent a not-yet-authorized request to access protected resources.
+		/// </summary>
+		/// <param name="consumerKey">The consumer that requested this token.</param>
+		/// <returns>The newly generated token.</returns>
+		/// <remarks>
+		/// This method should not store the newly generated token in any persistent store.
+		/// This will be done in <see cref="ITokenManager.StoreNewRequestToken"/>.
+		/// </remarks>
+		string GenerateRequestToken(string consumerKey);
+
+		/// <summary>
+		/// Generates a new token to represent an authorized request to access protected resources.
+		/// </summary>
+		/// <param name="consumerKey">The consumer that requested this token.</param>
+		/// <returns>The newly generated token.</returns>
+		/// <remarks>
+		/// This method should not store the newly generated token in any persistent store.
+		/// This will be done in <see cref="ITokenManager.ExpireRequestTokenAndStoreNewAccessToken"/>.
+		/// </remarks>
+		string GenerateAccessToken(string consumerKey);
+
+		/// <summary>
+		/// Returns a cryptographically strong random string for use as a token secret.
+		/// </summary>
+		/// <returns>The generated string.</returns>
+		string GenerateSecret();
+	}
+}