What is JSON Web Token and when its needed?
It is a self-contained way for securely transmitting information between parties as a JSON object. This information can be verified and trusted because it is digitally signed and encrypted to also provide secrecy between parties (Signed Tokens - Integrity and Encrypted Tokens - Hide).
JWT needs for:
In its compact form, JSON Web Tokens consist of three parts separated by dots (
Header
The header typically consists of two parts: the type of the token, which is JWT, and the hashing algorithm being used, such as HMAC SHA256 or RSA.
Then, this JSON is Base64Url encoded to form the first part of the JWT.
Payload
The second part of the token is the payload, which contains the claims. Claims are statements about an entity (typically, the user) and additional data. There are three types of claims: registered, public, and private claims.
Signature
To create the signature part you have to take the encoded header, the encoded payload, a secret, the algorithm specified in the header, and sign that.
Why we need signature?
The signature is used to verify the message wasn't changed along the way, and, in the case of tokens signed with a private key, it can also verify that the sender of the JWT is who it says it is.
JWT signature creation and varification flows:
It is a self-contained way for securely transmitting information between parties as a JSON object. This information can be verified and trusted because it is digitally signed and encrypted to also provide secrecy between parties (Signed Tokens - Integrity and Encrypted Tokens - Hide).
JWT needs for:
- Authentication - Once the user is logged in, each subsequent request will include the JWT, allowing the user to access routes, services, and resources that are permitted with that token.
- Information Exchange - Using public/private key pairs—you can be sure the senders are who they say they are. Additionally, as the signature is calculated using the header and the payload, you can also verify that the content hasn't been tampered with.
In its compact form, JSON Web Tokens consist of three parts separated by dots (
.
), which are:- Header
- Payload
- Signature
Header
The header typically consists of two parts: the type of the token, which is JWT, and the hashing algorithm being used, such as HMAC SHA256 or RSA.
Then, this JSON is Base64Url encoded to form the first part of the JWT.
Payload
The second part of the token is the payload, which contains the claims. Claims are statements about an entity (typically, the user) and additional data. There are three types of claims: registered, public, and private claims.
Signature
To create the signature part you have to take the encoded header, the encoded payload, a secret, the algorithm specified in the header, and sign that.
Why we need signature?
The signature is used to verify the message wasn't changed along the way, and, in the case of tokens signed with a private key, it can also verify that the sender of the JWT is who it says it is.
JWT signature creation and varification flows:
How to verify the signature in programmatic way.
Here, I have wrote a button click function which call the rest function ('/verify').
@RequestMapping("/verify")
public RedirectView verify() {
AppRestVerifier app = new AppRestVerifier();
if(app.validateJWTSignature(this.id_token))
this.msgVerify = "JWT Verified";
else
this.msgVerify = "JWT Verification Failed";
return viewHomePage();
}
I have created a Java class AppRestVerifier to validate the signature. In-order to validate we need to have the certificate of the created application (OIDC_App). Auth0 automatically generate the certificate for the registering application.
So, we can download that certificate and convert it to '.jks' file formate which can be used inside the program.
public boolean validateJWTSignature(String jwt)
{
try{
RSAPublicKey publicKey = null;
String keyfile = "oidcapp.jks";
String storepass = "abc123";
String alias = "oidc";
InputStream file = this.getClass().getClassLoader().getResourceAsStream(keyfile);
KeyStore keystore = KeyStore.getInstance(KeyStore.getDefaultType());
keystore.load(file, storepass.toCharArray());
// Get certificate of public key
Certificate cert = keystore.getCertificate(alias);
// Get public key
publicKey = (RSAPublicKey) cert.getPublicKey();
// Received JWT
String signedJWTAsString = jwt;
SignedJWT signedJWT = SignedJWT.parse(signedJWTAsString);
JWSVerifier verifier = new RSASSAVerifier(publicKey);
return signedJWT.verify(verifier);
}
catch(Exception ex){
System.out.println(ex);
}
return false;
}
The output we can get in this way is, whether the signature is valid or not.
Comments
Post a Comment