Skip to content

Commit 5b1584e

Browse files
Provide Microsoft.AspNetCore.Authentication.Negotiate package README (#57772)
Co-authored-by: Stephen Halter <halter73@gmail.com>
1 parent ffd5a38 commit 5b1584e

File tree

1 file changed

+42
-0
lines changed
  • src/Security/Authentication/Negotiate/src

1 file changed

+42
-0
lines changed
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,42 @@
1+
## About
2+
3+
`Microsoft.AspNetCore.Authentication.Negotiate` contains an authentication handler used to authenticate requests using Windows Authentication (also known as Negotiate, Kerberos, or NTLM).
4+
5+
## How to Use
6+
7+
To use `Microsoft.AspNetCore.Authentication.Negotiate`, follow these steps:
8+
9+
### Installation
10+
11+
```shell
12+
dotnet add package Microsoft.AspNetCore.Authentication.Negotiate
13+
```
14+
15+
### Configuration
16+
17+
To use the middleware, configure it in your ASP.NET Core app's `Program.cs`:
18+
19+
```csharp
20+
builder.Services.AddAuthentication(NegotiateDefaults.AuthenticationScheme)
21+
.AddNegotiate();
22+
23+
builder.Services.AddAuthorization();
24+
25+
var app = builder.Build();
26+
27+
Next, refer to the [official documentation](https://learn.microsoft.com/aspnet/core/security/authentication/windowsauth) for configuration details specific to your app's web server.
28+
29+
## Main Types
30+
31+
The main types provided by this package are:
32+
33+
* `NegotiateOptions`: Represents the options for configuring Negotiate Authentication handler behavior
34+
* `NegotiateHandler`: The authentication handler responsible for processing Negotiate authentication requests and generating the appropriate authentication ticket
35+
36+
## Additional Documentation
37+
38+
For additional documentation and examples, refer to the [official documentation](https://learn.microsoft.com/aspnet/core/security/authentication/windowsauth) on Windows Authentication in ASP.NET Core.
39+
40+
## Feedback &amp; Contributing
41+
42+
`Microsoft.AspNetCore.Authentication.Negotiate` is released as open-source under the [MIT license](https://licenses.nuget.org/MIT). Bug reports and contributions are welcome at [the GitHub repository](https://github.com/dotnet/aspnetcore).

0 commit comments

Comments
 (0)