Troubleshooting Common Qlik NPrinting API Errors

Frank_S — Mon, 04 Nov 2024 14:42:05 GMT

This article aims to assist in troubleshooting Qlik NPrinting API errors.

If you recently upgraded Qlik Sense and are seeing REST connection failures and the error HTTP protocol error 403 (Forbidden): The server refused to fulfill the request, visit the following article: Qlik Sense June 2020 connecting to NPrinting getting "HTTP protocol error 403 (Forbidden): The server refused to fulfill the request."

Troubleshooting begins with verifying the System Requirements (QlikView and Qlik Sense):

A currently supported version of Qlik Sense in installed
A currently supported version NPrinting is installed
In the Qlik NPrinting Web Console under 'Admin' > 'Users', check the "domain account" field and ensure you have a windows domain user account mapped to Qlik NPrinting User user account for use with Qlik NPrinting API's.
In order to accept POST calls from the Qlik Sense Virtual Proxy or QV Access Point server, you MUST add the Qlik Sense Virtual Proxy Address and or QlikView Access point address to the NPrinting Web Console > Trusted Origins. See Adding a server as a trusted origin | Qlik Help
Inserted valid rest GET and POST connections into your load script. See How to create NPrinting GET and POST REST connections
Ensure the Qlik NPrinting User has a mapped domain account and is a member of an Qlik NPrinting security role which has the OnDemand Reports/Create permission enabled.
Use the Qlik NPrinting service user account to ensure it works as expected as it should already meet the criteria above.
Reference: User settings | Qlik Help

NOTE: You may use the NP APIs with the programming language or tool you prefer. See the following to diagnose non-Qlik Rest get and post connections: How to manage Qlik NPrinting users by using API

Common Errors and their Solutions:

Issue: Login Error - 401 unauthorized or 403 forbidden

You must use Windows NTLM authentication in any Rest Connector configuration for all REST connections used with NPrinting
Qlik NPrinting Windows Authentication MUST be enabled in the Qlik NPrinting Web Console Admin > Settings > Authentication"
Ensure domain user account is mapped to an Qlik NPrinting user account for use with Qlik NPrinting API's. This Qlik NPrinting account must also have the Qlik NPrinting 'Administrator' role assigned to it.
Check to ensure your Qlik NPrinting user account has not expired due to group policy or has been changed recently
Update the Rest Connector with the correct Windows NTLM NPrinting Domain user ID and Password, Test the connection and SAVE before loading the data in the data load editor.
Ensure "trusted origin" is added
Ensure the "Use current user credentials" checkbox is unchecked in the REST GET and POST connections

Issue: 403 Forbidden

Qlik Sense June 2020 connecting to NPrinting getting "HTTP protocol error 403 (Forbidden): The server refused to fulfill the request."

For solution check the link below:
Qlik Sense June 2020 connecting to NPrinting getting "HTTP protocol error 403 (Forbidden): The server refused to fulfill the request."
Rest Connection need to be configured accurately:
- How to create NPrinting GET and POST REST connections
- Ensure that you do NOT enable the use current user credentials check box in GET/POST connections. See below:
If seeing "403" forbidden error used in web browser calls, see NPrinting API Browser Error code 403 User has no rights to access the resource

Issue: API POST 405 method not supported (allowed)

Check to ensure that the Task ID is valid or that you have at least one Publish Task enabled for the Qlik NPrinting App that you are trying to run
Check to ensure that the Qlik Sense server and or the QlikView server is added as a Trusted Origin in Qlik NPrinting On Demand Settings
Open your REST (POST) connection and type the Windows NTLM user ID and password with this format: domain\administrator. NOTE: This user must be mapped into and NPrinting user account that has the NPrinting 'Administrator' role assigned to it.
Update the Rest Connector with the correct Windows NTLM NPrinting Domain user ID and Password, Test the connection and SAVE before loading the data in the data load editor.

Issue: Unable to edit users.

Error:QVX_UNEXPECTED_END_OF_DATA: HTTP protocol error 400 (Bad Request): {"error":{"code":400,"message":"Request is malformed."}}

Solution: NPrinting API can create a New user via API but unable to update existing users