Skip to content

Commit f325252

Browse files
More fixes.
1 parent ddc33fb commit f325252

File tree

4 files changed

+38
-36
lines changed

4 files changed

+38
-36
lines changed

articles/app-service/configure-authentication-provider-aad.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -79,7 +79,7 @@ To use an existing registration, select either:
7979

8080
If you need to manually create an app registration in a workforce tenant, see [Register an application with the Microsoft identity platform](/entra/identity-platform/quickstart-register-app). As you go through the registration process, be sure to note the application (client) ID and client secret values.
8181

82-
During the registration process, in the **Redirect URIs** section, select **Web** for platform and enter `<app-url>/.auth/login/aad/callback`. For example, enter `https://contoso.azurewebsites.net/.auth/login/aad/callback`.
82+
During the registration process, in the **Redirect URIs** section, select **Web** for platform, and enter a redirect URI. For example, enter `https://contoso.azurewebsites.net/.auth/login/aad/callback`.
8383

8484
Now, modify the app registration:
8585

@@ -166,7 +166,7 @@ To use an existing registration, select **Provide the details of an existing app
166166

167167
If you need to manually create an app registration in an external tenant, see [Register an app in your external tenant](/entra/external-id/customers/how-to-register-ciam-app?tabs=webapp#register-your-web-app).
168168

169-
During the registration process, in the **Redirect URIs** section, select **Web** for platform and enter `<app-url>/.auth/login/aad/callback`. For example, enter `https://contoso.azurewebsites.net/.auth/login/aad/callback`.
169+
During the registration process, in the **Redirect URIs** section, select **Web** for platform, and enter a redirect URI. For example, enter `https://contoso.azurewebsites.net/.auth/login/aad/callback`.
170170

171171
Now, modify the app registration:
172172

@@ -362,7 +362,7 @@ You can register native clients to request access to your App Service app's APIs
362362

363363
1. On the **Register an application** pane, for **Name**, enter a name for your app registration.
364364

365-
1. In **Redirect URI**, select **Public client/native (mobile & desktop)** and enter the URL `<app-url>/.auth/login/aad/callback`. For example, enter `https://contoso.azurewebsites.net/.auth/login/aad/callback`.
365+
1. In **Redirect URI**, select **Public client/native (mobile & desktop)** and enter the redirect URL. For example, enter `https://contoso.azurewebsites.net/.auth/login/aad/callback`.
366366

367367
1. Select **Register**.
368368

articles/app-service/deploy-staging-slots.md

Lines changed: 6 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -66,7 +66,7 @@ For you to enable multiple deployment slots, the app must be running in the Stan
6666

6767
:::image type="content" source="media/web-sites-staged-publishing/open-deployment-slot.png" alt-text="Screenshot that shows how to open a deployment slot's management page in the portal." lightbox="media/web-sites-staged-publishing/open-deployment-slot.png":::
6868

69-
The staging slot has a management page just like any other App Service app. You can change the slot's configuration. To remind you that you're viewing the deployment slot, the app name appears as *\<app-name>/\<slot-name>*. The app type is **App Service (Slot)**. You can also see the slot as a separate app in your resource group, with the same designations.
69+
The staging slot has a management page just like any other App Service app. You can change the slot's configuration. To remind you that you're viewing the deployment slot, the app name and the slot name appear in the URL. The app type is **App Service (Slot)**. You can also see the slot as a separate app in your resource group, with the same designations.
7070

7171
1. On the slot's resource page, select the app URL. The deployment slot has its own host name and is also a live app. To limit public access to the deployment slot, see [Set up Azure App Service access restrictions](app-service-ip-restrictions.md).
7272

@@ -214,7 +214,7 @@ If you cancel the swap, App Service reapplies configuration elements to the sour
214214

215215
1. When you're ready to start the swap, select **Start Swap**.
216216

217-
When the first phase finishes, the dialog notifies you. Preview the swap in the source slot by going to `https://<app_name>-<source-slot-name>.azurewebsites.net`.
217+
When the first phase finishes, the dialog notifies you.
218218

219219
1. When you're ready to complete the pending swap, select **Complete Swap** in **Swap action**, and then select the **Complete Swap** button.
220220

@@ -392,7 +392,7 @@ For more information, see [Get-AzLog](/powershell/module/az.monitor/get-azlog).
392392

393393
## Route production traffic automatically
394394

395-
By default, all client requests to the app's production URL (`http://<app_name>.azurewebsites.net`) are routed to the production slot. You can route a portion of the traffic to another slot. This feature is useful if you need user feedback for a new update but you're not ready to release it to production.
395+
By default, all client requests to the app's production URL are routed to the production slot. You can route a portion of the traffic to another slot. This feature is useful if you need user feedback for a new update but you're not ready to release it to production.
396396

397397
# [Azure portal](#tab/portal)
398398

@@ -419,9 +419,11 @@ For more information, see [az webapp traffic-routing set](/cli/azure/webapp/traf
419419
To add a routing rule on a slot and transfer 15% of production traffic to it, run the following command:
420420

421421
```azurepowershell-interactive
422-
Add-AzWebAppTrafficRouting -ResourceGroupName "<group-name>" -WebAppName "<app-name>" -RoutingRule @{ActionHostName='<app-name>-<slot-name>.azurewebsites.net';ReroutePercentage='15';Name='<slot-name>'}
422+
Add-AzWebAppTrafficRouting -ResourceGroupName "<group-name>" -WebAppName "<app-name>" -RoutingRule @{ActionHostName='<URL>';ReroutePercentage='15';Name='<slot-name>'}
423423
```
424424

425+
Get the URL for that deployment slote from the **Deployment slots** page in the Azure portal.
426+
425427
For more information, see [Add-AzWebAppTrafficRouting](/powershell/module/az.websites/add-azwebapptrafficrouting). To update an existing rule, use [Update-AzWebAppTrafficRouting](/powershell/module/az.websites/update-azwebapptrafficrouting).
426428

427429
-----

articles/app-service/deploy-zip.md

Lines changed: 28 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -39,9 +39,9 @@ This ZIP package deployment uses the same Kudu service that powers continuous in
3939
4040
### Deploy with ZIP deploy UI in Kudu
4141

42-
In the browser, go to `https://<app_name>.scm.azurewebsites.net/ZipDeployUI`. For the app name, see the [note at the beginning of the article](#dnl-note).
43-
44-
Upload the ZIP package you created in [Create a project ZIP package](#create-a-project-zip-package). Drag it to the **File Explorer** area on the web page.
42+
1. Open your app in the Azure portal and select **Development Tools** > **Advanced Tools**, then select **Go**.
43+
1. In Kudu, select **Tools** > **Zip Push Deploy**.
44+
1. Upload the ZIP package you created in [Create a project ZIP package](#create-a-project-zip-package). Drag it to the file explorer area on the web page.
4545

4646
When deployment is in progress, an icon in the top right corner shows you the progress percentage. The page also displays messages for the operation below the **File Explorer** area. When deployment finishes, the last message should say "Deployment successful."
4747

@@ -63,15 +63,15 @@ This command restarts the app after deploying the ZIP package.
6363

6464
# [Azure PowerShell](#tab/powershell)
6565

66-
The following example uses [`Publish-AzWebapp`](/powershell/module/az.websites/publish-azwebapp) to upload the ZIP package. Replace the placeholders *\<group-name>*, *\<app-name>*, and *\<zip-package-path>*.
66+
The following example uses [`Publish-AzWebapp`](/powershell/module/az.websites/publish-azwebapp) to upload the ZIP package. Replace the placeholders for resource group, app name, and package path.
6767

6868
```azurepowershell
6969
Publish-AzWebApp -ResourceGroupName Default-Web-WestUS -Name MyApp -ArchivePath <zip-package-path>
7070
```
7171

7272
# [Kudu API](#tab/api)
7373

74-
The following example uses the client URL (cURL) tool to deploy a ZIP package. Replace the placeholders *\<zip-package-path>* and *\<app-name>*. If you choose basic authentication, supply the [deployment credentials](deploy-configure-credentials.md) in *\<username>* and *\<password>*.
74+
The following example uses the client URL (cURL) tool to deploy a ZIP package. If you choose basic authentication, supply the [deployment credentials](deploy-configure-credentials.md) in *\<username>* and *\<password>*.
7575

7676
```bash
7777
# Microsoft Entra authentication
@@ -80,17 +80,17 @@ TOKEN=$(az account get-access-token --query accessToken | tr -d '"')
8080
curl -X POST \
8181
-H "Authorization: Bearer $TOKEN" \
8282
-T @"<zip-package-path>" \
83-
"https://<app-name>.scm.azurewebsites.net/api/publish?type=zip"
83+
"https://<URL>/api/publish?type=zip"
8484

8585
# Basic authentication
8686
curl -X POST \
8787
-u '<username>:<password>' \
8888
-T "<zip-package-path>" \
89-
"https://<app-name>.scm.azurewebsites.net/api/publish?type=zip"
89+
"https://<URL>/api/publish?type=zip"
9090
```
9191

9292
> [!NOTE]
93-
> Get the actual fully qualified domain name to use in the URL from the [note at the beginning of the article](#dnl-note).
93+
> Get the Kudu URL from the Azure portal: open your app and select **Development Tools** > **Advanced Tools**, then select **Go** to open the Kudu URL.
9494
9595
# [ARM template](#tab/arm)
9696

@@ -126,15 +126,15 @@ The CLI command uses the [Kudu publish API](#kudu-publish-api-reference) to depl
126126

127127
# [Azure PowerShell](#tab/powershell)
128128

129-
The following example uses [`Publish-AzWebapp`](/powershell/module/az.websites/publish-azwebapp) to upload the WAR file. Replace the placeholders *\<group-name>*, *\<app-name>*, and *\<package-path>*. Azure PowerShell supports only WAR and JAR files.
129+
The following example uses [`Publish-AzWebapp`](/powershell/module/az.websites/publish-azwebapp) to upload the WAR file. Replace the placeholders for resource group, app name, and package path. Azure PowerShell supports only WAR and JAR files.
130130

131131
```powershell
132132
Publish-AzWebapp -ResourceGroupName <group-name> -Name <app-name> -ArchivePath <package-path>
133133
```
134134

135135
# [Kudu API](#tab/api)
136136

137-
The following example uses the cURL tool to deploy a WAR, JAR, or EAR file. Replace the placeholders *\<file-path>*, *\<app-name>*, and *\<package-type>* (`war`, `jar`, or `ear`). If you choose basic authentication, supply the [deployment credentials](deploy-configure-credentials.md) in *\<username>* and *\<password>*.
137+
The following example uses the cURL tool to deploy a WAR, JAR, or EAR file. Replace the placeholders *\<file-path>* and *\<package-type>* (`war`, `jar`, or `ear`). If you choose basic authentication, supply the [deployment credentials](deploy-configure-credentials.md) in *\<username>* and *\<password>*.
138138

139139
```bash
140140
# Microsoft Entra authentication
@@ -143,17 +143,17 @@ TOKEN=$(az account get-access-token --query accessToken | tr -d '"')
143143
curl -X POST \
144144
-H "Authorization: Bearer $TOKEN" \
145145
-T @"<file-path>" \
146-
"https://<app-name>.scm.azurewebsites.net/api/publish?type=<package-type>"
146+
"https://<URL>/api/publish?type=<package-type>"
147147

148148
# Basic authentication
149149
curl -X POST \
150150
-u <username>:<password> \
151151
-T @"<file-path>" \
152-
"https://<app-name>.scm.azurewebsites.net/api/publish?type=<package-type>"
152+
"https://<URL>/api/publish?type=<package-type>"
153153
```
154154

155155
> [!NOTE]
156-
> Get the actual fully qualified domain name to use in the URL from the [note at the beginning of the article](#dnl-note).
156+
> Get the Kudu URL from the Azure portal: open your app and select **Development Tools** > **Advanced Tools**, then select **Go** to open the Kudu URL.
157157
158158
For more information, see [Kudu publish API reference](#kudu-publish-api-reference).
159159

@@ -199,7 +199,7 @@ Not supported. See the Azure CLI or Kudu API tabs.
199199

200200
### Deploy a startup script
201201

202-
The following example uses the cURL tool to deploy a startup file for the application. Replace the placeholders *\<startup-file-path>* and *\<app-name>*. If you choose basic authentication, supply the [deployment credentials](deploy-configure-credentials.md) in *\<username>* and *\<password>*.
202+
The following example uses the cURL tool to deploy a startup file for the application. Replace the placeholder *\<startup-file-path>*. If you choose basic authentication, supply the [deployment credentials](deploy-configure-credentials.md) in *\<username>* and *\<password>*.
203203

204204
```bash
205205
# Microsoft Entra authentication
@@ -208,21 +208,21 @@ TOKEN=$(az account get-access-token --query accessToken | tr -d '"')
208208
curl -X POST \
209209
-H "Authorization: Bearer $TOKEN" \
210210
-T @"<startup-file-path>" \
211-
"https://<app-name>.scm.azurewebsites.net/api/publish?type=startup"
211+
"https://<URL>/api/publish?type=startup"
212212

213213
# Basic authentication
214214
curl -X POST \
215215
-u <username>:<password> \
216216
-T @"<startup-file-path>" \
217-
"https://<app-name>.scm.azurewebsites.net/api/publish?type=startup"
217+
"https://<URL>/api/publish?type=startup"
218218
```
219219

220220
> [!NOTE]
221-
> Get the actual fully qualified domain name to use in the URL from the [note at the beginning of the article](#dnl-note).
221+
> Get the Kudu URL from the Azure portal: open your app and select **Development Tools** > **Advanced Tools**, then select **Go** to open the Kudu URL.
222222
223223
### Deploy a library file
224224

225-
The following example uses the cURL tool to deploy a library file for the application. Replace the placeholders *\<lib-file-path>* and *\<app-name>*. If you choose basic authentication, supply the [deployment credentials](deploy-configure-credentials.md) in *\<username>* and *\<password>*.
225+
The following example uses the cURL tool to deploy a library file for the application. Replace the placeholder *\<lib-file-path>*. If you choose basic authentication, supply the [deployment credentials](deploy-configure-credentials.md) in *\<username>* and *\<password>*.
226226

227227
```bash
228228
# Microsoft Entra authentication
@@ -231,21 +231,21 @@ TOKEN=$(az account get-access-token --query accessToken | tr -d '"')
231231
curl -X POST \
232232
-H "Authorization: Bearer $TOKEN" \
233233
-T @"<lib-file-path>" \
234-
"https://<app-name>.scm.azurewebsites.net/api/publish?type=lib&path=/home/site/deployments/tools/my-lib.jar"
234+
"https://<URL>/api/publish?type=lib&path=/home/site/deployments/tools/my-lib.jar"
235235

236236
# Basic authentication
237237
curl -X POST \
238238
-u <username>:<password> \
239239
-T @"<lib-file-path>" \
240-
"https://<app-name>.scm.azurewebsites.net/api/publish?type=lib&path=/home/site/deployments/tools/my-lib.jar"
240+
"https://<URL>/api/publish?type=lib&path=/home/site/deployments/tools/my-lib.jar"
241241
```
242242

243243
> [!NOTE]
244-
> Get the actual fully qualified domain name to use in the URL from the [note at the beginning of the article](#dnl-note).
244+
> Get the Kudu URL from the Azure portal: open your app and select **Development Tools** > **Advanced Tools**, then select **Go** to open the Kudu URL.
245245
246246
### Deploy a static file
247247

248-
The following example uses the cURL tool to deploy a config file for the application. Replace the placeholders *\<config-file-path>* and *\<app-name>*. If you choose basic authentication, supply the [deployment credentials](deploy-configure-credentials.md) in *\<username>* and *\<password>*.
248+
The following example uses the cURL tool to deploy a config file for the application. Replace the placeholder *\<config-file-path>*. If you choose basic authentication, supply the [deployment credentials](deploy-configure-credentials.md) in *\<username>* and *\<password>*.
249249

250250
```bash
251251
# Microsoft Entra authentication
@@ -254,17 +254,17 @@ TOKEN=$(az account get-access-token --query accessToken | tr -d '"')
254254
curl -X POST \
255255
-H "Authorization: Bearer $TOKEN" \
256256
-T @"<config-file-path>" \
257-
"https://<app-name>.scm.azurewebsites.net/api/publish?type=static&path=/home/site/deployments/tools/my-config.json"
257+
"https://<URL>/api/publish?type=static&path=/home/site/deployments/tools/my-config.json"
258258

259259
# Basic authentication
260260
curl -X POST \
261261
-u <username>:<password> \
262262
-T @"<config-file-path>" \
263-
"https://<app-name>.scm.azurewebsites.net/api/publish?type=static&path=/home/site/deployments/tools/my-config.json"
263+
"https://<URL>/api/publish?type=static&path=/home/site/deployments/tools/my-config.json"
264264
```
265265

266266
> [!NOTE]
267-
> Get the actual fully qualified domain name to use in the URL from the [note at the beginning of the article](#dnl-note).
267+
> Get the Kudu URL from the Azure portal: open your app and select **Development Tools** > **Advanced Tools**, then select **Go** to open the Kudu URL.
268268
269269
# [ARM template](#tab/arm)
270270

@@ -302,18 +302,18 @@ curl -X POST \
302302
-H "Authorization: Bearer $TOKEN" \
303303
-H "Content-Type: application/json" \
304304
-d '{"packageUri": "https://storagesample.blob.core.windows.net/sample-container/myapp.zip?sv=2021-10-01&sb&sig=slk22f3UrS823n4kSh8Skjpa7Naj4CG3"}' \
305-
"https://<app-name>.scm.azurewebsites.net/api/publish?type=zip"
305+
"https://<URL>/api/publish?type=zip"
306306

307307
# Basic authentication
308308
curl -X POST \
309309
-u '<username>:<password>' \
310310
-H "Content-Type: application/json" \
311311
-d '{"packageUri": "https://storagesample.blob.core.windows.net/sample-container/myapp.zip?sv=2021-10-01&sb&sig=slk22f3UrS823n4kSh8Skjpa7Naj4CG3"}' \
312-
"https://<app-name>.scm.azurewebsites.net/api/publish?type=zip"
312+
"https://<URL>/api/publish?type=zip"
313313
```
314314

315315
> [!NOTE]
316-
> Get the actual fully qualified domain name to use in the URL from the [note at the beginning of the article](#dnl-note).
316+
> Get the Kudu URL from the Azure portal: open your app and select **Development Tools** > **Advanced Tools**, then select **Go** to open the Kudu URL.
317317
318318
# [ARM template](#tab/arm)
319319

articles/app-service/overview-authentication-authorization.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -181,7 +181,7 @@ Disable [Azure Front Door caching](../frontdoor/front-door-caching.md) for the a
181181

182182
### Use the Azure Front Door endpoint for redirects
183183

184-
App Service is usually not accessible directly when it's exposed by Azure Front Door. You can prevent this behavior, for example, by exposing App Service by using Azure Private Link in Azure Front Door Premium. To prevent the authentication workflow from redirecting traffic back to App Service directly, it's important to configure the application to redirect back to `https://<front-door-endpoint>/.auth/login/<provider>/callback`.
184+
App Service is usually not accessible directly when it's exposed by Azure Front Door. You can prevent this behavior, for example, by exposing App Service by using Azure Private Link in Azure Front Door Premium. To prevent the authentication workflow from redirecting traffic back to App Service directly. For more information, see [Redirect URI](/entra/identity-platform/reply-url).
185185

186186
### Ensure that App Service is using the right redirect URI
187187

0 commit comments

Comments
 (0)