Skip to content

auth0/auth0-dotnet-templates

Repository files navigation

Auth0 Templates for .NET

The Auth0 Templates for .NET package allows you to quickly bootstrap a .NET application secured with Auth0. You can use the Auth0 Templates with the .NET CLI and Visual Studio.

Getting started

Requirements

  • An Auth0 account. You can sign up for a free one right now.
  • .NET Core 7.0 SDK or higher.
  • (Optional, but recommended) Auth0 CLI version 1.0.1
  • (Optional) Visual Studio 2022 for Windows (ver. 17.4+)
  • (Optional) Visual Studio 2022 for Mac (ver. 17.5+)
  • (Optional) JetBrains Rider (ver. 2024.1+)

Installation

You can install the Auth0 Templates from NuGet by running the following command in your terminal window:

dotnet new install Auth0.Templates

Once installed, the templates are available in .NET CLI, Visual Studio for Windows, Visual Studio for Mac, and JetBrains Rider.

Usage

Currently, the following .NET templates are implemented:

Installing from source code

To work locally with the Auth0 Templates, i.e., using the templates from the source code, follow these steps:

  1. Clone this repository

  2. Create a local NuGet package by running the following command in the root folder of the project:

    dotnet pack -o ./output

    Your NuGet package will be generated in the ./output/ folder.

  3. Install the templates by running the following command:

    dotnet new -i ./output/Auth0.Templates.*.nupkg

ℹ️ If you have Node.js installed on your machine, you can create and install a local NuGet package by using the following command in the root folder of the project:

npm run pack-install

That command also works for updating a currently installed package.

License

This project is licensed under the Apache license. See the License.txt file for more info.

Feedback

Contributing

We appreciate feedback and contribution to this repo! Before you get started, please see the following:

Raise an issue

To provide feedback or report a bug, please raise an issue on our issue tracker.

Vulnerability Reporting

Please do not report security vulnerabilities on the public GitHub issue tracker. The Responsible Disclosure Program details the procedure for disclosing security issues.


Auth0 Logo

Auth0 is an easy to implement, adaptable authentication and authorization platform.
To learn more check out Why Auth0?