update with caching info

Author: craigshoemaker

articles/static-web-apps/front-door-manual.md

@@ -5,7 +5,7 @@ services: static-web-apps
 author: craigshoemaker
 ms.service: static-web-apps
 ms.topic: how-to
-ms.date: 09/20/2021
+ms.date: 01/07/2022
 ms.author: cshoe
 ---
 
@@ -17,11 +17,11 @@ In this tutorial, you learn how to:
 
 > [!div class="checklist"]
 >
-> - Create an Azure Front Door instance
+> - Create an Azure Front Door Standard/Premium instance
 > - Associate Azure Front Door with your Azure Static Web Apps site
 
 > [!NOTE]
-> This tutorial requires the Azure Static Web Apps Standard plan.
+> This tutorial requires the Azure Static Web Apps Standard and Azure Front Door Standard / Premium plans.
 
 ## Copy URL
 
@@ -39,76 +39,88 @@ In this tutorial, you learn how to:
 
 1. Select **Create a resource**.
 
-1. Search for **Azure Front Door**.
+1. Search for **Front Door**.
 
-1. Select **Front Door**.
+1. Select **Front Door Standard/Premium**.
 
-    Make sure not to select the service labeled *Front Door Standard/Premium* as the steps for the Standard/Premium service differ from what's presented in this tutorial.
+    Make sure to select the service labeled *Front Door Standard/Premium*.
 
 1. Select **Create**.
 
+1. Select **Azure Front Door Standard/Premium (Preview)**.
+
+1. Select **Quick create**.
+
+1. Select **Continue to create a front door**.
+
 1. In the *Basics* tab, enter the following values:
 
     | Setting | Value |
     |---|---|
     | Subscription | Select your Azure subscription. |
     | Resource group | Enter a resource group name. This name is often the same group name used by your static web app. |
     | Resource group location | If you create a new resource group, enter the location nearest you. |
+    | Name | Enter **my-static-web-app-front-door**. |
+    | Tier | Select **Standard**. |
+    | Endpoint name | Enter a unique name for your Front Door host. |
+    | Origin type | Select **Custom**. |
+    | Origin host name | Enter the hostname of your static web app. Make sure your value does not include a trailing slash or protocol. (For example, `desert-rain-04056.azurestaticapps.net`)  |
+    | Caching | Check the *Enable caching* checkbox. |
+    | Query string caching behavior | Select **Use Query string** from the dropdown. |
 
-    Select **Next: Configuration >**.
+1. Select **Review + create**.
 
-1. In the *Configuration* tab, select the **plus sign** next to *Frontends/domains*, and enter the following value:
+1. Select **Create**.
 
-    | Setting | Value |
-    |---|---|
-    | Host name | Enter a unique name for your Front Door host. |
+    The creation process may take a few minutes to complete.
 
-    Accept the defaults for the rest of the form, and select **Add**.
+1. Select **Go to resource**.
 
-1. Select the **plus sign** next to *Backend pools*, and enter the following value:
+## Disable cache for auth workflow
 
-    | Setting | Value |
-    |---|---|
-    | Name | Enter **my-static-web-app-pool**. |
+Add the following settings to disable Front Door's caching policies from trying to cache authentication and authorization related pages.
 
-1. Select **+ Add a backend**, and enter the following values:
+1. Under *Settings*, select **Rule set**.
 
-    | Setting | Value |
-    |---|---|
-    | Backend host type | Select **Custom host**. |
-    | Backend host name | Enter the hostname of your static web app. Make sure your value does not include a trailing slash or protocol. (For example, `desert-rain-04056.azurestaticapps.net`)  |
-    | Backend host header | Enter the hostname of your static web app. Make sure your value does not include a trailing slash protocol. (For example, `desert-rain-04056.azurestaticapps.net`) |
+1. Select **Add**.
 
-    Accept the defaults for the rest of the form, and select **Add**.
+1. In the *Rule set name* textbox, enter **Security**.
 
-1. Select **Add**.
+1. In the *Rule name* textbox, enter **NoCacheAuthRequests**.
 
