Merge branch 'main' of https://github.com/microsoft/Modernize-your-code-solution-accelerator

Author: TravisHilbert

README.md

@@ -0,0 +1,69 @@
+## Retrieve necessary pre-requisite information
+1. Navigate to the resource group containing the solution
+2. Open the frontend container application
+
+   ![ContainerApp](images/add_authentication/front_end.png)
+
+3. Copy the Application Uri from the app and save it for later use
+
+## Add and configure an Entra App Identity for the Application
+1. In the Azure Portal, Click on `Microsoft Entra ID` from the Azure services bar at the top of the window.
+
+   ![App Registration](images/add_authentication/app_reg_1.png)
+
+2. Click on `App registrations` then click on the 'New registration' button to start creating the registration.
+
+   ![New Registration](images/add_authentication/app_reg_2.png)
+
+3. Fill in the display name for your app registration and press the 'Register' button.
+
+   This returns you to the main app registration page.
+ 
+   ![App Registration](images/add_authentication/app_reg_3.png)
+
+4. Click to 'Add a Redirect URI'
+
+   ![Add URL](images/add_authentication/platform_config.png)
+
+5. Click to 'Add a platform'
+
+    ![Add platform](images/add_authentication/single_page.png)
+
+6. Select 'Single Page Application'
+
+    ![Single Page App](images/add_authentication/single_page_2.png)
+
+9. Copy the Application Uri you saved into the 'Redirect URIs' text box
+   Select the 'ID tokens (used for implicit and hybrid flows)' checkbox and press 'Configure
+
+   To run locally with Authentication configured, select to add another redirect URL, and configure it with a redirect URL of http://localhost:5173. Select the 'ID tokens' checkbox as before. Then repeat this process again with a URL of http://localhost:3000
+
+   When finished you will be back on the authentication page of the app identity
+
+10. Fill in the Front-channel logout URL with the application URI and click the 'Save' button
+
+     ![App Auth](images/add_authentication/app_auth.png)
+
+11. Press 'Overview' on the top left view.  Copy the Client ID for later use
+
+
+     ![Client Id](images/add_authentication/client_id.png)
+
+## Add Environment Variables to the front end Container App
+Follow the [directions in the documentation ](https://learn.microsoft.com/en-us/azure/container-apps/environment-variables?tabs=portal#add-environment-variables-on-existing-container-apps)to add environment variables on existing container apps, to add the following environment variables and values to your front end container.
+
+      ```
+      REACT_APP_MSAL_AUTH_CLIENTID="<which you copied from above step>"
+      REACT_APP_MSAL_AUTH_AUTHORITY="https://login.microsoftonline.com/<your tenant ID>"
+      REACT_APP_MSAL_REDIRECT_URL="/"
+      REACT_APP_MSAL_POST_REDIRECT_URL="/"
+      ```
+
+      For local debugging, configure your local variables as follows:
+
+      ```
+      VITE_APP_MSAL_AUTH_CLIENTID="<which you copied from above step>"
+      VITE_APP_MSAL_AUTH_AUTHORITY="https://login.microsoftonline.com/<your tenant ID>"
+      VITE_APP_MSAL_REDIRECT_URL="/"
+      VITE_APP_MSAL_POST_REDIRECT_URL="/"
+      ```

docs/AddAuthentication.md

@@ -0,0 +1,48 @@
+## [Optional]: Customizing resource names 
+
+By default this template will use the environment name as the prefix to prevent naming collisions within Azure. The parameters below show the default values. You only need to run the statements below if you need to change the values. 
+
+
+> To override any of the parameters, run `azd env set <key> <value>` before running `azd up`. On the first azd command, it will prompt you for the environment name. Be sure to choose 3-20 charaters alphanumeric unique name. 
+
+Change the Content Understanding Location (allowed values: Sweden Central, Australia East)
+
+```shell
+azd env set AZURE_ENV_CU_LOCATION 'swedencentral'
+```
+
+Change the Secondary Location (example: eastus2, westus2, etc.)
+
+```shell
+azd env set AZURE_ENV_SECONDARY_LOCATION eastus2
+```
+
+Change the Model Deployment Type (allowed values: Standard, GlobalStandard)
+
+```shell
+azd env set AZURE_ENV_MODEL_DEPLOYMENT_TYPE GlobalStandard
+```
+
+Set the Model Name (allowed values: gpt-4o-mini, gpt-4o, gpt-4)
+
+```shell
+azd env set AZURE_ENV_MODEL_NAME gpt-4o-mini
+```
+
+Change the Model Capacity (choose a number based on available GPT model capacity in your subscription)
+
+```shell
+azd env set AZURE_ENV_MODEL_CAPACITY 30
+```
+
+Change the Embedding Model 
+
+```shell
+azd env set AZURE_ENV_EMBEDDING_MODEL_NAME text-embedding-ada-002
+```
+
+Change the Embedding Deployment Capacity (choose a number based on available embedding model capacity in your subscription)
+
+```shell
+azd env set AZURE_ENV_EMBEDDING_MODEL_CAPACITY 80
+```