Auth0 OIDC Client

The Auth0 OIDC Client allows you to add authentication for your .NET Client applications. The Auth0 OIDC Client supports the following platforms:

Universal Windows Platform (UWP 10.0.16299 and higher)
Windows Presentation Foundation (.NET 4.6.2 and higher)
Windows Forms (.NET 4.6.2 and higher)
iOS (uses Xamarin)
Android (uses Xamarin)

Quick Start

Before you start, ensure that you have configured the Callback URL in the Clients Settings section in the Auth0 dashboard. See the Callback URLs documentation for more information on what Callback URL you need to use for your particular platform.

Note

You will also need to ensure that the JWT Signature Algorithm for your client is set to RS256

1. Install the NuGet Package for your platform

Universal Windows Platform (UWP)

Install-Package Auth0.OidcClient.UWP

Windows Presentation Foundation (WPF)

Install-Package Auth0.OidcClient.WPF

Windows Forms

Install-Package Auth0.OidcClient.WinForms

iOS (uses Xamarin)

Install-Package Auth0.OidcClient.iOS

Android (uses Xamarin)

Install-Package Auth0.OidcClient.Android

2. Initialize

using Auth0.OidcClient;

var client = new Auth0Client(new Auth0ClientOptions
{
    Domain = "YOUR_AUTH0_DOMAIN",
    ClientId = "YOUR_AUTH0_CLIENT_ID"
});

3. Authenticate

For Windows clients, you can simply call @Auth0.OidcClient.Auth0Client.LoginAsync(System.Object)

var loginResult = await client.LoginAsync();

For Android and iOS clients, you need to do some manual work to log a user in. The basic flow is as follows:

Obtain an AuthorizeState by calling @Auth0.OidcClient.Auth0Client.PrepareLoginAsync(System.Object). You will need to save the instance of AuthorizeState as you will need it later on.
Launch the system browser and direct the user to the StartUrl in the returned AuthorizeState. After the user has logged in, Auth0 will call back to your application on the Callback URL.
Your application will need to handle the callback. The means either creating an Intent or Android, or handling OpenUrl in your AppDelegate on iOS.