Merge pull request #338 from Azure-Samples/tibre/webUiDocs

Microsoft.Identity.Web.UI optional steps

Author: Tiago Brenck

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

@@ -172,13 +172,34 @@ cd "1-WebApp-OIDC\1-1-MyOrg"
     - update the `sslPort` of the `iisSettings` section to be `44321`
     - in the `applicationUrl` property of use `https://localhost:44321`
 
+1. (Optional) If you don't have a custom `AccountController` to handle the *sign-in* and *sign-out* requests, you can use the `Microsoft.Identity.Web.UI` built-in one. For that, please include this change on **Startup.cs**:
+
+    - at the top of the file, add the following using directive:
+
+      ```CSharp
+        using Microsoft.Identity.Web.UI;
+      ```
+    - in the `ConfigureServices` method, change the **AddControllersWithView** code snippet with this:
+
+      ```CSharp
+        services.AddControllersWithViews(options =>
+        {
+            var policy = new AuthorizationPolicyBuilder()
+                .RequireAuthenticatedUser()
+                .Build();
+            options.Filters.Add(new AuthorizeFilter(policy));
+        }).AddMicrosoftIdentityUI();
+      ```
+
+    - on **Views/Shared/_LoginPartial.cshtml**, change the **asp-area** tag to: `asp-area="MicrosoftIdentity"`
+
 ### Step 3: Run the sample
 
 1. Build the solution and run it.
 
 2. Open your web browser and make a request to the app. Accept the IIS Express SSL certificate if needed. The app immediately attempts to authenticate you via the identity platform endpoint. Sign in with your personal account or with work or school account.
 
-## Toubleshooting
+## Troubleshooting
 
 ### known issue on iOS 12
 

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

@@ -164,6 +164,27 @@ cd "1-WebApp-OIDC\1-2-AnyOrg"
     - update the `sslPort` of the `iisSettings` section to be `44321`
     - in the `applicationUrl` property of use `https://localhost:44321`
 
+1. (Optional) If you don't have a custom `AccountController` to handle the *sign-in* and *sign-out* requests, you can use the `Microsoft.Identity.Web.UI` built-in one. For that, please include this change on **Startup.cs**:
+
+    - at the top of the file, add the following using directive:
+
+      ```CSharp
+        using Microsoft.Identity.Web.UI;
+      ```
+    - in the `ConfigureServices` method, change the **AddControllersWithView** code snippet with this:
+
+      ```CSharp
+        services.AddControllersWithViews(options =>
+        {
+            var policy = new AuthorizationPolicyBuilder()
+                .RequireAuthenticatedUser()
+                .Build();
+            options.Filters.Add(new AuthorizeFilter(policy));
+        }).AddMicrosoftIdentityUI();
+      ```
+
+    - on **Views/Shared/_LoginPartial.cshtml**, change the **asp-area** tag to: `asp-area="MicrosoftIdentity"`
+
 ### Step 3: Run the sample
 
 1. Build the solution and run it.

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

@@ -159,6 +159,27 @@ In the **appsettings.json** file:
     - update the `sslPort` of the `iisSettings` section to be `44321`
     - in the `applicationUrl` property of use `https://localhost:44321`
 
+1. (Optional) If you don't have a custom `AccountController` to handle the *sign-in* and *sign-out* requests, you can use the `Microsoft.Identity.Web.UI` built-in one. For that, please include this change on **Startup.cs**:
+
+    - at the top of the file, add the following using directive:
+
+      ```CSharp
+        using Microsoft.Identity.Web.UI;
+      ```
+    - in the `ConfigureServices` method, change the **AddControllersWithView** code snippet with this:
+
+      ```CSharp
+        services.AddControllersWithViews(options =>
+        {
+            var policy = new AuthorizationPolicyBuilder()
+                .RequireAuthenticatedUser()
+                .Build();
+            options.Filters.Add(new AuthorizeFilter(policy));
+        }).AddMicrosoftIdentityUI();
+      ```
+
+    - on **Views/Shared/_LoginPartial.cshtml**, change the **asp-area** tag to: `asp-area="MicrosoftIdentity"`
+
 ### Step 3: Run the sample
 
 1. Build the solution and run it.

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

@@ -130,6 +130,27 @@ cd "1-WebApp-OIDC\1-4-Sovereign"
     - update the `sslPort` of the `iisSettings` section to be `44321`
     - in the `applicationUrl` property of use `https://localhost:44321`
 
+1. (Optional) If you don't have a custom `AccountController` to handle the *sign-in* and *sign-out* requests, you can use the `Microsoft.Identity.Web.UI` built-in one. For that, please include this change on **Startup.cs**:
+
+    - at the top of the file, add the following using directive:
+
+      ```CSharp
+        using Microsoft.Identity.Web.UI;
+      ```
+    - in the `ConfigureServices` method, change the **AddControllersWithView** code snippet with this:
+
+      ```CSharp
+        services.AddControllersWithViews(options =>
+        {
+            var policy = new AuthorizationPolicyBuilder()
+                .RequireAuthenticatedUser()
+                .Build();
+            options.Filters.Add(new AuthorizeFilter(policy));
+        }).AddMicrosoftIdentityUI();
+      ```
+
+    - on **Views/Shared/_LoginPartial.cshtml**, change the **asp-area** tag to: `asp-area="MicrosoftIdentity"`
+
 ### Step 3: Run the sample
 
 1. Build the solution and run it.