AuthEndpoints.External.OAuth 3.0.0-preview.2

This is a prerelease version of AuthEndpoints.External.OAuth.

dotnet add package AuthEndpoints.External.OAuth --version 3.0.0-preview.2

NuGet\Install-Package AuthEndpoints.External.OAuth -Version 3.0.0-preview.2

This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.

<PackageReference Include="AuthEndpoints.External.OAuth" Version="3.0.0-preview.2" />

For projects that support PackageReference, copy this XML node into the project file to reference the package.

<PackageVersion Include="AuthEndpoints.External.OAuth" Version="3.0.0-preview.2" />
                    

                            Directory.Packages.props

<PackageReference Include="AuthEndpoints.External.OAuth" />
                    

                            Project file

For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.

paket add AuthEndpoints.External.OAuth --version 3.0.0-preview.2

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

#r "nuget: AuthEndpoints.External.OAuth, 3.0.0-preview.2"

#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.

#:package AuthEndpoints.External.OAuth@3.0.0-preview.2

#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.

#addin nuget:?package=AuthEndpoints.External.OAuth&version=3.0.0-preview.2&prerelease
                    

                            Install as a Cake Addin

#tool nuget:?package=AuthEndpoints.External.OAuth&version=3.0.0-preview.2&prerelease
                    

                            Install as a Cake Tool

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

AuthEndpoints.External.OAuth

Preview package: modular external OAuth endpoints for AuthEndpoints (cookie completion by default; pluggable JWT completer).

Layout

Core/ — shared options, provisioning, completers, login/link handlers
GitHub/ — AddGitHub / MapGitHubAuthEndpoints
Google/ — AddGoogle / MapGoogleAuthEndpoints

This package references both GitHub and Google OAuth handler packages. Splitting into per-provider NuGets may come in a later release.

Install

dotnet add package AuthEndpoints.External.OAuth --version 3.0.0-preview.2

Requires AuthEndpoints (Identity host). Does not use Identity management HTTP APIs.

Usage

using AuthEndpoints.External.OAuth;
using AuthEndpoints.External.OAuth.GitHub;
using AuthEndpoints.External.OAuth.Google;

builder.Services.AddExternalAuthEndpoints<AppUser>(o =>
{
    o.RequireVerifiedEmail = true;
    o.AutoLinkByEmail = true;
    o.ErrorPath = "/auth/external/error";
})
.AddGitHub(o =>
{
    o.ClientId = "...";
    o.ClientSecret = "...";
})
.AddGoogle(o =>
{
    o.ClientId = "...";
    o.ClientSecret = "...";
});

// JWT completion (requires AddJwtEndpoints):
// .AddCompleter<JwtExternalLoginCompleter<AppUser>>()

var external = app.MapGroup("/auth/external").WithTags("External");
external.MapGitHubAuthEndpoints<AppUser>();
external.MapGoogleAuthEndpoints<AppUser>();
external.MapExternalAccountEndpoints<AppUser>();

Completers

Type	Behavior
`CookieExternalLoginCompleter<TUser>` (default)	Identity cookie + clear External scheme + redirect
`JwtExternalLoginCompleter<TUser>`	Refresh cookie + clear External + redirect (SPA uses JWT refresh for access token)

Docs

See External OAuth.

Product	Compatible and additional computed target framework versions.
.NET	net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed.

Compatible target framework(s)

Included target framework(s) (in package)

Learn more about Target Frameworks and .NET Standard.

net10.0
- AspNet.Security.OAuth.GitHub (>= 10.0.0)
- AuthEndpoints (>= 3.0.0-rc.2)
- Microsoft.AspNetCore.Authentication.Google (>= 10.0.2)

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version	Downloads	Last Updated
3.0.0-preview.2	51	7/30/2026