Skip to content

Commit 30c6636

Browse files
authored
Merge pull request #90298 from btardif/master
adding details about client certificate exclusion paths
2 parents a055b2c + 0a054fc commit 30c6636

File tree

2 files changed

+13
-2
lines changed

2 files changed

+13
-2
lines changed

articles/app-service/app-service-web-configure-tls-mutual-auth.md

Lines changed: 13 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ ms.service: app-service
1212
ms.workload: na
1313
ms.tgt_pltfrm: na
1414
ms.topic: article
15-
ms.date: 02/22/2019
15+
ms.date: 10/01/2019
1616
ms.author: cephalin
1717
ms.custom: seodec18
1818

@@ -33,6 +33,15 @@ To set up your app to require client certificates, you need to set the `clientCe
3333
az webapp update --set clientCertEnabled=true --name <app_name> --resource-group <group_name>
3434
```
3535

36+
## Exclude paths from requiring authentication
37+
38+
When you enable mutual auth for your application, all paths under the root of your app will require a client certificate for access. To allow certain paths to remain open for anonymous access, you can define exclusion paths as part of your application configuration.
39+
40+
Exclusion paths can be configured by selecting **Configuration** > **General Settings** and defining an exclusion path. In this example, anything under `/public` path for your application would not request a client certificate.
41+
42+
![Certificate Exclusion Paths][exclusion-paths]
43+
44+
3645
## Access client certificate
3746

3847
In App Service, SSL termination of the request happens at the frontend load balancer. When forwarding the request to your app code with [client certificates enabled](#enable-client-certificates), App Service injects an `X-ARR-ClientCert` request header with the client certificate. App Service does not do anything with this client certificate other than forwarding it to your app. Your app code is responsible for validating the client certificate.
@@ -208,4 +217,6 @@ export class AuthorizationHandler {
208217
}
209218
}
210219
}
211-
```
220+
```
221+
222+
[exclusion-paths]: ./media/app-service-web-configure-tls-mutual-auth/exclusion-paths.png
100 KB
Loading

0 commit comments

Comments
 (0)