License rule audit: Get audit rules

Method

POST

Path

/qrs/systemrule/license/audit

Description

Perform an audit of the license control system. The results of the audit include:

• Information on all license rules
• Descriptions of the access provided by each license rule
• If there are any errors when evaluating the rules

Body

AuditParameters:

{
   "resourceType": "type [string]",
   "resourceFilter": "resource filter [string]",
   "userFilter": "user filter [string]",
   "environmentAttributes": "type1=value1;type2=value2 [string]" 
   "userSkip": "count [integer]",
   "userTake": "count [integer]",
   "resourceSkip": "count [integer]",
   "resourceTake": "count [integer]"
   "includeNonGrantingRules": "type [bool]",
}

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

• OS
• Device
• Browser
• RequestType
• IP

Return value

AuditResult:

{
   "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

-