Skip to content

Commit 9483a06

Browse files
docs: README updated for Creating App registration (#1510)
1 parent d4e6aba commit 9483a06

10 files changed

+60
-0
lines changed

README.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -171,6 +171,8 @@ The demo, which uses containers pre-built from the main branch is available by c
171171

172172
[![Deploy to Azure](https://aka.ms/deploytoazurebutton)](https://portal.azure.com/#create/Microsoft.Template/uri/https%3A%2F%2Fraw.githubusercontent.com%2FAzure-Samples%2Fchat-with-your-data-solution-accelerator%2Fmain%2Finfra%2Fmain.json)
173173

174+
When Deployment is complete, follow steps in [Set Up Authentication in Azure App Service](./docs/azure_app_service_auth_setup.md) to add app authentication to your web app running on Azure App Service
175+
174176
**Note**: The default configuration deploys an OpenAI Model "gpt-35-turbo" with version 0613. However, not all
175177
locations support this version. If you're deploying to a location that doesn't support version 0613, you'll need to
176178
switch to a lower version. To find out which versions are supported in different regions, visit the

docs/azure_app_service_auth_setup.md

Lines changed: 58 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,58 @@
1+
# Set Up Authentication in Azure App Service
2+
3+
## Step 1: Add Authentication in Azure App Service configuration
4+
5+
1. Click on `Authentication` from left menu.
6+
7+
![Authentication](images/AppAuthentication.png)
8+
9+
2. Click on `+ Add Provider` to see a list of identity providers.
10+
11+
![Authentication Identity](images/AppAuthenticationIdentity.png)
12+
13+
3. Click on `+ Add Provider` to see a list of identity providers.
14+
15+
![Add Provider](images/AppAuthIdentityProvider.png)
16+
17+
4. Select the first option `Microsoft Entra Id` from the drop-down list. If `Create new app registration` is disabled, go to [Step 1a](#step-1a-creating-a-new-app-registration).
18+
19+
![Add Provider](images/AppAuthIdentityProviderAdd.png)
20+
21+
5. Accept the default values and click on `Add` button to go back to the previous page with the identify provider added.
22+
23+
![Add Provider](images/AppAuthIdentityProviderAdded.png)
24+
25+
### Step 1a: Creating a new App Registration
26+
27+
1. Click on `Home` and select `Microsoft Entra ID`.
28+
29+
![Microsoft Entra ID](images/MicrosoftEntraID.png)
30+
31+
2. Click on `App registrations`.
32+
33+
![App registrations](images/Appregistrations.png)
34+
35+
3. Click on `+ New registration`.
36+
37+
![New Registrations](images/NewRegistration.png)
38+
39+
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.
40+
41+
![Add Details](images/AddDetails.png)
42+
43+
5. After application is created sucessfully, then click on `Add a Redirect URL`.
44+
45+
![Redirect URL](images/AddRedirectURL.png)
46+
47+
6. Click on `+ Add a platform`.
48+
49+
![+ Add platform](images/AddPlatform.png)
50+
51+
7. Click on `Web`.
52+
53+
![Web](images/Web.png)
54+
55+
8. Enter the `web app URL` (Provide the app service name in place of XXXX) and Save. Then go back to [Step 1](#step-1-add-authentication-in-azure-app-service-configuration) 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.
56+
E.g. https://appservicename.azurewebsites.net/.auth/login/aad/callback
57+
58+
![Add Details](images/WebAppURL.png)

docs/images/AddDetails.png

350 KB
Loading

docs/images/AddPlatform.png

194 KB
Loading

docs/images/AddRedirectURL.png

41.6 KB
Loading

docs/images/Appregistrations.png

199 KB
Loading

docs/images/MicrosoftEntraID.png

127 KB
Loading

docs/images/NewRegistration.png

356 KB
Loading

docs/images/Web.png

272 KB
Loading

docs/images/WebAppURL.png

81.7 KB
Loading

0 commit comments

Comments
 (0)