Managing security with section access
You can use section access in the data load script to manage row-level data access. In this way, a single file can be used to hold the data for users or user groups. Qlik Sense uses the information in the section access for row-level authorization, and dynamically reduces the data, so that users only see the data they have permission to see.
The security is built into the file itself, which means a downloaded file is also protected, to some extent. However, if security demands are high, downloading of files and offline use should be prevented. Files should be published by the Qlik Sense server only. As all data is kept in one file, the size of this file can potentially be very large.
The app must be published before section access controls will be applied. Reloading the app will not apply any new or changed section access scripts.
Sections in the script
Row-level access control is managed through one or several security tables loaded in the same way as data is normally loaded. This makes it possible to store these tables in a standard database or in a spreadsheet. The script statements managing the security tables are given within an authorization section, which in the script is initiated by the statement Section Access.
If an authorization section is defined in the script, the part of the script loading the app data must be put in a different section, initiated by the statement Section Application.
Example:
Section Access;
AuthorizationTable:
Load ACCESS, USERID, REGION From ... ;
Section Application;
Load ... From ... ;
Section access system fields
The access levels are assigned to users in one or several tables loaded within the section access. These tables can contain several different user-specific system fields, typically USERID, and the field defining the access level, ACCESS. All section access system fields will be used for authentication or authorization. The full set of section access system fields is described below.
ACCESS
Defines what access the corresponding user should have.
Access to Qlik Sense apps can be authorized for specified users or groups of users. In the security table, users can be assigned to the access levels ADMIN or USER. If no valid access level is assigned, the user cannot open the app.
A person with ADMIN privileges has access to all data in the app. A person with USER privileges can only access data as defined in the security table.
If section access is used in an on-demand app generation (ODAG) scenario in the template app, the INTERNAL\SA_API user must be included as ADMIN in the section access table. For example:
NTNAME
A field that should contain a string corresponding to a Windows NT Domain user name or group name. If a different authentication system is used, it should contain the name of an authenticated user.
Qlik Sense will fetch the logon information from the OS and compare it to the value in this field.
USERID
Contains a string corresponding to a Qlik Sense user name. Qlik Sense will get the login information from the proxy and compare it to the value in this field.
USER.EMAIL
Currently not supported, will in Qlik Sense only match on wildcard.
GROUP
Contains a string corresponding to a group in Qlik Sense. Qlik Sense will resolve the user supplied by the proxy against this group.
SERIAL
Contains a string corresponding to the platform. If the field contains the string ‘QLIKSENSE’ or a wild card ‘*’, access may be granted, depending on the other fields in the authorization table.
OMIT
Contains the name of the field that is to be omitted for this specific user. Wildcards may be used and the field may be empty. An easy way of doing this is to use a sub field.
Qlik Sense compares the user with UserID and resolve the user against groups in the table. If the user belongs to a group that is allowed access, or the user matches, they can access the app.
If you have locked yourself out of an app by setting section access, you can open the app without data, and edit the access section in the data load script. This requires that you have access to edit and reload the data load script.
For more information, see Opening an app without data.
As the same internal logic that is the hallmark of Qlik Sense is also used in the access section, the security fields can be put in different tables. All the fields listed in LOAD or SELECT statements in the section access must be written in uppercase. Convert any field name containing lowercase letters in the database to uppercase using the Upper function before reading the field by the LOAD or SELECT statement.
For more information, see Upper - script and chart function.
A wildcard, (*) is interpreted as all (listed) values of this field, that is, a value listed elsewhere in this table. If used in one of the system fields (USERID, GROUP) in a table loaded in the access section of the script, it is interpreted as all (also not listed) possible values of this field.
Example:
In this example, only users in the Finance group can open the document.
Access | Group |
---|---|
USER | Finance |
Dynamic data reduction
Qlik Sense supports dynamic data reduction, in which some of the data in an app can be hidden from a user, based on the section access login:
- Fields (columns) can be hidden by using the system field OMIT.
- Records (rows) can be hidden by linking the section access data with the real data: The selection of values to be shown or excluded is controlled by having one or more fields with common names in section access and section application. After user login, Qlik Sense matches the selections in fields in the section access to any fields in the section application with exactly the same field names (the field names must be written in uppercase). After the selections have been made, Qlik Sense will permanently hide all data excluded by these selections from the user.
Example: Data reduction based on user ID
The field REDUCTION (uppercase) now exists in both section access and section application (all field values are also uppercase). The two fields would normally be different and separated, but using section access, these fields are linked and the number of records displayed to the user is reduced.
The field OMIT, in section access, defines the fields that should be hidden from the user.
The result will be:
- User ADMIN can see all fields and only those records other users can see in this example when REDUCTION is 1, 2, or 3.
- User A can see all fields, but only those records associated to REDUCTION=1.
- User B can see all fields except NUM, and only those records associated to REDUCTION=2.
- User C can see all fields except ALPHA, and only those records associated to REDUCTION=3.
Example: Data reduction based on user groups
The result will be:
- Users belonging to the ADMIN group are allowed to see all data and all fields.
- Users belonging to the A group are allowed to see data associated to REDUCTION=1 across all fields.
- Users belonging to the B group are allowed to see data associated to REDUCTION=2, but not in the NUM field
- Users belonging to the C group are allowed to see data associated to REDUCTION=3, but not in the ALPHA field
- Users belonging to the GROUP1 group are allowed to see data associated to REDUCTION=3 across all fields
-
The user INTERNAL\SA_SCHEDULER does not to belong to any groups but is allowed to see all data in all fields.
Information noteThe wildcard, character *, in this row refers only to all values within the section access table. If there are values in the section application that are not available in the REDUCTION field in section access, they will be reduced.
Inherited access restrictions
A binary load will cause the access restrictions to be inherited by the new Qlik Sense app.