This article provides additional information and guidance about the System Configuration page in Sisense.
Information is up-to-date as of Sisense 8.0. For official documentation about the page, please see this documentation: System Configuration
This article primarily focuses on the configuration page within the Admin tab of Sisense web. There are additional settings stored within the Configuration Manager starting on Sisense 7.2. These settings are described in this article: Configuration Manager
Accessing the Page
The System Configuration page is visible to Sys. Admin and Admin users in the Sisense web application. It can be accessed by clicking Admin in the top bar, then Settings (under System Configuration).
Screenshot of access path:
Close-up of available settings:
This section walks through each field in System Configuration, with information about each field.
When you send emails in Sisense (such as new user activation, dashboard reports, Pulse alert etc.), the emails contain links back to your Sisense instance.
Email screenshot with URL highlighted:
The Alias field defines what to use to as the host in this URL. If the field is blank, Sisense will use the private IP address for the server. If you want to use something different (for example, the server's public IP address or domain name), enter it here. Do not include the protocol (http vs. https). The protocol is set in the SSL property below.
Sisense will automatically append the port number if it is something outside of 80 on http or 443 on https. Where the port setting lives depends on which version of Sisense your environment is one.
Sisense Version 7.2 and above:
You must designate the port in the alias if it is not port 80 (no SSL) or port 443 (SSL).
Sisense Version 7.1 and below:
The port number is taken from the C:\Program Files\Sisense\PrismWeb\vnext\config\default.yaml webServer->iisPort property, which is itself set in the Customize Installation screen on installation. Only include the port number if you need to deliberately use something different (for example, in the load balancer example below) or if you are running Sisense over https on a port besides 443.
If you are unsure of what to use, review the URL you're using to access Sisense outside the server in your web browser's address bar.
For customers using a high-availability configuration with a load balancer, enter the IP address/host name for the load balancer, so that users accessing Sisense from an email are routed through the load balancer rather than straight to the web node that issued the email.
Assume a Sisense instance bound to port 8081 with the private IP address 192.168.0.1, the public IP address 22.214.171.124, and a host name example.com associated to that public IP address.
First Day of Week
This property defines the weekday used to start the week in week-level queries.
By default, the first day of the week is Monday when querying an ElastiCube. Sisense defines Monday as the first day according to ISO 8601. This means that when selecting filters such as Week 1, Week 2, etc., the first day of the week is not that defined by first day of that year, but rather the first Monday of the year. Each week starts on a Monday and ends on a Sunday for 52-53 full weeks in a year.
More information about Sisense's method of calculating weeks is available in the official documentation. Valid values are Monday-Sunday.
This property may be set via the REST API on the api/v1/settings/system endpoint. Take care to POST only valid values; other values (such as 'string') will cause week-level web queries to fail.
This defines the language used in the web application by default. When creating users, administrators can optionally set the default language per user. The default language selected here will be used in the absence of user-level language preferences. For more information about Sisense's support for language localization, please see Internationalization and Localization.
This is a toggle for turning off and on emails across the entire environment. Emails are sent by default in scenarios such as when a new user is added, a user is shared with a dashboard, or a Pulse alert is fired. For a complete list of emails, see here: Rebranding Sisense Automated Emails
Toggling this property off suppresses these emails from Sisense entirely. For guidance on disabling only select emails, please see How To Disable Emails From Sisense.
Toggle to remove the Pulse page from the top menu bar and the Pulse Notification Feed. This option hides the Pulse page from all users in your system and stops sending Pulse notifications.
Toggle to enable/disable the dashboard administration feature. Administrators and the Sys Admin have access to the "All Dashboards" button which allows them to search for and access any dashboard in the environment.
Turn this feature off if you do not want Administrators to have access to all of the dashboards of every user in the system in the Analytics page.
Some Sisense customers use a feature that provides written-language descriptions of widgets' data. This property determines whether the feature is on and what token to use for it. More information about this feature is here: Sisense Narratives. Please note this feature needs to be enabled in the customer's license by the Customer Success Manager.
Sisense uses technology to provide smart suggestions to users when they are selecting ElastiCube fields to use in their dashboard widgets. This property allows users to turn on or off this feature.
Toggle to enable Viewers to receive exploration widgets in the dashboard. Sisense’s AI (Artificial Intelligence) Exploration Paths automatically generate visualizations and insights that anticipate your Viewers’ questions without requiring a Dashboard Designer to create more widgets.
This feature is constantly improving. Refer to this documentation on how to set up and use it: Leverage AI to Uncover Hidden Insights.
Sisense supports user session management via either of two methods: Cookies or Session Inactivity.
- Cookies: Default setting. Allows you to define how much time must pass before a user’s session is ended according to the user’s cookie. Expiration is in Days
- Session Inactivity: Allows you to define how many minutes of inactivity must pass before a user or an Administrator is logged out. Expiration is in minutes
Note: If you make changes to these settings, after saving users may have their sessions revoked.
For more information on set up, refer to the set up guide: Manage User Sessions
Embedded Domain White List
You can define which domains can embed your dashboards into iFrames on their site. If you do not add any domains, then your dashboards can be embedded into any site.
Please refer to this article for more information on how this setting works in combination with other security settings: Optional Security Hardening for Sisense Web Pages
This page had a number of enhancements and fixes within the 7.4 release. Please refer to the Release Notes page for more information.
By popular demand, the ability to enforce account lockout after a number of failed logins was added. You can define the following settings for account lockout:
- Toggle On/Off
- Number of failed login attempts before lockout
- Lockout duration (minutes)
Refer to the following article for additional settings and information: Account Lockout Thresholds