Getting Started
Installation
Add the AuthEndpoints NuGet package to your ASP.NET Core project.
NuGet package
dotnet add package AuthEndpoints --prerelease
Use --prerelease while AuthEndpoints publishes RC/preview builds; a bare dotnet add package installs the latest stable only. Exact versions are listed on NuGet and in the changelog.
Requirements
| Requirement | Notes |
|---|---|
| .NET 10 | Target framework net10.0 |
| ASP.NET Core Identity | User store and sign-in |
| EF Core | Identity stores and JWT refresh-token table (when JWT is enabled) |
Your host must register a DbContext that can serve as the Identity store (typically IdentityDbContext<TUser> or a derived type).
Package contents
The AuthEndpoints package includes:
- Opinionated facade (
AddAuthEndpoints/UseAuthEndpoints/MapAuthEndpoints) - Identity management + cookie / bearer sign-in
- JWT (access token + refresh cookie)
- Passkeys (WebAuthn)
- ReAuth step-up
Optional: External OAuth
For GitHub/Google OAuth endpoints, add the separate preview package:
dotnet add package AuthEndpoints.External.OAuth --prerelease
See External OAuth. Versions are independent from the core package.
Next steps
Continue to Quick start to wire the facade in Program.cs.