-1. Select the **plus sign** next to *Routing rule*, and enter the following value:
+1. Select **Add a condition**.
 
-    | Setting | Value |
-    |---|---|
-    | Name | Enter **my-routing-rule**. |
+1. Select **Request path**.
 
-    Accept the defaults for the rest of the form, and select **Add**.
+1. Select **Begins With** in the *Operator* drop down.
 
-1. Select **Review + create**.
+1. Select the **Edit** link above the *Value* textbox.
 
-1. Select **Create**.
+1. Enter **/.auth** in the value textbox.
 
-    The creation process may take a few minutes to complete.
+1. Select **Add an action**.
 
-1. Select **Go to resource**.
+1. Select **Cache expiration**.
 
-1. Select **Overview**.
+1. Select **Bypass cache** in the *Cache Behavior* dropdown.
 
-1. Select the link labeled *Frontend host*.
+1. Select **Save**.
 
-    When you select this link, you may see a 404 error if the site is not fully propagated. Instead of refreshing the page, wait a few minutes and return back to the *Overview* window and select the link labeled *Frontend host*.
+1. Select the **Unassociated** link.
 
-1. From the *Overview* window, copy the value labeled **Front Door ID** and paste it into a file for later use.
+1. Select the Endpoint name you want to apply this rule.
 
-> [!IMPORTANT]
-> By default, Azure Front Door configures [health probes](../frontdoor/front-door-health-probes.md) that may affect your traffic statistics. You may want to edit the default values for the [health probes](../frontdoor/front-door-health-probes.md).
+1. Select **Next**.
+
+1. Select **Associate**.
+
+## Copy Front Door ID
+
+Use the following steps to copy the Front Door instance's unique identifier.
+
+1. Select **Overview**.
+
+1. From the *Overview* window, copy the value labeled **Front Door ID** and paste it into a file for later use.
 
 ## Update static web app configuration
 
@@ -149,10 +161,17 @@ Open the [staticwebapp.config.json](configuration.md) file for your site and mak
 
 With this configuration, your site is no longer available via the generated `*.azurestaticapps.net` hostname, but exclusively through the hostnames configured in your Front Door instance.
 
-> [!NOTE]
-> When you deploy updates to existing files in your static web app, Azure Front Door may continue to serve older versions of your files until their [time-to-live](https://wikipedia.org/wiki/Time_to_live) expires. [Purge the Azure Front Door cache](../frontdoor/front-door-caching.md#cache-purge) for the affected paths to ensure the latest files are served.
+## Considerations
+
+- **Custom domains**: Now that Front Door is managing your site, you no long use the Azure Static Web Apps custom domain feature. Azure Front Door has a separate process for adding a custom domain. Refer to [Add a custom domain to your Front Door](../frontdoor/front-door-custom-domain.md). When you add a custom domain to Front Door, you'll need to update your static web app configuration file to include it in the `allowedForwardedHosts` list.
+
+- **Traffic statistics**: By default, Azure Front Door configures [health probes](../frontdoor/front-door-health-probes.md) that may affect your traffic statistics. You may want to edit the default values for the [health probes](../frontdoor/front-door-health-probes.md).
+
+- **Serving old versions**: When you deploy updates to existing files in your static web app, Azure Front Door may continue to serve older versions of your files until their [time-to-live](https://wikipedia.org/wiki/Time_to_live) expires. [Purge the Azure Front Door cache](../frontdoor/front-door-caching.md#cache-purge) for the affected paths to ensure the latest files are served.
+
+## Clean up resources
 
-Now that Front Door is managing your site, you no long use the Azure Static Web Apps custom domain feature. Azure Front Door has a separate process for adding a custom domain. Refer to [Add a custom domain to your Front Door](../frontdoor/front-door-custom-domain.md). When you add a custom domain to Front Door, you'll need to update your static web app configuration file to include it in the `allowedForwardedHosts` list.
+If you no longer want to use the resources created in this tutorial, delete the Azure Static Web Apps and Azure Front Door instances.
 
 ## Next steps