Changelog
Getting Started

Installation

Add the AuthEndpoints NuGet package to your ASP.NET Core project.

NuGet package

dotnet add package AuthEndpoints --version 3.0.0-rc.3

Or use the latest version from NuGet.

Requirements

RequirementNotes
.NET 10Target framework net10.0
ASP.NET Core IdentityUser store and sign-in
EF CoreIdentity 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 --version 3.0.0-preview.2

See External OAuth. Versions are independent from the core package.

Next steps

Continue to Quick start to wire the facade in Program.cs.