License rule audit: Preview audit rules

LOCKED.
This API is extremely reliable and will not be broken unless absolutely necessary.

Method

POST

Path

/qrs/systemrule/license/audit/preview

Description

Get a preview of the effect of a license rule based on resource type, a selection of users, and a selection of resources before the rule is added in Qlik Sense.

Body

AuditPreviewParameters: { "resourceType": "App" // or any type at all, "ResourceFilter": "resource filter [string]", "UserFilter": "user filter [string]", "EnvironmentAttributes": "type1=value1;type2=value2", "RuleConditions": a rule, "Actions": what the user is allowed to do "userSkip": "count [integer]", "userTake": "count [integer]", "resourceSkip": "count [integer]", "resourceTake": "count [integer]" }

The environmentAttributes type is one (or several, separated by “;”) of the following:

  • OS
  • Device
  • Browser
  • RequestType
  • IP

Return value

The audit results for all objects are returned, not just for the objects that the auditor has access to. For each object, the name and GUID are returned.

AuditPreviewResult:

{ "users": { "[GUID]": { // A user object "userId": "…", "userDirectory": "…", "name": "…", … }, "[GUID]": { … } }, "resources": { "[GUID]": { // An object of arbitrary type "…", }, "[GUID]": { … } }, "rules": { "[GUID]": { // Security rule object "type": "…", "name": "…", "rule": "…", "resourceFilter": "…", … }, "[GUID]": { … } }, "ruleApplication": [ { "userID": "[GUID]", "resourceID": "[GUID]", "ruleID": "[GUID]", "allowed": boolean, "errorAt": integer, "errorMessage": "…", "evaluationState": "evaluated/parsefailure/evaluationfailure" }, { … } ] }

Optional parameters

-

Did this information help you?

Can you tell us why it did not help you and how we can improve it?

Thanks for helping us improve!