Skip to main content

Authentication

Accessing Level 2 Broker APIs requires JWT Authentication:

  • Brokers must generate a JSON Web Token (JWT) for authentication.
  • The JWT must include a "token_expiry" parameter, specifying the token's validity duration.
  • Recommended Token Expiry: 180 minutes (3 hours).
  • Automatic Token Expiration: Tokens exceeding 180 minutes of validity will be automatically invalidated by the system.
  • Upon automatic expiration, a new JWT with a 180-minute "token_expiry" must be generated.
    from datetime import datetime
    import jwt
    token_expiry = datetime.now(timezone.utc) + timedelta(minutes=180)
    user_data = {"domain": "to be shared separately", "token_expiry": token_expiry.timestamp()}
    token_string = jwt.encode(
        user_data, "secret token to be shared separately", algorithm="HS256")

    print(token_string)
    # this is the token you will need to authenticate

Here is a sample JWT token

eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJkb21haW4iOiJhbnRvc3RyYXRlZ3kudHJ5bGV2ZWwyLmNvbSIsInRva2VuX2V4cGlyeSI6MTc0MzE2OTkyMi43MzIzNzR9.LOTUbmvDgGiMqV_hcWM9BJguJkFABRNZu6vlObKmedo