Merge pull request #70 from Azure-Samples/kkrishna/2-2

Added helper methods

Author: Kalyan Krishna

Microsoft.Identity.Web/Client/TokenCacheProviders/InMemory/MSALAppMemoryTokenCacheProviderExtension.cs

@@ -32,6 +32,10 @@ namespace Microsoft.Identity.Web.Client.TokenCacheProviders
 {
     public static class MSALAppMemoryTokenCacheProviderExtension
     {
+        /// <summary>Adds both the app and per-user in-memory token caches.</summary>
+        /// <param name="services">The services collection to add to.</param>
+        /// <param name="cacheOptions">the MSALMemoryTokenCacheOptions allows the caller to set the token cache expiration</param>
+        /// <returns></returns>
         public static IServiceCollection AddInMemoryTokenCaches(this IServiceCollection services, MSALMemoryTokenCacheOptions cacheOptions = null)
         {
             var memoryCacheoptions = (cacheOptions == null) ? new MSALMemoryTokenCacheOptions { AbsoluteExpiration = DateTimeOffset.Now.AddDays(14) }
@@ -43,9 +47,9 @@ public static IServiceCollection AddInMemoryTokenCaches(this IServiceCollection
         }
 
 
-        /// <summary>Adds the in memory based application token cache to the service collection.</summary>
+        /// <summary>Adds the in-memory based application token cache to the service collection.</summary>
         /// <param name="services">The services collection to add to.</param>
-        /// <param name="cacheOptions"></param>
+        /// <param name="cacheOptions">the MSALMemoryTokenCacheOptions allows the caller to set the token cache expiration</param>
         public static IServiceCollection AddInMemoryAppTokenCache(this IServiceCollection services, MSALMemoryTokenCacheOptions cacheOptions)
         {
             services.AddMemoryCache();
@@ -61,8 +65,9 @@ public static IServiceCollection AddInMemoryAppTokenCache(this IServiceCollectio
             return services;
         }
 
-        /// <summary>Adds the in memory based per user token cache to the service collection.</summary>
+        /// <summary>Adds the in-memory based per user token cache to the service collection.</summary>
         /// <param name="services">The services collection to add to.</param>
+        /// <param name="cacheOptions">the MSALMemoryTokenCacheOptions allows the caller to set the token cache expiration</param>
         /// <returns></returns>
         public static IServiceCollection AddInMemoryPerUserTokenCache(this IServiceCollection services, MSALMemoryTokenCacheOptions cacheOptions)
         {

Microsoft.Identity.Web/Client/TokenCacheProviders/Session/MSALAppSessionTokenCacheProvider.cs

@@ -65,6 +65,9 @@ public class MSALAppSessionTokenCacheProvider : IMSALAppTokenCacheProvider
         /// </summary>
         private string AppId;
 
+        /// <summary>Initializes a new instance of the <see cref="MSALAppSessionTokenCacheProvider"/> class.</summary>
+        /// <param name="azureAdOptionsAccessor">The azure ad options accessor.</param>
+        /// <exception cref="ArgumentNullException">AzureADOptions - The app token cache needs {nameof(AzureADOptions)}</exception>
         public MSALAppSessionTokenCacheProvider(IOptionsMonitor<AzureADOptions> azureAdOptionsAccessor)
         {
             if (azureAdOptionsAccessor.CurrentValue == null && string.IsNullOrWhiteSpace(azureAdOptionsAccessor.CurrentValue.ClientId))

Microsoft.Identity.Web/Client/TokenCacheProviders/Session/MSALAppSessionTokenCacheProviderExtension.cs

@@ -30,6 +30,17 @@ namespace Microsoft.Identity.Web.Client.TokenCacheProviders
 {
     public static class MSALAppSessionTokenCacheProviderExtension
     {
+        /// <summary>Adds both App and per-user session token caches.</summary>
+        /// <param name="services">The services collection to add to.</param>
+        /// <returns></returns>
+        public static IServiceCollection AddSessionTokenCaches(this IServiceCollection services)
+        {
+            AddSessionAppTokenCache(services);
+            AddSessionPerUserTokenCache(services);
+
+            return services;
+        }
+
         /// <summary>Adds the Http session based application token cache to the service collection.</summary>
         /// <param name="services">The services collection to add to.</param>
         /// <returns></returns>

Microsoft.Identity.Web/Client/TokenCacheProviders/Sql/MSALAppSqlTokenCacheProviderExtension.cs

@@ -32,11 +32,20 @@ namespace Microsoft.Identity.Web.Client.TokenCacheProviders
 {
     public static class MSALAppSqlTokenCacheProviderExtension
     {
-        /// <summary>
-        /// Adds the Sql Server based application token cache to the service collection.
-        /// </summary>
-        /// <param name="services">The services collection to add to.</param>
+        /// <summary>Adds the app and per user SQL token caches.</summary>
         /// <param name="configuration">The configuration instance from where this method pulls the connection string to the Sql database.</param>
+        /// <param name="sqlTokenCacheOptions">The MSALSqlTokenCacheOptions is used by the caller to specify the Sql connection string</param>
+        /// <returns></returns>
+        public static IServiceCollection AddSqlTokenCaches(this IServiceCollection services, MSALSqlTokenCacheOptions sqlTokenCacheOptions)
+        {
+            AddSqlAppTokenCache(services, sqlTokenCacheOptions);
+            AddSqlPerUserTokenCache(services, sqlTokenCacheOptions);
+            return services;
+        }
+
+        /// <summary>Adds the Sql Server based application token cache to the service collection.</summary>
+        /// <param name="services">The services collection to add to.</param>
+        /// <param name="sqlTokenCacheOptions">The MSALSqlTokenCacheOptions is used by the caller to specify the Sql connection string</param>
         /// <returns></returns>
         public static IServiceCollection AddSqlAppTokenCache(this IServiceCollection services, MSALSqlTokenCacheOptions sqlTokenCacheOptions)
         {
@@ -66,8 +75,8 @@ public static IServiceCollection AddSqlAppTokenCache(this IServiceCollection ser
         }
 
         /// <summary>Adds the Sql Server based per user token cache to the service collection.</summary>
-        /// <param name="services">The services.</param>
-        /// <param name="configuration">The configuration instance from where this method pulls the connection string to the Sql database.</param>
+        /// <param name="services">The services collection to add to.</param>
+        /// <param name="sqlTokenCacheOptions">The MSALSqlTokenCacheOptions is used by the caller to specify the Sql connection string</param>
         /// <returns></returns>
         public static IServiceCollection AddSqlPerUserTokenCache(this IServiceCollection services, MSALSqlTokenCacheOptions sqlTokenCacheOptions)
         {