@primerouting/zitadel-node

ZITADEL Node.js

This is the ZITADEL Node.js SDK.

This library contains the compiled and generated gRPC service clients for the ZITADEL API.
This is a fork of zitadel-node and add the feature to request self-hosted zitadel instance by using http2.

Also it contains helpers to create the service clients to access the API. With two MetadataProvider (accessTokenProvider and serviceAccountProvider), the clients can be created with the correct authentication already in place.

Head over to the examples to see implementation examples.

This library allows you to use the ZITADEL API in Node.js, it is not compatible with the browser since it requires gRPC (and not gRPC-Web). Furthermore, the library heavily relies on openidconnect and crypto implementations since it handles RSA keys.

This library does not provide authentication helpers for web applications. If you want to use passport js and OAuth 2.0 introspection, head over to node-passport-zitadel.

Development

To enhance this library or to fix a bug, you need to do the following:

1. Clone the repository
2. Install the dependencies with npm install
3. Install the submodules with git submodule update --init --recursive
4. Generate the gRPC types with npm run build:grpc

Then you can start developing with npm run dev. The production build can be made with npm run build and the tests run with npm test.