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
.