https://github.com/smartive/zitadel-net

Authentication / Authorization library for zitadel (zitadel.com), written in dotnet for the asp.net web application package.
https://github.com/smartive/zitadel-net

asp authn authorization bearer dotnet introspection jwt oauth2 oidc zitadel

Last synced: about 2 hours ago
JSON representation

Authentication / Authorization library for zitadel (zitadel.com), written in dotnet for the asp.net web application package.

• Host: GitHub
• URL: https://github.com/smartive/zitadel-net
• Owner: smartive
• License: apache-2.0
• Created: 2020-05-26T15:06:13.000Z (over 5 years ago)
• Default Branch: main
• Last Pushed: 2025-09-12T22:14:24.000Z (23 days ago)
• Last Synced: 2025-09-26T21:17:19.908Z (9 days ago)
• Topics: asp, authn, authorization, bearer, dotnet, introspection, jwt, oauth2, oidc, zitadel
• Language: C#
• Homepage:
• Size: 1.95 MB
• Stars: 85
• Watchers: 3
• Forks: 12
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# ZITADEL .NET

[![.NET Release](https://github.com/smartive/zitadel-net/actions/workflows/dotnet-release.yml/badge.svg)](https://github.com/smartive/zitadel-net/actions/workflows/dotnet-release.yml)

[![Nuget](https://img.shields.io/nuget/v/Zitadel)](https://www.nuget.org/packages/Zitadel/)

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](./examples) folder which contains several examples

for accessing the [API of ZITADEL](./examples/Zitadel.ApiAccess)

or using it in a [WebApp](./examples/Zitadel.AspNet.AuthN) or

[WebAPI](./examples/Zitadel.WebApi).

### Development

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

to this repository.

#### Prerequisites

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

1. [.NET SDK](https://dotnet.microsoft.com/download) (8.x or later)

2. [Buf CLI](https://buf.build/docs/installation) - for protobuf code generation

3. [Just](https://github.com/casey/just) - task runner (installed via dotnet tools)

#### Building the Project

Follow these steps to build the project:

1. **Install .NET tools (including Just):**

   ```bash

   dotnet tool restore

   ```

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

   ```bash

   just generate-grpc

   ```

3. **Build the project:**

   ```bash

   dotnet build

   ```

4. **Run tests:**

   ```bash

   dotnet test --configuration Release

   ```

##### License

These libraries are licensed under the [Apache 2.0 License](LICENSE).