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

An implementation of the ZITADEL gRPC API in Rust. Complemented with other useful elements such as ServiceAccount auth.
https://github.com/smartive/zitadel-rust

api authn authz client grpc rust rust-crate zitadel

Last synced: 5 days ago
JSON representation

An implementation of the ZITADEL gRPC API in Rust. Complemented with other useful elements such as ServiceAccount auth.

• Host: GitHub
• URL: https://github.com/smartive/zitadel-rust
• Owner: smartive
• License: other
• Created: 2022-02-04T23:27:32.000Z (almost 3 years ago)
• Default Branch: main
• Last Pushed: 2024-11-13T05:34:21.000Z (about 1 month ago)
• Last Synced: 2024-12-13T17:56:26.681Z (9 days ago)
• Topics: api, authn, authz, client, grpc, rust, rust-crate, zitadel
• Language: Rust
• Homepage: https://docs.rs/zitadel/latest/zitadel/
• Size: 652 KB
• Stars: 48
• Watchers: 9
• Forks: 20
• Open Issues: 11
• Metadata Files:
  • Readme: README.md
  • License: LICENSE-APACHE

Awesome Lists containing this project

README

        
# ZITADEL for Rust   [![Crates.io](https://img.shields.io/crates/v/zitadel)](https://crates.io/crates/zitadel) [![docs.rs](https://img.shields.io/docsrs/zitadel)](https://docs.rs/zitadel/latest/zitadel/) ![Crates.io](https://img.shields.io/crates/dv/zitadel) ![Crates.io](https://img.shields.io/crates/l/zitadel)

This repository contains the gRPC service clients and helpers/credentials/other utilities

for [ZITADEL](https://github.com/zitadel/zitadel).

The following features are present:

- API clients for communication with the ZITADEL API (calling gRPC methods)

- Credentials support for the API clients (access token and service account interceptors)

- OIDC Introspection support for [rocket](https://rocket.rs)

- OIDC Introspection support for [axum](https://github.com/tokio-rs/axum)

### Example

There exist a few examples in the `examples` directory.

Go there to see the library in action, or head over to the

[documentation](https://docs.rs/zitadel/latest/zitadel/) to see the full API documentation.

### Development

After you clone the repository, you need ["just"](https://just.systems) to run

certain tasks. Generating the gRPC clients is done via `just generate-grpc` or `just`

(as it is configured to be the default action for just).

For the generation to complete successfully, you need to have ["buf"](https://buf.build)

and the required proto plugins installed.

Required tooling:

- [just](https://just.systems)

- [buf](https://buf.build)

- [protoc](https://grpc.io/docs/protoc-installation/)

- `protoc-gen-prost`: `cargo install protoc-gen-prost`

- `protoc-gen-tonic`: `cargo install protoc-gen-tonic`

- `protoc-gen-prost-crate`: `cargo install protoc-gen-prost-crate`

Installing the tools is also partially available via `just install-tools`.

#### License



Licensed under either of Apache License, Version

2.0 or MIT license at your option.

Unless you explicitly state otherwise, any contribution intentionally submitted

for inclusion in the package by you, as defined in the Apache-2.0 license, shall be

dual licensed as above, without any additional terms or conditions.