zitadel net

Welcome to the repository of the ZITADEL dotnet libraries.

This repository contains authentication and resource management for ZITADEL in .NET. It can be used to create a ASP.NET application (with internal session management) or WebAPIs with OIDC introspection. Further, the compiled proto resources of the ZITADEL source repository are included to access the API of ZITADEL and manage resources.

as well as the examples folder which contains several examples for accessing the API of ZITADEL or using it in a WebApp or WebAPI.

To help developing the libraries, you may just open an issue or create a pull request to this repository.

To set up the dev environment, you need to install:

1. .NET SDK (8.x or later)
2. Buf CLI - for protobuf code generation
3. Just - task runner (installed via dotnet tools)

Follow these steps to build the project:

1. Install .NET tools (including Just):

   dotnet tool restore

2. Generate gRPC code (required before first build):

   just generate-grpc

3. Build the project:

   dotnet build

4. Run tests:

   dotnet test --configuration Release

These libraries are licensed under the Apache 2.0 License.