Upgrade to 4.0Changelog
Get started

Install AuthEndpoints

Add the AuthEndpoints NuGet package to an ASP.NET Core project, check the .NET 10, Identity, and EF Core requirements, and add GitHub or Google.

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 4.x package includes these modules:

  • AddPasswordAuth, UseAuthEndpoints, and MapPasswordAuth.
  • Identity management, cookie sign-in, Identity bearer sign-in, and email-code sign-in.
  • JWT with cookie or body refresh.
  • Passkeys (WebAuthn).
  • ReAuth step-up, including an emailed code when no stronger factor exists.
  • External OAuth endpoints. Provider packages only register GitHub or Google.

Optional: GitHub and Google

The password facade does not map external sign-in. Install the provider you use. Each one depends on AuthEndpoints 4.x (range [4.0.0, 5.0.0)), not on a separate implementation package.

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

AuthEndpoints.External.OAuth below 4.0.0 fails the build with AE4000. The 4.0.0 package of that name is a shim you can remove. See External OAuth packages.

Next steps