License

This page describes how to update and manage you license in Lenses.

To run Lenses you need to have a valid license key. The license is a JSON file that you provide to the Lenses at the startup. When valid, you are good to go. You can update the license key at the runtime.

Expiration

30 days before the expiration of your license key, an amber notification will appear in Lenses.

After expiration, you have a 5-day graceful period to run Lenses.

Update a license

You can update the license from the UI. Navigate to Admin and License and paste the content of the license file:

Update via the CLI / API

License management is also supported by the CLI to enable automation scenarios.

View license info

lenses-cli license get

Update the license of a Lenses instance at runtime

lenses-cli license update --file <license.json>

Returns the Lenses license details

GET/api/v1/license

Response

200400401402403404500

Body

application/json

maxBrokersinteger

expiryinteger (int64)

clientIdstring

isRespected*boolean

status*LicenseStatusSummary (enum)

ValidExpiredBrokersExceededNoLicense

messagestring

settingsLicenseSettings (object)

currentTime*integer (int64)

Request

JavaScriptCurlPython

const response = await fetch('/api/v1/license', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200400401402403404500

{
  "clientId": "text",
  "isRespected": false,
  "status": "Valid",
  "message": "text",
  "settings": {
    "security": {
      "root": {
        "enabled": false
      },
      "basic": {
        "enabled": false
      },
      "ldap": {
        "enabled": false
      },
      "kerberos": {
        "enabled": false
      },
      "custom": {
        "enabled": false
      },
      "sso": {
        "enabled": false
      },
      "serviceAccount": {
        "enabled": false
      },
      "groups": {
        "enabled": false
      },
      "maxUsers": {}
    },
    "sql": {
      "streaming": {
        "enabled": false
      },
      "sql": {
        "enabled": false
      }
    },
    "kafkaSettings": {
      "acls": false,
      "quotas": false,
      "consumerOffsetManagement": false
    },
    "audit": {
      "enabled": false,
      "integration": false
    },
    "connections": {
      "enabled": false
    },
    "application": {
      "topology": false,
      "connectorsOnKubernetes": false
    },
    "approval": {
      "enabled": false
    },
    "alerts": {
      "enabled": false,
      "integration": {
        "enabled": false,
        "channels": [
          "text"
        ]
      }
    },
    "data": {
      "masking": false,
      "customSerde": false,
      "sla": false,
      "namespace": {
        "enabled": false
      }
    },
    "backup": {
      "enabled": false
    }
  }
}

Updates the license information

PUT/api/v1/license

Body

application/json

source*string

clientId*string

details*string

key*string

Response

200400401402403404500

Body

application/json

maxBrokersinteger

expiryinteger (int64)

clientIdstring

isRespected*boolean

status*LicenseStatusSummary (enum)

ValidExpiredBrokersExceededNoLicense

messagestring

settingsLicenseSettings (object)

currentTime*integer (int64)

Request

JavaScriptCurlPython

const response = await fetch('/api/v1/license', {
    method: 'PUT',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "source": "text",
      "clientId": "text",
      "details": "text",
      "key": "text"
    }),
});
const data = await response.json();

Response

200400401402403404500

{
  "clientId": "text",
  "isRespected": false,
  "status": "Valid",
  "message": "text",
  "settings": {
    "security": {
      "root": {
        "enabled": false
      },
      "basic": {
        "enabled": false
      },
      "ldap": {
        "enabled": false
      },
      "kerberos": {
        "enabled": false
      },
      "custom": {
        "enabled": false
      },
      "sso": {
        "enabled": false
      },
      "serviceAccount": {
        "enabled": false
      },
      "groups": {
        "enabled": false
      },
      "maxUsers": {}
    },
    "sql": {
      "streaming": {
        "enabled": false
      },
      "sql": {
        "enabled": false
      }
    },
    "kafkaSettings": {
      "acls": false,
      "quotas": false,
      "consumerOffsetManagement": false
    },
    "audit": {
      "enabled": false,
      "integration": false
    },
    "connections": {
      "enabled": false
    },
    "application": {
      "topology": false,
      "connectorsOnKubernetes": false
    },
    "approval": {
      "enabled": false
    },
    "alerts": {
      "enabled": false,
      "integration": {
        "enabled": false,
        "channels": [
          "text"
        ]
      }
    },
    "data": {
      "masking": false,
      "customSerde": false,
      "sla": false,
      "namespace": {
        "enabled": false
      }
    },
    "backup": {
      "enabled": false
    }
  }
}

Where do I get my license key?

If you are a customer, your license key is available in the customer portal. Contact your account representative for the details.