The Auth0.NET SDK is a collection of .NET libraries that provide programmatic access to Auth0's Authentication and Management APIs. This SDK enables .NET applications to integrate Auth0 authentication flows, manage Auth0 tenant resources, and interact with user identities.
This document provides a high-level overview of the SDK architecture, package structure, and core capabilities. For detailed setup instructions, see Getting Started. For information about specific package functionality, see Authentication API and Management API.
The SDK is distributed as three independent NuGet packages with a layered dependency structure. A significant architectural shift in the v8 release includes the use of Fern for generating the Auth0.ManagementApi client and models to ensure parity with the Auth0 Management API.
The following diagram maps high-level system components to their specific code implementations and package boundaries.
Sources: src/Auth0.Core/Auth0.Core.csproj17-19 src/Auth0.AuthenticationApi/Auth0.AuthenticationApi.csproj12-21 src/Auth0.ManagementApi/Auth0.ManagementApi.csproj42-45 CHANGELOG.md7-16 README.md8
| Package | Purpose | Key Dependencies |
|---|---|---|
| Auth0.Core | Shared foundation library containing HTTP utilities, exception types, and common models. | Newtonsoft.Json 13.0.4 |
| Auth0.AuthenticationApi | Implements user-facing OAuth 2.0 and OIDC flows including token acquisition, passwordless authentication, and MFA. | Auth0.Core, Microsoft.IdentityModel.Protocols.OpenIdConnect 8.17.0, System.IdentityModel.Tokens.Jwt 8.17.0 |
| Auth0.ManagementApi | Provides administrative access to Auth0 tenant resources. Features a new architecture generated via Fern, utilizing System.Text.Json. | Auth0.Core, System.Text.Json 9.0.9, PolySharp |
For details on dependencies and the Fern-generated structure, see Package Structure and Dependencies.
Sources: src/Auth0.Core/Auth0.Core.csproj1-27 src/Auth0.AuthenticationApi/Auth0.AuthenticationApi.csproj1-28 src/Auth0.ManagementApi/Auth0.ManagementApi.csproj1-61 README.md21-67
The SDK targets multiple frameworks to ensure compatibility across the .NET ecosystem, including modern cross-platform environments and legacy systems:
Sources: src/Auth0.ManagementApi/Auth0.ManagementApi.csproj4 README.md19-20 build/common.props1-38
The SDK provides access to two distinct Auth0 APIs with different purposes and authentication requirements. For details on usage, see Getting Started.
The following diagram illustrates how different application types interact with the SDK components to reach the Auth0 Platform.
The AuthenticationApiClient implements user-facing authentication flows. Key features include:
System.IdentityModel.Tokens.JwtSources: README.md125-139 docs/xrefmap.yml10-100 docs/api/toc.html14-112
The ManagementApi has been modernized in v8. While ManagementApiClient remains available for direct use with a token, the recommended entry point is now the ManagementClient wrapper.
ManagementClient abstracts token acquisition and refresh via ITokenProvider (e.g., ClientCredentialsTokenProvider).Users, Organizations, Clients, and Connections..WithRawResponse() to access HTTP metadata alongside parsed data.Sources: README.md32-53 README.md143-165 docs-source/index.md29-41
Located in the Auth0.AuthenticationApi namespace, this class provides methods for token acquisition and user signup. It is typically instantiated with a Uri pointing to your Auth0 domain.
Sources: docs/xrefmap.yml10-33 README.md127-131
The ManagementClient is the high-level wrapper that manages the lifecycle of authentication tokens. It delegates the actual API calls to ManagementApiClient, which acts as a facade for dozens of specialized clients (e.g., UsersClient, JobsClient).
Sources: README.md32-49 docs-source/index.md29-40
The SDK follows a versioning strategy where the Auth0.Core and Auth0.AuthenticationApi packages are aligned, while the Auth0.ManagementApi package may follow an independent versioning path (often prefixed with mgmt-) to accommodate the rapid evolution of the Management API.
For details on the release process and history, see Versioning and Releases and the Migration Guides.
Sources: build/common.props23 src/Auth0.ManagementApi/Auth0.ManagementApi.csproj8 .version1 CHANGELOG.md1-10
Refresh this wiki