Preparing Microsoft.Identity.Web for being disributed as a NuGet package (#153)

* Preparing Microsoft.Identity.Web for being disributed as a NuGet package
1) Merging the content from microsoft-authentication-extensions-for-dotnet Web
2) Aligning the namespaces with the folder strucuture
3) Renaming files and classes per the style used in MSAL.NET

* Improving the doc

* Updating the README.md

* Adding an architecture diagram

* Updating the code

* Enabling the creation of a NuGet package

* Fixing regression introduced when merging both code bases

* 1. Added CreateTokenCachingTablesInSqlDatabase in SqlTokenCacheProviderExtension.cs as the developer can no longer uncomment a piece of code to create tables for Sql token caching. Updated 2-2-Token-caching
2. Fixed a bug in 4-WebApp-Your-Api which needed **services.AddSession();** in AddProtectWebApiWithMicrosoftIdentityPlatformV2().
3. Added "JwtSecurityTokenHandler.DefaultMapInboundClaims = false;" in a few startup.cs to encourage using the new claim set in V2 samples.
4. Lots of comments updated in Microsoft.IDentity.Web classes
5. Renamed *ServiceCollectionExtension classes to *TokenCacheProviderExtensions as the classes have extention methods for token providers and the name matches the purpose.
6. Fixed a bug in MsalAppMemoryTokenCacheProvider
7. Remove redundant parameters from IMsalAppTokenCacheProvider and IMsalUserTokenCacheProvider Initialize() methods

* minor typo fixed

* Removing, `JwtSecurityTokenHandler.DefaultMapInboundClaims = false;` because `preferred_username` claim was not being mapped

* Revert "Removing, `JwtSecurityTokenHandler.DefaultMapInboundClaims = false;` because `preferred_username` claim was not being mapped"

This reverts commit 45baf51.

* Change AddProtectWebApiWithMicrosoftIdentityPlatformV2 by AddProtectedWebApiWithMicrosoftIdentityPlatformV2

* Acting on @MarkZuber 's PR feedback

* AddAzureAdV2Authentication, AddProtectedApiCallsWebApis; AddMsal now takes the configuration (and optional parameters to let the developer choose the options section) => all the Startup.cs file using it are modified.

Simplifying the implementation of the token cache serializers by creating a IMsalTokenCacheProvider interface and a MsalAbstractTokenCacheProvider class implementing the common code in all the token cache providers.

Fixing a few code smells (including ConfigureAwait(false) where needed.
Chaning the CallGraph solution to be a Visual Studio 2019 solution.

* Addressing Mark's additional suggestions

* Updating the token caches

* Renaming the AbstractMsalTokenCacheProvider into MsaAbstractTokenCacheProvider, adding a class diagram and improving a README.md

* - Renamed AddAzureAdV2Authentication into AddMicrosoftIdentityPlatformAuthentication
- Renamed AddProtectedWebApiWithMicrosoftIdentityPlatformV2 into AddProtectedWebApi

* Provide migration help for the Sql Token cache provider
Remove the AsyncUsageAnalyzers
Improves the build.bat and buildAllSln.proj to add more target (restore and clean)

* Fixing a merged project

* Renaming MsalUiRequiredExceptionFilterAttribute to AuthorizeForScopesAttribute

Author: jmprieur

.gitignore

@@ -96,3 +96,8 @@
 /4-WebApp-your-API/TodoListService/obj
 /4-WebApp-your-API/TodoListService/bin
 /4-WebApp-your-API/Client/obj
+/2-WebApp-graph-user/2-4-Sovereign-Call-MSGraph/bin/Debug/netcoreapp2.2
+/2-WebApp-graph-user/2-4-Sovereign-Call-MSGraph/obj
+/2-WebApp-graph-user/2-4-Sovereign-Call-MSGraph/bin/Release/netcoreapp2.2
+/Microsoft.Identity.Web.Test/bin/Release/netcoreapp2.2
+/Microsoft.Identity.Web.Test/obj

1-WebApp-OIDC/1-1-MyOrg/README.md

@@ -136,7 +136,7 @@ cd "1-WebApp-OIDC\1-1-MyOrg"
      by this line:
 
      ```CSharp
-      services.AddAzureAdV2Authentication(Configuration);
+      services.AddMicrosoftIdentityPlatformAuthentication(Configuration);
      ```
 
      This enables your application to use the Microsoft identity platform endpoint. This endpoint is capable of signing-in users both with their Work and School and Microsoft Personal accounts.

1-WebApp-OIDC/1-1-MyOrg/Startup.cs

@@ -31,7 +31,7 @@ public void ConfigureServices(IServiceCollection services)
             });
 
             // Sign-in users with the Microsoft identity platform
