A collection of extra HTTP headers to include in the JWT header.

Data Type

string

Default Value

""

Remarks

The string should not contain any single quotes or double quotes.

The : character is a delimiter separating headers and their values, and the | character is a delimiter separating the header name-value pairs. End the list of headers with a semicolon. For example:

JWTHeaders = kid : key_1 | Custom Header 1 : value;

If you need to use more complex values such as JSON objects or arrays, they must be base64 encoded. For example:

JWTHeaders = kid : key_1 | my : eyJjdXN0b20iOlsianNvbiIsIm9iamVjdCJdfQ==;

By default, not all headers in the JWT are validated by Apache CouchDB (only alg). See the documentation of required_claims for information about enforcing the validation of additional headers.