Builder
Last updated
Last updated
(builder)
The JWT Builder
facilitates the creation of JSON Web Tokens by providing methods for setting headers, adding payload claims, and signing the token with a specified algorithm. Its chaining capabilities enable streamlined construction of tokens for secure communication.
Headers can be added using the header(key, value)
method, specifying header names and values. Payloads, including claims, can be defined with payload(payload)
or extended using withClaim(key, value)
. For specifying token expiration, the withExpires(expire)
method adds an "exp" claim. The sign(alg)
method finalizes the token by signing it with the chosen algorithm, automatically including the algorithm ("alg") in the header.
Type | Name | Summary |
---|---|---|
Adds a header to the JWT token.
Parameters
Returns: Builder the jwt builder for method chaining
Adds the payload (claims) to the web token.
Parameters
Object payload a json containing the data, e.g. {'some': 'data', 'somemore': 'data2'}
Returns: Builder the jwt builder for method chaining
Sign the token with the given algorithm. The 'alg' claim is automatically added to the token header.
Parameters
Algorithm alg the algorithm used to sign the token.
Returns: String a string representing the constructed JSON Web Token.
Adds data to the payload, which contains the claims. Claims are statements about an entity (typically, the user) and additional data.
Parameters
String key a string representing the claim name (e.g. 'iss' which stands for issuer; 'email', 'name', etc.)
Object value can be a string, a boolean, a date, a number or an array
Returns: Builder the jwt builder for method chaining
Add a specific Expires At ("exp") claim to the Payload.
Parameters
Date expire a date representing the expiration time of the token
Returns: Builder the jwt builder for method chaining