Authentication Setup

The Lirium API uses JWT (JSON Web Token) authentication with RSA key pairs. You must generate an asymmetric RSA private/public key pair and provide Lirium with the public key.

Generate RSA Key Pair

Run the following commands to generate a 4096-bit RSA key pair:

openssl genrsa -out private.pem 4096
openssl rsa -in private.pem -outform PEM -pubout -out public.pem

This creates two files:

• private.pem - Your private key (keep this secure and never share it)
• public.pem - Your public key (send this to Lirium)

Obtain Your API Key

Send the contents of public.pem to Lirium. In return, you will receive an API Key that identifies your integration when making API requests.

Security Best Practices

• Never share your private key - It should remain on your servers only
• Rotate keys periodically - Contact Lirium to update your public key
• Store keys securely - Use environment variables or a secrets manager
• Use separate keys for sandbox and production environments

Next Steps

Once you have your API Key, proceed to JWT Generation to learn how to create signed tokens for API requests.