How to create authentication token

[r-brown]

Vendor request

How do we get auth token which we need to pass as Authorization header while making API calls?

[r-brown]

API Key Identification is the recommended option which is offering secure and controlled communication with the NetLicensing API / services.
This is especially important if connection details (such as Auth header) are available to the end-customer (think of JavaScript or PHP).

API key can be obtained via:

NetLicensing Management Console

Open "Settings -> API Access" panel in the NetLicensing Management Console and create a new API Key by clicking on "Add API Key" button.

API token service

Use TokenServices.create() endpoint to create a new API Key:

Example

POST https://go.netlicensing.io/core/v2/rest/token
tokenType=APIKEY&apiKeyRole=ROLE_APIKEY_LICENSEE
Accept: application/xml
Content-Type: application/x-www-form-urlencoded

[r-brown]

Access to the REST services with an API key is the same as with Basic authentication, except that username is fixed to the value “apiKey" (without quotation marks) and the actual API key should be provided in the password field.

Auth Method: Basic
Username: apiKey
Password: <CREATED_API_KEY>

cURL example
> curl -X POST --header 'Content-Type: application/x-www-form-urlencoded' --header 'Accept: application/xml' --user apiKey:12c56f87-e200-4542-8954-06f0fce50507 'https://go.netlicensing.io/core/v2/rest/licensee/123/validate'

> curl -X POST --header 'Content-Type: application/x-www-form-urlencoded' --header 'Authorization: Basic YXBpS2V5OjEyYzU2Zjg3LWUyMDAtNDU0Mi04OTU0LTA2ZjBmY2U1MDUwNw== 'https://go.netlicensing.io/core/v2/rest/licensee/123/validate'