-            services.AddAzureAdV2Authentication(Configuration);
+            services.AddMicrosoftIdentityPlatformAuthentication(Configuration);
 
             services.AddMvc(options =>
             {

1-WebApp-OIDC/1-2-AnyOrg/README-1-1-to-1-2.md

@@ -48,14 +48,14 @@ The actual sign-in audience (accounts to sign-in) is the lowest set of what is s
 
 In order to restrict users from specific organizations to sign-in to your web app, you'll need to follow the steps above, and customize a bit more the code to restrict the valid token issuers. The token issuers are really the tenanted Azure AD authority which are allowed to issue a token to access your web application.
 
-In the `Startup.cs` file, in the `ConfigureServices` method, after `services.AddAzureAdV2Authentication(Configuration)` add some code to validate specific issuers by overriding the `TokenValidationParameters.IssuerValidator` delegate.
+In the `Startup.cs` file, in the `ConfigureServices` method, after `services.AddMicrosoftIdentityPlatformAuthentication(Configuration)` add some code to validate specific issuers by overriding the `TokenValidationParameters.IssuerValidator` delegate.
 
 ```CSharp
     public void ConfigureServices(IServiceCollection services)
     {
     ...
     // Sign-in users with the Microsoft identity platform
-    services.AddAzureAdV2Authentication(Configuration);
+    services.AddMicrosoftIdentityPlatformAuthentication(Configuration);
 
     // Restrict users to specific belonging to specific tenants
     services.Configure<OpenIdConnectOptions>(AzureADDefaults.OpenIdScheme, options =>

1-WebApp-OIDC/1-2-AnyOrg/README.md

@@ -136,7 +136,7 @@ cd "1-WebApp-OIDC\1-2-AnyOrg"
      by this line:
 
      ```CSharp
-      services.AddAzureAdV2Authentication(Configuration);
+      services.AddMicrosoftIdentityPlatformAuthentication(Configuration);
      ```
 
      This enables your application to use the Microsoft identity platform endpoint. This endpoint is capable of signing-in users both with their Work and School and Microsoft Personal accounts.

1-WebApp-OIDC/1-2-AnyOrg/Startup.cs

@@ -31,7 +31,7 @@ public void ConfigureServices(IServiceCollection services)
             });
 
             // Sign-in users with the Microsoft identity platform
-            services.AddAzureAdV2Authentication(Configuration);
+            services.AddMicrosoftIdentityPlatformAuthentication(Configuration);
 
             services.AddMvc(options =>
             {

1-WebApp-OIDC/1-3-AnyOrgOrPersonal/README.md

@@ -150,7 +150,7 @@ In the **appsettings.json** file:
      by this line:
 
      ```CSharp
-      services.AddAzureAdV2Authentication(Configuration);
+      services.AddMicrosoftIdentityPlatformAuthentication(Configuration);
      ```
 
      This enables your application to use the Microsoft identity platform endpoint. This endpoint is capable of signing-in users both with their Work and School and Microsoft Personal accounts.

1-WebApp-OIDC/1-3-AnyOrgOrPersonal/Startup.cs

@@ -31,7 +31,7 @@ public void ConfigureServices(IServiceCollection services)
             });
 
             // Sign-in users with the Microsoft identity platform
-            services.AddAzureAdV2Authentication(Configuration);
+            services.AddMicrosoftIdentityPlatformAuthentication(Configuration);
 
             services.AddMvc(options =>
             {

1-WebApp-OIDC/1-4-Sovereign/README.md

@@ -124,7 +124,7 @@ cd "1-WebApp-OIDC\1-4-Sovereign"
      by this line:
 
      ```CSharp
-            services.AddAzureAdV2Authentication(Configuration);
+            services.AddMicrosoftIdentityPlatformAuthentication(Configuration);
      ```
 
      This enables your application to use the Microsoft identity platform endpoint. This endpoint is capable of signing-in users both with their Work and School and Microsoft Personal accounts.

1-WebApp-OIDC/1-4-Sovereign/Startup.cs

@@ -31,7 +31,7 @@ public void ConfigureServices(IServiceCollection services)
             });
 
             // Sign-in users with the Microsoft identity platform
-            services.AddAzureAdV2Authentication(Configuration);
+            services.AddMicrosoftIdentityPlatformAuthentication(Configuration);
 
             services.AddMvc(options =>
             {