JWT extension

This extension implements native JWT authentication for the Grafbase Gateway.

Add the following to your Grafbase Gateway configuration file:

[extensions.jwt]
version = "0.2"

Then run grafbase extension install. The extension will be installed in the grafbase_extensions directory. That directory must be present when the gateway is started.

Build this extension manually and copy the artifacts to a location where the gateway can find them.

grafbase extension build

The build directory contains the resulting wasm component and manifest file.

build/
├── extension.wasm
└── manifest.json

In your gateway configuration, you can now load the extension from the build directory.

[extensions.jwt]
path = "/path/to/build"

This extension acts as an authentication provider for the Grafbase Gateway. After adding it to the extensions section, configure it as an authentication provider.

[[authentication.providers]]

[authentication.providers.extension]
extension = "jwt"

[authentication.providers.extension.config]
url = "https://example.com/.well-known/jwks.json"
issuer = "example.com"
audience = "my-project"
poll_interval = 60
header_name = "Authorization"
header_value_prefix = "Bearer "

Compile the CLI and gateway binaries first in the workspace root:

cargo build -p grafbase -p grafbase-gateway

Start the needed docker services in the extensions directory:

docker compose up -d

Run the tests in this directory:

cargo test