IAuthTokenRepository.cs

/// <summary>
/// A durable and secure place to store authentication token into and get out of
/// </summary>
public interface IAuthTokenRepository
{
    /// <summary>
    /// Get the currently active auth token. Implementations MUST decide on the appropriate key
    /// for the persistance record. The interface assumes that only one token will be returned
    /// from the store.
    /// </summary>
    /// <returns><see cref="AuthToken"/></returns>
    Task<AuthToken> GetCurrent();

    /// <summary>
    /// Store the freshly generated auth token. Implementations MUST decide on the appropriate key
    /// for the persistance record.
    /// </summary>
    /// <param name="token">The <see cref="AuthToken"/> to store</param>
    /// <returns><see cref="Task"/></returns>
    Task Save(AuthToken token);
}