Node js: Test the QRS API

This article explains how to test the QRS API /qrs/license endpoint with node.js.

• This assumes that node.js is already installed on your machine. Just choose the latest stable version from https://nodejs.org/en/download/
• Modules used for this example are: fs, request. If they are not installed, run npm install fs and npm install request to install them. Modules are installed per project so make sure to be in the same folder where you have your .js files when running those commands.
• Certificates in pem format must be copied to the machine that is sending the request. On the Qlik Sense server (central node), there is by default a set of certificates ready to use in C:\ProgramData\Qlik\Sense\Repository\Exported Certificates\.Local Certificates.

In order to send the request, we will use the following code:
 

var fs          = require('fs');
var request = require('request');

//define certificate folder
var directory = "C:\\ProgramData\\Qlik\\Sense\\Repository\\Exported Certificates\\.Local Certificates\\";

//set up request options
var options = {
  uri: 'https://qlikserver1.domain.local:4242/qrs/license?xrfkey=1234567891234567',
  headers: {'content-type': 'application/json','X-Qlik-xrfkey': '1234567891234567','X-Qlik-user': 'UserDirectory=DOMAIN;UserId=Administrator'},
  method: 'GET',
json: true,
  ca: fs.readFileSync(directory+ "root.pem"),
  key: fs.readFileSync(directory+"client_key.pem"),
  cert: fs.readFileSync(directory+"client.pem"),
  rejectUnauthorized: false
};

//send request
request(options, function (error, response, body) {
        if(error) 
        {
            console.log('Error: '+error);
        } 
        else 
        {
            console.log(body);
        }
    });

Save this file as file1.js.

The UserId/UserDirectory in X-Qlik-User header must be a user that has RootAdmin privileges in the QMC.

In order to execute this code, we will run the command line:
It should return something like this if successful:

{ id: 'c1375bf8-59ac-4d24-a66c-6bacae5fcb11',
  createdDate: '2017-09-30T15:53:42.794Z',
  modifiedDate: '2017-11-01T12:25:07.728Z',
  modifiedByUserName: 'INTERNAL\\bootstrap',
  lef: '9999000000001069\r\nInternal Qlik License 2017;;;\r\nQlik Sense Enterpri
se;;;\r\nPRODUCTLEVEL;50;;2018-01-30\r\nTOKENS;100;;\r\nTIMELIMIT;;;2018-01-30\r
\nVWAH-B2GD-AH85-2BV5-ZT3D',
  serial: '9999000000001069',
  check: '2008976618',
  name: '9999000000001069',
  organization: '9999000000001069',
  product: 2,
  numberOfCores: -1,
  isExpired: false,
  expiredReason: '',
  isBlacklisted: false,
  isInvalid: false,
  privileges: null,
  schemaPath: 'License' }

Or an error if the request fails.