Another Proud Son of JSON

Using JSON Web Token to send data

Blog Another Proud Son of JSON

| 2 min read

Contact us

Today everything is connected, and thus, everything is communicated. Security has become a major issue in the complex world of web applications and their communications.

jwt

JSON Web Token (JWT).

JSON Web Token

A JSON Web Token (JWT) is a URL safe way to represent a set of information between two parties. The information shared between the parties can be referred to as claims. It is a safe way to transfer information because it can be signed using a secret or using a public or private key. The token is a base64 encoded string which due to its short length is meant for space constrained environments.

There are two basic scenarios in which the use of a JWT is recommended.

  • Once a user is authenticated in an application and wishes to make subsequent requests, each one of those request should include a JWT to make sure that the user has access to certain routes, services or resources.

  • To exchange information in a secure manner making use of the signature. The signature is calculated based on the body and the payload of the JWT which allows a party to know if the message has been tampered with (Auth0, 2015).

jwt-structure

JWT structure example - JWT.

The JWT is made up of three parts that are separated by a single dot. Remember all the values are base64 encoded (header.payload.signature).

Get started with Fluid Attacks' Security Testing solution right now

  1. Header:

    1. Algorithm: This refers to the algorithm used to sign the token. Usually HMAC SHA256 or RSA.

    2. Type: Refers to the type of token. In this case "JWT".

  2. Payload: Contains claims (names are only 3 characters long), which are statements about the user/entity and any additional metadata. Types of claims:

    • Reserved: Predefined but not mandatory.

    • Public: Defined by the user. Should be defined in a collision resistant namespace.

    • Private: Custom created to share information between parties.

  3. Signature: This is made by taking the encoded header, payload and secret/key and using the algorithm specified in the header to sign it.

How it works

jwt-flow

JWT flow. Source: Stecky (2016).

As we can see in the image above, we have three entities. The user, the authentication server and the application server. Here we have four steps.

  1. Initial authentication: The user first signs in to the authentication server. If we are talking about a company this could be the active directory.

  2. JWT generation: The JWT is created by the authentication server and sent to the user to be used in further request.

  3. User request: The user then makes an API call. In a company this could be a query made in the company's billing system. The JWT is added to the original request and sent to the application server.

  4. JWT verification: The application server, billing system in our example, makes sure the call is coming from an authenticated user by checking the JWT and then returns a response to the user.

JWT Security

Remember the data in the JWT is encoded and signed but not encrypted. The data is encoded to transform the data structure and allow transportation following a standard definition. The data is signed to verify authenticity which lets me know if a message has been tampered with but it does not prevent it.

Here is a great article on how to Use JWT The Right Way!

Other alternatives like SAML (Security Assertion Mark-up Language) imply larger XML documents. JWTs are great when we have space constrained environments and are looking to guarantee the authenticity of the data being transported.

References

Subscribe to our blog

Sign up for Fluid Attacks' weekly newsletter.

Recommended blog posts

You might be interested in the following related posts.

Photo by Jasmin Egger on Unsplash

If the essential security layer is flawed, you're toast

Photo by Christian Wiediger on Unsplash

The need to enhance security within the fintech sector

Photo by Claudio Schwarz on Unsplash

Is your financial service as secure as you think?

Photo by mitchell kavan on Unsplash

Bringing the zero trust model to life

Photo by Brian Kelly on Unsplash

We need you, but we can't give you any money

Photo by Sean Pollock on Unsplash

Data breaches that left their mark on time

Photo by Roy Muz on Unsplash

Lessons learned from black swans

Start your 21-day free trial

Discover the benefits of our Continuous Hacking solution, which hundreds of organizations are already enjoying.

Start your 21-day free trial
Fluid Logo Footer

Hacking software for over 20 years

Fluid Attacks tests applications and other systems, covering all software development stages. Our team assists clients in quickly identifying and managing vulnerabilities to reduce the risk of incidents and deploy secure technology.

Copyright © 0 Fluid Attacks. We hack your software. All rights reserved.