API Settings

API Settings

The API settings tab allows the user to generate, regenerate or disable the following API related settings:-

  1. Auth Token

  2. Private Salt

  3. IP whitelisting

How to reach

  1. Click on Account on your homepage 

  2. Click on Settings to land on the API settings page

Enabling APIs for an Account

By default, APIs are deactivated for every account and have to be manually activated.

To activate/generate API credentials - press the “Enable API” button

This will generate the following 2 API credentials:-

  1. Auth Token

  2. Private Salt

Auth Token

Auth token is the unique identifier that lets Leegality validate the API calls. The Auth Token needs to be passed in the X-Auth-Token header parameter while making API calls (refer to API documentation).

The user can copy the Auth Token to their clipboard by pressing the “Copy” icon.

Note: Auth tokens are account-specific and each Leegality account has its own unique Auth Token.

Auth Tokens can be regenerated in 2 ways:-

  1. Press the “Regenerate button next to the Auth Token field.

    Note: Regenerating an Auth Token does not regenerate the Private Salt for that account.

  1. In case API is disabled and enabled again.

Private Salt

Private salt can be used to verify the webhook calls made by Leegality.

To verify the webhook calls made by Leegality using Private Salt, refer to the ‘mac’ parameter in our webhook documentation.

Private Salt can only be regenerated by disabling and enabling the API.

The user can copy the Auth Token to their clipboard by pressing the “Copy” icon.

Whitelist IPs

The user can enable IP whitelisting which will restrict IP addresses that can make API calls to Leegality.

Note: You can add 10 IPs to this list.

To add an IP follow these steps:-

  1. Toggle on “Whitelist IPs”

  2. Enter a valid IPv4 address and press the “Add+” button.

    Note: The IP address needs to be input in x.x.x.x format - where the value of x  can range from 0-255.

In order to delete an IP address - Click on the cross icon next to an existing IP

In case IP whitelisting is disabled, all the saved IP addresses will be lost.

Disable API

In order to disable the API access for an account - simply click on the “Disable API” button and the associated token and salt will be deleted by Leegality.  

    • Related Articles

    • Document Settings

      Use the Documents Tab to set document related configurations for your Leegality account, to avoid manually configuring the settings for each document sent from/received in your account. From the Documents Tab, you can set the following configurations ...
    • Signature Certificate Verification Settings

      Signature certificate verification parameters differ depending on the type of digital signature that has been selected that has to be matched with the signer's digital signature certificate while signing the document. Verification parameter ...
    • Stamp Settings

      This tab allows you to manage department-wide stamping settings. Activate StampingThis button allows you to choose whether the Stamping feature will be available for documents sent from your Department. This is essential to use the Stamp Papers ...
    • eSignature Settings

      This tab (see screenshot below) allows you to control the permitted e-Sign sent by your Department. For instance, if Aadhaar eSign has been toggled off then this signature will not be an option for signatories in the drop-down menu in the signature ...
    • Setting up Document Signer Certificate

      Certificates are designed for the automatic signing and authentication of documents to authenticate documents/information attributed to the organization by using a server-based Digital Signature. Leegality enables the use of these to automate the ...