|
1 | | -## Customizable security descriptors for HTTP.sys |
| 1 | +### Customizable security descriptors for HTTP.sys |
2 | 2 | <!--PR: https://github.com/dotnet/aspnetcore/pull/61325--> |
3 | | -<!-- This section was deliberately made H2 --> |
| 3 | + |
4 | 4 | You can now specify a custom security descriptor for HTTP.sys request queues. The new `[RequestQueueSecurityDescriptor](https://source.dot.net/#Microsoft.AspNetCore.Server.HttpSys/HttpSysOptions.cs,a556950881fd2d87) property on <xref:Microsoft.AspNetCore.Server.HttpSys.HttpSysOptions> enables more granular control over access rights for the request queue. This granular control lets you tailor security to your application's needs. |
5 | 5 |
|
6 | | -### Why customizability matters |
| 6 | +#### Why customizability matters |
7 | 7 |
|
8 | 8 | HTTP.sys relies on a security descriptor for access control. This descriptor determines which users or groups are allowed to access specific HTTP URLs. |
9 | 9 |
|
10 | 10 | By customizing the security descriptor, you can allow or deny specific users or groups access to the request queue. This is useful in scenarios where you want to restrict or delegate HTTP.sys request handling at the operating system level. |
11 | 11 |
|
12 | | -### How to Customize a descriptor |
| 12 | +#### How to Customize a descriptor |
13 | 13 |
|
14 | | -The `RequestQueueSecurityDescriptor`property applies only when creating a new request queue. This property doesn't affect existing request queues. |
| 14 | +The `RequestQueueSecurityDescriptor` property applies only when creating a new request queue. This property doesn't affect existing request queues. |
15 | 15 |
|
16 | | -Set the `RequestQueueSecurityDescriptor` property to a `GenericSecurityDescriptor` instance when configuring your HTTP.sys server. For example, to allow all authenticated users but deny guests: |
| 16 | +Set the `RequestQueueSecurityDescriptor` property to a <xref:System.Security.AccessControl.GenericSecurityDescriptor> instance when configuring your HTTP.sys server. For example, to allow all authenticated users but deny guests: |
17 | 17 |
|
18 | 18 | ```csharp |
19 | 19 | using System.Security.AccessControl; |
@@ -51,6 +51,4 @@ builder.WebHost.UseHttpSys(options => |
51 | 51 | }); |
52 | 52 | ``` |
53 | 53 |
|
54 | | -### Related content |
55 | | - |
56 | | -<xref:fundamentals/servers/httpsys> |
| 54 | +For more information see <xref:fundamentals/servers/httpsys>. |
0 commit comments