Skip to main content
This article discusses integrating an IO coding lab externally on your website.

​
How to embed a coding lab from Fermion?

Before starting the embed process, you need two things:
  1. A school on Fermion
  2. Fermion API key

​
Getting lab ID

Go to Manage features from your instructor dashboard and enable Coding labs if you haven’t done that yet. Once done, open Coding lab from sidebar and create a new IO lab. Click on the Embed button to obtain the ID of that lab.

​
Generating JWT

On any page in which you wish to let the user attempt the lab, you need to embed an iframe as follows: 
<iframe
	width="1280"
	height="720"
	src="https://acme.fermion.app/embed/io-coding-lab?token=EMBED_TOKEN_HERE"
	title="Coding Lab"
	frameborder="0"
	allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope;
	picture-in-picture; web-share"
	referrerpolicy="strict-origin-when-cross-origin"
	allowfullscreen>
</iframe>
Here, the EMBED_URL needs to be securely generated on your backend as follows:
1

Start with the base embed URL

The embed URL will always contain the following base: https://acme.fermion.app/embed/io-coding-lab?token=TOKEN_HERE
2

Generate a JWT with required claims

Generate a JWT (JSON Web Token) containing the following claims. The JWT token must be signed with your Fermion API Key.
  • labId (String) – This is the unique identifier of the lab as mentioned above.
  • userId (String) – This is a string that you have stored in your database that can uniquely identify a given user. You have to ensure that you store this identifier properly in your database and reuse it every time a user tries to access any lab.
  • isReadOnly (Boolean, optional) – Set to true to render the embedded coding lab in a read-only mode. Defaults to false.
3

Append the JWT to get the final URL

Append this generated JWT token to the end of the base URL to get the final embed URL.
Example JavaScript code to generate EMBED_URL securely on your backend server: This example uses the jsonwebtoken package to generate a JWT Token. 
import jwt from 'jsonwebtoken'

const jwtToken = jwt.sign(
	{
		labId: '66a9202ab1458d00083ff520',
		userId: '<enter a user ID here unique to every user>',

		// change this to `true` to render the embedded coding lab in a read-only mode
		isReadOnly = false


	},
	'FERMION_API_KEY',
	{ expiresIn: '1h' }
)

const EMBED_URL =
	'https://example.fermion.app/embed/io-coding-lab?token=' +
	encodeURIComponent(jwtToken)

​
How can I access lab results?

​
Public API

We have an OpenAPI-spec compliant public API you can use, once you have access to FERMION_API_KEY. You can use this API to query multiple data points for your organization. Please check the API documentation here.

​
Have a doubt?

In case something doesn’t work right, or you have any doubt, please feel free to reach out to us at support@codedamn.com with your query, we’d be happy to resolve it at the earliest.