Skip to content

Commit a797773

Browse files
committed
Merge branch 'main' of https://github.com/MicrosoftDocs/azure-docs-pr into erresiliency
2 parents 4b8fd52 + 597fc8c commit a797773

File tree

82 files changed

+1323
-1444
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

82 files changed

+1323
-1444
lines changed

.openpublishing.redirection.json

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -379,6 +379,16 @@
379379
"redirect_url": "/previous-versions/azure/partner-solutions/logzio/troubleshoot",
380380
"redirect_document_id": false
381381
},
382+
{
383+
"source_path": "articles/security/fundamentals/ocsp-sha-1-sunset.md",
384+
"redirect_url": "/azure/security/fundamentals/azure-CA-details",
385+
"redirect_document_id": false
386+
},
387+
{
388+
"source_path": "articles/security/fundamentals/tls-certificate-changes.md",
389+
"redirect_url": "/azure/security/fundamentals/azure-CA-details",
390+
"redirect_document_id": false
391+
},
382392
{
383393
"source_path": "articles/event-grid/event-schema-storage-actions.md",
384394
"redirect_url": "/azure/storage-actions/overview",

articles/app-service/app-service-ip-restrictions.md

Lines changed: 76 additions & 78 deletions
Large diffs are not rendered by default.

articles/app-service/configure-basic-auth-disable.md

Lines changed: 55 additions & 52 deletions
Large diffs are not rendered by default.

articles/app-service/deploy-azure-pipelines.md

Lines changed: 86 additions & 90 deletions
Large diffs are not rendered by default.
Lines changed: 33 additions & 40 deletions
Original file line numberDiff line numberDiff line change
@@ -1,31 +1,30 @@
11
---
2-
title: Configure deployment credentials
2+
title: Configure Deployment Credentials
33
description: Learn what types of deployment credentials are in Azure App Service and how to configure and use them.
4-
5-
ms.topic: article
6-
ms.date: 01/26/2024
7-
ms.reviewer: byvinyal
84
author: cephalin
95
ms.author: cephalin
6+
ms.reviewer: byvinyal
7+
ms.topic: how-to
8+
ms.date: 01/26/2024
9+
1010
---
1111

1212
# Configure deployment credentials for Azure App Service
13-
To secure app deployment from a local computer, [Azure App Service](./overview.md) supports two types of credentials for [local Git deployment](deploy-local-git.md)
14-
and [FTP/S deployment](deploy-ftp.md). These credentials are not the same as your Azure subscription credentials.
13+
To secure app deployment from a local computer, [Azure App Service](./overview.md) supports two types of credentials for [local Git deployment](deploy-local-git.md) and [FTP/FTPS deployment](deploy-ftp.md). These credentials are different from your Azure subscription credentials.
1514

1615
[!INCLUDE [app-service-deploy-credentials](../../includes/app-service-deploy-credentials.md)]
1716

1817
> [!NOTE]
19-
> When [basic authentication is disabled](configure-basic-auth-disable.md), you can't view or configure deployment credentials in the Deployment Center.
18+
> When [basic authentication is disabled](configure-basic-auth-disable.md), you can't view or configure deployment credentials in **Deployment Center**.
2019
2120
## <a name="userscope"></a>Configure user-scope credentials
2221

2322
# [Azure CLI](#tab/cli)
2423

25-
Run the [az webapp deployment user set](/cli/azure/webapp/deployment/user#az-webapp-deployment-user-set) command. Replace \<username> and \<password> with a deployment user username and password.
24+
Run the [`az webapp deployment user set`](/cli/azure/webapp/deployment/user#az-webapp-deployment-user-set) command. Replace `<username>` and `<password>` with a deployment user's username and password.
2625

27-
- The username must be unique within Azure, and for local Git pushes, must not contain the ‘@’ symbol.
28-
- The password must be at least eight characters long, with two of the following three elements: letters, numbers, and symbols.
26+
- The username must be unique within Azure, and for local Git pushes, must not contain the @ symbol.
27+
- The password must be at least eight characters long, with two of the following three elements: letters, numbers, and symbols.
2928

3029
```azurecli-interactive
3130
az webapp deployment user set --user-name <username> --password <password>
@@ -35,70 +34,66 @@ The JSON output shows the password as `null`.
3534

3635
# [Azure PowerShell](#tab/powershell)
3736

38-
You can't configure the user-scope credentials with Azure PowerShell. Use a different method, or consider [using application-scope credentials](#appscope).
37+
You can't configure the user-scope credentials by using Azure PowerShell. Use a different method, or consider [using application-scope credentials](#appscope).
3938

4039
# [Azure portal](#tab/portal)
4140

42-
You can configure your user-scope credentials in any app's [resource page](../azure-resource-manager/management/manage-resources-portal.md#manage-resources). Regardless in which app you configure these credentials, it applies to all apps for all subscriptions in your Azure account.
41+
You can configure your user-scope credentials in any app's [resource page](../azure-resource-manager/management/manage-resources-portal.md#manage-resources). Regardless of which app you use to configure these credentials, the credentials apply to all apps for all subscriptions in your Azure account.
4342

44-
In the [Azure portal](https://portal.azure.com), you must have at least one app before you can access the deployment credentials page. To configure your user-scope credentials:
43+
You must have at least one app in the [Azure portal](https://portal.azure.com) before you can access the deployment credentials page. To configure your user-scope credentials:
4544

46-
1. From the left menu of your app, select > **Deployment center** > **FTPS credentials** or **Local Git/FTPS credentials**.
47-
48-
![Shows how you can select the FTP dashboard from the Deployment center in Azure App Services.](./media/app-service-deployment-credentials/access-no-git.png)
45+
1. From the left menu of your app, select > **Deployment Center** > **FTPS credentials** or **Local Git/FTPS credentials**.
4946

5047
2. Scroll down to **User scope**, configure the **Username** and **Password**, and then select **Save**.
5148

52-
Once you have set your deployment credentials, you can find the *Git* deployment username in your app's **Overview** page,
49+
After you set your deployment credentials, you can find the Git deployment username in your app's **Overview** page.
5350

54-
![Shows how to find the Git deployment user name on your app's Overview page.](./media/app-service-deployment-credentials/deployment_credentials_overview.png)
51+
![Screenshot that shows you how to find the Git deployment user name on your app's Overview page.](./media/app-service-deployment-credentials/deployment_credentials_overview.png)
5552

56-
If Git deployment is configured, the page shows a **Git/deployment username**; otherwise, an **FTP/deployment username**.
53+
If Git deployment is configured, the page shows **Git/deployment username**. Otherwise, it shows **FTP/deployment username**.
5754

5855
> [!NOTE]
59-
> Azure does not show your user-scope deployment password. If you forget the password, you can reset your credentials by following the steps in this section.
60-
>
61-
>
56+
> Azure doesn't show your user-scope deployment password. If you forget the password, you can follow the steps in this section to reset your credentials.
6257
6358
-----
6459

6560
## Use user-scope credentials with FTP/FTPS
6661

67-
Authenticating to an FTP/FTPS endpoint using user-scope credentials requires a username in the following format:
62+
To authenticate to an FTP/FTPS endpoint by using user-scope credentials, your username must follow this format:
6863
`<app-name>\<user-name>`
6964

70-
Since user-scope credentials are linked to the user and not a specific resource, the username must be in this format to direct the sign-in action to the right app endpoint.
65+
Since user-scope credentials are linked to the user and not to a specific resource, the username must be in this format to direct the sign-in action to the right app endpoint.
7166

7267
## <a name="appscope"></a>Get application-scope credentials
7368

7469
# [Azure CLI](#tab/cli)
7570

76-
Get the application-scope credentials using the [az webapp deployment list-publishing-profiles](/cli/azure/webapp/deployment#az-webapp-deployment-list-publishing-profiles) command. For example:
71+
Get the application-scope credentials by using the [`az webapp deployment list-publishing-profiles`](/cli/azure/webapp/deployment#az-webapp-deployment-list-publishing-profiles) command. For example:
7772

7873
```azurecli-interactive
7974
az webapp deployment list-publishing-profiles --resource-group <group-name> --name <app-name>
8075
```
8176

82-
For [local Git deployment](deploy-local-git.md), you can also use the [az webapp deployment list-publishing-credentials](/cli/azure/webapp/deployment#az-webapp-deployment-list-publishing-credentials) command to get a Git remote URI for your app, with the application-scope credentials already embedded. For example:
77+
For [local Git deployment](deploy-local-git.md), you can also use the [`az webapp deployment list-publishing-credentials`](/cli/azure/webapp/deployment#az-webapp-deployment-list-publishing-credentials) command. When you use this command, you get a Git remote URI for your app that has the application-scope credentials already embedded. For example:
8378

8479
```azurecli-interactive
8580
az webapp deployment list-publishing-credentials --resource-group <group-name> --name <app-name> --query scmUri
8681
```
87-
Note that the returned Git remote URI doesn't contain `/<app-name>.git` at the end. When you add the remote URI, make sure to append `/<app-name>.git` to avoid an error 22 with `git-http-push`. Additionally, when using `git remote add ... ` via shells that use the dollar sign for variable interpolation (such as bash), escape any dollar signs (`\$`) in the username or password. Failure to escape this character can result in authentication errors.
82+
83+
> [!NOTE]
84+
> The returned Git remote URI doesn't contain `/<app-name>.git` at the end. When you add the remote URI, make sure to append `/<app-name>.git` to avoid an error 22 with `git-http-push`. Additionally, when using `git remote add ... ` via shells that use the dollar sign for variable interpolation (such as bash), escape any dollar signs `\$` in the username or password. Failure to escape this character can result in authentication errors.
8885
8986
# [Azure PowerShell](#tab/powershell)
9087

91-
Get the application-scope credentials using the [Get-AzWebAppPublishingProfile](/powershell/module/az.websites/get-azwebapppublishingprofile) command. For example:
88+
Get the application-scope credentials by using the [`Get-AzWebAppPublishingProfile`](/powershell/module/az.websites/get-azwebapppublishingprofile) command. For example:
9289

9390
```azurepowershell-interactive
9491
Get-AzWebAppPublishingProfile -ResourceGroupName <group-name> -Name <app-name>
9592
```
9693

9794
# [Azure portal](#tab/portal)
9895

99-
1. From the left menu of your app, select **Deployment center** > **FTPS credentials** or **Local Git/FTPS credentials**.
100-
101-
![Shows how you can select the FTP dashboard from the Deployment center in Azure App Services.](./media/app-service-deployment-credentials/access-no-git.png)
96+
1. From the left menu of your app, select **Deployment Center** > **FTPS credentials** or **Local Git/FTPS credentials**.
10297

10398
2. In the **Application scope** section, select the **Copy** link to copy the username or password.
10499

@@ -108,34 +103,32 @@ Get-AzWebAppPublishingProfile -ResourceGroupName <group-name> -Name <app-name>
108103

109104
# [Azure CLI](#tab/cli)
110105

111-
Reset the application-scope credentials using the [az resource invoke-action](/cli/azure/resource#az-resource-invoke-action) command:
106+
Reset the application-scope credentials by using the [`az resource invoke-action`](/cli/azure/resource#az-resource-invoke-action) command:
112107

113108
```azurecli-interactive
114109
az resource invoke-action --action newpassword --resource-group <group-name> --name <app-name> --resource-type Microsoft.Web/sites
115110
```
116111

117112
# [Azure PowerShell](#tab/powershell)
118113

119-
Reset the application-scope credentials using the [Invoke-AzResourceAction](/powershell/module/az.resources/invoke-azresourceaction) command:
114+
Reset the application-scope credentials by using the [`Invoke-AzResourceAction`](/powershell/module/az.resources/invoke-azresourceaction) command:
120115

121116
```azurepowershell-interactive
122117
Invoke-AzResourceAction -ResourceGroupName <group-name> -ResourceType Microsoft.Web/sites -ResourceName <app-name> -Action newpassword
123118
```
124119

125120
# [Azure portal](#tab/portal)
126121

127-
1. From the left menu of your app, select **Deployment center** > **FTPS credentials** or **Local Git/FTPS credentials**.
128-
129-
![Shows how you can select the FTP dashboard from the Deployment center in Azure App Services.](./media/app-service-deployment-credentials/access-no-git.png)
122+
1. From the left menu of your app, select **Deployment Center** > **FTPS credentials** or **Local Git/FTPS credentials**.
130123

131124
2. In the **Application scope** section, select **Reset**.
132125

133126
-----
134127

135128
## Disable basic authentication
136129

137-
See [Disable basic authentication in App Service deployments](configure-basic-auth-disable.md).
130+
See [Disable basic authentication in App Service deployment](configure-basic-auth-disable.md).
138131

139-
## Next steps
132+
## Related content
140133

141-
Find out how to use these credentials to deploy your app from [local Git](deploy-local-git.md) or using [FTP/S](deploy-ftp.md).
134+
Find out how to use these credentials to deploy your app from a [local Git](deploy-local-git.md) or by using [FTP/FTPS](deploy-ftp.md).

0 commit comments

Comments
 (0)