Merge pull request #475 from microsoft/psl-files-update

docs: documents update

Author: Roopan-Microsoft

documents/AppAuthentication.md

@@ -1,53 +1,33 @@
-## Add Authentication in Azure App Service configuration
+# Set Up Authentication in Azure App Service
+
+This document provides step-by-step instructions to configure Azure App Registrations for a front-end application.
+
+## Prerequisites
+
+- Access to **Microsoft Entra ID**
+- Necessary permissions to create and manage **App Registrations**
+  
+## Step 1: Add Authentication in Azure App Service configuration
+
 1. Click on `Authentication` from left menu.
 
   ![Authentication](Images/AppAuthentication.png)
 
-2. Click on `+ Add Provider` to see a list of identity providers.
+2. Click on `+ Add identity provider` to see a list of identity providers.
 
   ![Authentication Identity](Images/AppAuthenticationIdentity.png)
 
-3. Click on `+ Add Provider` to see a list of identity providers.
+3. Click on `Identity Provider` dropdown to see a list of identity providers.
 
   ![Add Provider](Images/AppAuthIdentityProvider.png)
 
-4. Select the first option `Microsoft Entra Id` from the drop-down list.
- 
+4. Select the first option `Microsoft Entra Id` from the drop-down list and select `client secret expiration` under App registration.
+> NOTE: If `Create new app registration` is disabled, then go to [Create new app registration](/documents/create_new_app_registration.md) and come back to this step to complete the app authentication.
+
  ![Add Provider](Images/AppAuthIdentityProviderAdd.png)
 
 5. Accept the default values and click on `Add` button to go back to the previous page with the identity provider added.
 
  ![Add Provider](Images/AppAuthIdentityProviderAdded.png)
 
- ### Creating a new App Registration
-1. Click on `Home` and select `Microsoft Entra ID`.
-
-![Microsoft Entra ID](Images/MicrosoftEntraID.png)
-
-2. Click on `App registrations`.
-
-![App registrations](Images/Appregistrations.png)
-
-3. Click on `+ New registration`.
-
-![New Registrations](Images/NewRegistration.png)
-
-4. Provide the `Name`, select supported account types as `Accounts in this organizational directory only(Contoso only - Single tenant)`, select platform as `Web`, enter/select the `URL` and register.
-
-![Add Details](Images/AddDetails.png)
-
-5. After application is created successfully, then click on `Add a Redirect URL`.
-
-![Redirect URL](Images/AddRedirectURL.png)
-
-6. Click on `+ Add a platform`.
-
-![+ Add platform](Images/AddPlatform.png)
-
-7. Click on `Web`.
-
-![Web](Images/Web.png)
-
-8. Enter the `web app URL` (Provide the app service name in place of XXXX) and Save. Then go back to [Step 4] and follow from _Point 4_ choose `Pick an existing app registration in this directory` from the Add an Identity Provider page and provide the newly registered App Name.
-
-![Add Details](Images/WebAppURL.png)
+6. You have successfully added app authentication, and now required to log in to access the application.

documents/DeploymentGuide.md

@@ -16,7 +16,7 @@ Check the [Azure Products by Region](https://azure.microsoft.com/en-us/explore/g
 - [Azure Container Apps](https://learn.microsoft.com/en-us/azure/container-apps/)
 - [Azure Container Registry](https://learn.microsoft.com/en-us/azure/container-registry/)
 - [Embedding Deployment Capacity](https://learn.microsoft.com/en-us/azure/ai-services/openai/concepts/models#embedding-models)
-- [Azure Semantic Search](./docs/AzureSemanticSearchRegion.md)
+- [Azure Semantic Search](./AzureSemanticSearchRegion.md)
 
 Here are some example regions where the services are available: East US, East US2, Australia East, UK South, France Central.
 

documents/Fabric_deployment.md

@@ -24,7 +24,7 @@ If you'd like to customize the solution accelerator, here are some ways you migh
         3.  Provide name for Environment and click Create
         4.  Select Public libraries in left panel
         5.  Click Add from .yml
-        6.  Upload .yml from [here](./Deployment/scripts/fabric_scripts/ckm_cu_env.yml)
+        6.  Upload .yml from [here](.././infra/scripts/fabric_scripts/ckm_cu_env.yml)
         7.  Click Publish
     7.  Retrieve Workspace ID from URL, refer to documentation additional assistance ([here](https://learn.microsoft.com/en-us/fabric/admin/portal-workspace#identify-your-workspace-id))
 

documents/create_new_app_registration.md

@@ -0,0 +1,35 @@
+# Creating a new App Registration
+
+1. Click on `Home` and select `Microsoft Entra ID`.
+
+![Microsoft Entra ID](Images/MicrosoftEntraID.png)
+
+2. Click on `App registrations`.
+
+![App registrations](Images/Appregistrations.png)
+
+3. Click on `+ New registration`.
+
+![New Registrations](Images/NewRegistration.png)
+
+4. Provide the `Name`, select supported account types as `Accounts in this organizational directory only(Contoso only - Single tenant)`, select platform as `Web`, enter/select the `URL` and register.
+
+![Add Details](Images/AddDetails.png)
+
+5. After application is created successfully, then click on `Add a Redirect URL`.
+
+![Redirect URL](Images/AddRedirectURL.png)
+
+6. Click on `+ Add a platform`.
+
+![+ Add platform](Images/AddPlatform.png)
+
+7. Click on `Web`.
+
+![Web](Images/Web.png)
+
+8. Enter the `web app URL` (Provide the app service name in place of XXXX) and Save. Then go back to [Set Up Authentication in Azure App Service](/documents/AppAuthentication.md) Step 1 page and follow from _Point 4_ choose `Pick an existing app registration in this directory` from the Add an Identity Provider page and provide the newly registered App Name.
+
+E.g. <<https://<< appservicename >>.azurewebsites.net/.auth/login/aad/callback>>
+
+![Add Details](Images/WebAppURL.png)