Add Login to Your WPF Or WinForms Application

Auth0 allows you to add authentication to almost any application type quickly. This guide demonstrates how to integrate Auth0, add authentication, and display user profile information in any WPF and WinForms application using the Auth0 SDKs for WPF and WinForms.

To use this quickstart, you’ll need to:

  • Sign up for a free Auth0 account or log in to Auth0.
  • Have a working WPF or WinForms project that you want to integrate with. Alternatively, you can view or download a sample application after logging in.
1

Configure Auth0

To use Auth0 services, you’ll need to have an application set up in the Auth0 Dashboard. The Auth0 application is where you will configure how you want authentication to work for the project you are developing.

Configure an application

Use the interactive selector to create a new Auth0 application or select an existing application that represents the project you want to integrate with. Every application in Auth0 is assigned an alphanumeric, unique client ID that your application code will use to call Auth0 APIs through the SDK.

Any settings you configure using this quickstart will automatically update for your Application in the Dashboard, which is where you can manage your Applications in the future.

If you would rather explore a complete configuration, you can view a sample application instead.

Configure Callback URLs

A callback URL is a URL in your application that you would like Auth0 to redirect users to after they have authenticated. If not set, users will not be returned to your application after they log in.

Configure Logout URLs

A logout URL is a URL in your application that you would like Auth0 to redirect users to after they have logged out. If not set, users will not be able to log out from your application and will receive an error.

2

Install the Auth0 SDK

Auth0 provides a WPF and WinForms SDK to simplify the process of implementing Auth0 authentication in WPF and WinForms applications.

Use the NuGet Package Manager (Tools -> Library Package Manager -> Package Manager Console) to install the Auth0.OidcClient.WPF or Auth0.OidcClient.WinForms package, depending on whether you are building a WPF or Windows Forms application.

Alternatively, you can use the Nuget Package Manager Console (Install-Package) or the dotnet CLI (dotnet add).

Install-Package Auth0.OidcClient.WPF
Install-Package Auth0.OidcClient.WinForms

Was this helpful?

/
dotnet add Auth0.OidcClient.WPF
dotnet add Auth0.OidcClient.WinForms

Was this helpful?

/
3

Instantiate the Auth0Client

To integrate Auth0 into your application, instantiate an instance of the Auth0Client class, passing an instance of Auth0ClientOptions that contains your Auth0 Domain and Client ID.

By default, the SDK will leverage WebView2 for .NET6 and above, while relying on the older WebView on applications using any version that predates .NET6.

Checkpoint

Your Auth0Client should now be properly instantiated. Run your application to verify that:

  • the Auth0Client is instantiated correctly
  • your application is not throwing any errors related to Auth0
4

Add login to your application

Now that you have configured your Auth0 Application and the Auth0 SDK, you need to set up login for your project. To do this, you will use the SDK’s LoginAsync() method to create a login button that redirects users to the Auth0 Universal Login page. After a user successfully authenticates, they will be redirected to the callback URL you set up earlier in this quickstart.

If there isn't any error, you can access the User, IdentityToken, AccessToken and RefreshToken on the LoginResult returned from LoginAsync().

Checkpoint

You should now be able to log in or sign up using a username and password.

Click the login button and verify that:

  • your WPF or WinForms Application redirects you to the Auth0 Universal Login page
  • you can log in or sign up
  • Auth0 redirects you to your application.
5

Add logout to your application

Users who log in to your project will also need a way to log out. Create a logout button using the SDK’s LogoutAsync() method. When users log out, they will be redirected to your Auth0 logout endpoint, which will then immediately redirect them back to the logout URL you set up earlier in this quickstart.

Checkpoint

Run your application and click the logout button, verify that:

  • your WPF or WinForms application redirects you to the address you specified as one of the Allowed Logout URLs in your Application Settings
  • you are no longer logged in to your application
6

Show User Profile Information

Now that your users can log in and log out, you will likely want to be able to retrieve the profile information associated with authenticated users. For example, you may want to be able to display a logged-in user’s name or profile picture in your project.

The Auth0 SDK for WPF and WinForms provides user information through the LoginResult.User property.

Checkpoint

Verify that:

  • you can display the user's name or any other user property after you have logged in

Next Steps

Excellent work! If you made it this far, you should now have login, logout, and user profile information running in your application.

This concludes our quickstart tutorial, but there is so much more to explore. To learn more about what you can do with Auth0, check out:

Did it work?

Any suggestion or typo?

Edit on GitHub
Sign Up

Sign up for an or to your existing account to integrate directly with your own tenant.