AuthEndpoints
Changelog
Getting Started

Installation

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

NuGet package

nuget

dotnet add package AuthEndpoints

The badge tracks the published package. Release notes live in the changelog.

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 + HttpOnly refresh cookie)
  • Passkeys (WebAuthn)
  • ReAuth step-up

Optional: External OAuth

GitHub and Google OAuth ship as preview packages, composed beside the facade. MapAuthEndpoints does not map them. The core OAuth package has no GitHub or Google handler dependency. Install the provider package you use; it depends on AuthEndpoints.External.OAuth.

nuget

dotnet add package AuthEndpoints.OAuth.GitHub --prerelease
dotnet add package AuthEndpoints.OAuth.Google --prerelease

See External OAuth. These packages version independently from core.

Next steps

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

AI agents can load a skill. See AI agents.

Introduction

AuthEndpoints is an ASP.NET Core library of ready-made Identity auth endpoints for web and mobile clients.

AI agents

Add the AuthEndpoints skill for coding agents.