This repository contains the gRPC service clients and helpers/credentials/other utilities for 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
• OIDC Introspection support for axum

There exist a few examples in the examples directory. Go there to see the library in action, or head over to the documentation to see the full API documentation.

After you clone the repository, you need "just" 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" and the required proto plugins installed.

Required tooling:

• just
• buf
• protoc
• 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.