Module : jwt
Module Overview
This module provides a inbound and outbound JWT authentication provider, which can be used to authenticate using a JWT and the functionality related to issuing and validating JWT.
Inbound JWT Auth Provider
The jwt:InboundJwtAuthProvider is another implementation of the auth:InboundAuthProvider interface, which authenticates by validating a JWT.
jwt:InboundJwtAuthProvider jwtAuthProvider = new({
issuer: "example",
audience: "ballerina",
trustStoreConfig: {
certificateAlias: "ballerina",
trustStore: {
path: "${ballerina.home}/bre/security/ballerinaTruststore.p12",
password: "ballerina"
}
}
});
Outbound JWT Auth Provider
The jwt:OutboundJwtAuthProvider is another implementation of the auth:OutboundAuthProvider interface, which used to authenticate with external endpoint by generating a JWT.
jwt:OutboundJwtAuthProvider jwtAuthProvider = new({
issuer: "example",
audience: ["ballerina"],
keyStoreConfig: {
keyAlias: "ballerina",
keyPassword: "ballerina",
keyStore: {
path: "${ballerina.home}/bre/security/ballerinaKeystore.p12",
password: "ballerina"
}
}
});
Samples
Issuing a JWT
import ballerina/crypto;
import ballerina/jwt;
import ballerina/time;
public function main() {
crypto:KeyStore keyStore = {
path: "${ballerina.home}/bre/security/ballerinaKeystore.p12",
password: "ballerina"
};
jwt:JwtKeyStoreConfig config = {
keyStore: keyStore,
keyAlias: "ballerina",
keyPassword: "ballerina"
};
jwt:JwtHeader header = {};
header.alg = jwt:RS256;
header.typ = "JWT";
jwt:JwtPayload payload = {};
payload.sub = "John";
payload.iss = "wso2";
payload.jti = "100078234ba23";
payload.aud = ["ballerina", "ballerinaSamples"];
payload.exp = time:currentTime().time/1000 + 600;
string|error jwt = jwt:issueJwt(header, payload, config);
}
Validating a JWT
import ballerina/crypto;
import ballerina/jwt;
public function main() {
crypto:TrustStore trustStore = {
path: "${ballerina.home}/bre/security/ballerinaTruststore.p12",
password: "ballerina"
};
jwt:JwtValidatorConfig config = {
issuer: "wso2",
audience: "ballerina",
clockSkewInSeconds: 60,
trustStoreConfig: {
certificateAlias: "ballerina",
trustStore: trustStore
}
};
jwt:JwtPayload|error result = jwt:validateJwt(jwtToken, config);
}
| CachedJwt | Represents parsed and cached JWT. |
| Detail | Record type to hold the details of an error. |
| JwtHeader | Represents JWT header. |
| JwtIssuerConfig | Represents JWT validator configurations. |
| JwtKeyStoreConfig | Represents JWT key store configurations. |
| JwtPayload | Represents JWT payload. |
| JwtTrustStoreConfig | Represents JWT trust store configurations. |
| JwtValidatorConfig | Represents JWT validator configurations. |
| InboundJwtAuthProvider | Represents inbound JWT auth provider. |
| OutboundJwtAuthProvider | Represents outbound JWT authenticator. |
| buildHeaderString | Build the header string from the |
| buildPayloadString | Build the payload string from the |
| decodeJwt | Decode the given JWT string. |
| issueJwt | Issue a JWT token based on provided header and payload. JWT will be signed (JWS) if |
| validateJwt | Validate the given JWT string. |
| RS256 | The |
| RS384 | The |
| RS512 | The |
| NONE | Unsecured JWTs (no signing) |
| JWT_ERROR |
| JwtSigningAlgorithm | The key algorithms supported by crypto module. |
| Error |