AuthEndpoints
Changelog
Get started

Install AuthEndpoints

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

NuGet package

nuget

dotnet add package AuthEndpoints

The badge shows the latest published version. Release notes are 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)

Register a DbContext that works as the Identity store, such as IdentityDbContext<TUser> or a class that derives from it.

Package contents

The AuthEndpoints package includes these modules:

  • The facade: AddAuthEndpoints, UseAuthEndpoints, and MapAuthEndpoints.
  • Identity management, cookie sign-in, and Identity bearer sign-in.
  • JWT with an HttpOnly refresh cookie.
  • Passkeys (WebAuthn).
  • ReAuth step-up.

Optional: External OAuth

GitHub and Google sign-in ship as preview packages. MapAuthEndpoints does not map them. Install the provider package that you use. Each one depends on AuthEndpoints.External.OAuth, which has no GitHub or Google handler of its own.

nuget

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

These packages have their own version numbers. See External OAuth packages.

Next steps

Introduction

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

Quick start

Build a minimal ASP.NET Core API where a user registers, confirms their email, signs in with a cookie, and signs out.