summaryrefslogtreecommitdiffstats
path: root/src/DotNetOpenAuth.OAuth2/OAuth2/IClientAuthorizationTracker.cs
blob: 73b7a4452d4d07a1f1d52992ce81850ea3f5217a (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
//-----------------------------------------------------------------------
// <copyright file="IClientAuthorizationTracker.cs" company="Outercurve Foundation">
//     Copyright (c) Outercurve Foundation. All rights reserved.
// </copyright>
//-----------------------------------------------------------------------

namespace DotNetOpenAuth.OAuth2 {
	using System;
	using System.Diagnostics.Contracts;

	/// <summary>
	/// A token manager implemented by some clients to assist in tracking authorization state.
	/// </summary>
	[ContractClass(typeof(IClientAuthorizationTrackerContract))]
	public interface IClientAuthorizationTracker {
		/// <summary>
		/// Gets the state of the authorization for a given callback URL and client state.
		/// </summary>
		/// <param name="callbackUrl">The callback URL.</param>
		/// <param name="clientState">State of the client stored at the beginning of an authorization request.</param>
		/// <returns>The authorization state; may be <c>null</c> if no authorization state matches.</returns>
		IAuthorizationState GetAuthorizationState(Uri callbackUrl, string clientState);
	}

	/// <summary>
	/// Contract class for the <see cref="IClientAuthorizationTracker"/> interface.
	/// </summary>
	[ContractClassFor(typeof(IClientAuthorizationTracker))]
	internal abstract class IClientAuthorizationTrackerContract : IClientAuthorizationTracker {
		/// <summary>
		/// Prevents a default instance of the <see cref="IClientAuthorizationTrackerContract"/> class from being created.
		/// </summary>
		private IClientAuthorizationTrackerContract() {
		}

		#region IClientTokenManager Members

		/// <summary>
		/// Gets the state of the authorization for a given callback URL and client state.
		/// </summary>
		/// <param name="callbackUrl">The callback URL.</param>
		/// <param name="clientState">State of the client stored at the beginning of an authorization request.</param>
		/// <returns>
		/// The authorization state; may be <c>null</c> if no authorization state matches.
		/// </returns>
		IAuthorizationState IClientAuthorizationTracker.GetAuthorizationState(Uri callbackUrl, string clientState) {
			Requires.NotNull(callbackUrl, "callbackUrl");
			throw new NotImplementedException();
		}

		#endregion
	}
}