Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

Version 1 Current »

The IguanaX IguanaID can be found within your Iguana License Settings page. However, you can also programmatically obtain the Iguana ID using one of two methods:

Method 1: Use the iguana --id command line flag (requires IguanaX v10.1.102)

The Iguana ID can be obtained using the command line --id flag. If you need to target a unique working directory, you can optionally use --id --working_dir <working_directory> to point to a specific Iguana working directory and return the Iguana ID.

 Windows

Use the following command: 

iguana --id --working_dir "C:\ProgramData\IguanaX"
 Linux

Use the following command: 

./iguana --id

*optionally add the --working_dir flag to target specific Iguana

Method 2: Use the IguanaX API to get license details, including the Iguana ID

 STEP 1: Call GET /session/login to login and get a session cookie to authenticate IguanaX API requests.

Method: GET /session/login

To call the IguanaX APIs you must first login and get a session cookie from the response header to authenticate your subsequent requests.

Use your Iguana instance IP address and port: https://127.0.0.1:7654

Parameters:

  • username: Your IguanaX instance username string

  • password: Your IguanaX instance password string

Example curl command calling the /session/login API and parsing to retrieve Iguana session cookie the response header Set-Cookie to authenticate the next API call:

IguanaCookie=`curl -i -k -X GET "http://127.0.0.1:7654/session/login?username=<user>&password=<pass>" | grep -i 'Set-Cookie: ' | awk '{print $2}' | sed 's/;$//'`

Should look similar to: IguanaSession-jYQGeQWk97ylKuP8AmEiad=z7WR4Xwzk51hXMP2e3WeZa

Response Header:

Content-Length: 128
Set-Cookie: IguanaSession-jYQGeQWk97ylKuP8AmEiad=z7WR4Xwzk51hXMP2e3WeZa; path=/; HttpOnly; SameSite=Strict
 STEP 2: Call POST /license/get to get license details and parse response to capture the Iguana ID

Method: POST /license/get

This API method returns a JSON object containing the Iguana ID along with other license information. To authenticate, the obtained Cookie (from step 1) is provided in the header of the request.

Use your Iguana instance IP address and port: https://127.0.0.1:7654

Example curl command calling the /license/get API and parsing to retrieve the Iguana ID:

IguanaID=`curl -k --header "Cookie: $IguanaCookie" -X POST "http://127.0.0.1:7654/license/get

Response:

{
    "data": {
        "iguana_id": "THSWPRHMUXTT7MRR",
        "license": {
            "component_limit": 500,
            "expiry": "0",
            "license_status": "License ok",
            "message_rate_limit": 0,
            "search_limit": 365
        },
        "license_message": "To modify or extend your license, contact the iNTERFACEWARE Sales Office."
    },
    "success": true
}

  • No labels