Introduction

In the previous blog, we learned how to use custom token-based SSO. In a custom token-based SSO integration, the external application generates an encrypted token containing user details such as username, organization, roles, and profile attributes. Helical Insight decrypts and validates this token to establish the user’s session.

Both applications must use the same encryption key, which should be treated as a sensitive secret and stored securely.

Key rotation is the process of replacing an existing encryption key with a new one periodically or whenever a security risk arises. Starting with Helical Insight version 7.0.1.278 RC1, the SSO encryption key can be configured independently using the sso.cipherKey property in the project.properties file.

This allows administrators to change the encryption key without affecting existing user records. Ensure that the new key is updated in both Helical Insight and all external applications generating SSO tokens. Also, plan the transition carefully, as tokens encrypted with the previous key may no longer work after the change.

Operational Consideration: The new key must be coordinated across Helical Insight and every application or service that generates SSO tokens. During the changeover, ensure both sides are updated in a controlled manner and that new tokens are generated with the new key. Tokens encrypted with the previous key may no longer be decryptable after the change, so plan the rollout around active integrations and token lifetimes.

1. SSO Encryption Key Rotation

In earlier versions, rotation of the SSO encryption key was not supported due to dependencies in the existing implementation.

Starting from Helical Insight version 7.0.1.278 RC1, the SSO encryption key is configured separately using the following property:

sso.cipherKey

This allows the SSO encryption key to be changed without affecting existing Helical Insight users.

2. Steps to Rotate the SSO Encryption Key

Follow these steps to update the SSO encryption key:

  1. Step 1: Open the Configuration File

    Navigate to the following location:

    ...../hi-ee/WEB-INF/classes/project.properties

  2. Step 2: Locate the Property

    Open the project.properties file and find the following property:

    sso.cipherKey

  3. Step 3: Update the Key

    Set sso.cipherKey to your new 16-character encryption key.

    Example:

    sso.cipherKey=1234567890ABCDEF
  4. Step 4: Save the File

    Save the changes made to the project.properties file.

  5. Step 5: Restart Helical Insight

    Restart the Helical Insight application for the new encryption key to take effect.

  6. Step 6: Update the Token Generator

    Update your SSO token-generating application with the same new encryption key. Both Helical Insight and the token-generating application must use the same key.

3. Important Note

Existing Helical Insight users do not need to be recreated or modified. The key rotation only applies to the SSO token encryption and decryption mechanism. Existing users remain unchanged.

4. Summary

The following table summarizes the important configuration details for SSO encryption key rotation in Helical Insight:

Configuration Details
Helical Insight Version 7.0.1.278 RC1
Configuration Property sso.cipherKey
Key Length 16 characters
Application Restart Required
Token Generator Update Use the same new encryption key
Existing Users No changes required

Leave a Reply

Helical Insight’s self-service capabilities is one to reckon with. It allows you to simply drag and drop columns, add filters, apply aggregate functions if required, and create reports and dashboards on the fly. For advanced users, the self-service component has ability to add javascript, HTML, HTML5, CSS, CSS3 and AJAX. These customizations allow you to create dynamic reports and dashboards. You can also add new charts inside the self-service component, add new kind of aggregate functions and customize it using our APIs.
Helical Insight’s self-service capabilities is one to reckon with. It allows you to simply drag and drop columns, add filters, apply aggregate functions if required, and create reports and dashboards on the fly. For advanced users, the self-service component has ability to add javascript, HTML, HTML5, CSS, CSS3 and AJAX. These customizations allow you to create dynamic reports and dashboards. You can also add new charts inside the self-service component, add new kind of aggregate functions and customize it using our APIs.
Helical Insight, via simple browser based interface of Canned Reporting module, also allows to create pixel perfect printer friendly document kind of reports also like Invoice, P&L Statement, Balance sheet etc.
Helical Insight, via simple browser based interface of Canned Reporting module, also allows to create pixel perfect printer friendly document kind of reports also like Invoice, P&L Statement, Balance sheet etc.
If you have a product, built on any platform like Dot Net or Java or PHP or Ruby, you can easily embed Helical Insight within it using iFrames or webservices, for quick value add through instant visualization of data.
If you have a product, built on any platform like Dot Net or Java or PHP or Ruby, you can easily embed Helical Insight within it using iFrames or webservices, for quick value add through instant visualization of data.
Being a 100% browser-based BI tool, you can connect with your database and analyse across any location and device. There is no need to download or install heavy memory-consuming developer tools – All you need is a Browser application! We are battle-tested on most of the commonly used browsers.
Being a 100% browser-based BI tool, you can connect with your database and analyse across any location and device. There is no need to download or install heavy memory-consuming developer tools – All you need is a Browser application! We are battle-tested on most of the commonly used browsers.
We have organization level security where the Superadmin can create, delete and modify roles. Dashboards and reports can be added to that organization. This ensures multitenancy.
We have organization level security where the Superadmin can create, delete and modify roles. Dashboards and reports can be added to that organization. This ensures multitenancy.
We have organization level security where the Superadmin can create, delete and modify roles. Dashboards and reports can be added to that organization. This ensures multitenancy.
We have organization level security where the Superadmin can create, delete and modify roles. Dashboards and reports can be added to that organization. This ensures multitenancy.
A first-of-its-kind Open-Source BI framework, Helical Insight is completely API-driven. This allows you to add functionalities, including but not limited to adding a new exporting type, new datasource type, core functionality expansion, new charting in adhoc etc., at any place whenever you wish, using your own in-house developers.
A first-of-its-kind Open-Source BI framework, Helical Insight is completely API-driven. This allows you to add functionalities, including but not limited to adding a new exporting type, new datasource type, core functionality expansion, new charting in adhoc etc., at any place whenever you wish, using your own in-house developers.
It handles huge volumes of data effectively. Caching, Pagination, Load-Balancing and In-Memory not only provides you with amazing experience, but also and does not burden the database server more than required. Further effective use of computing power gives best performance and complex calculations even on the big data even with smaller machines for your personal use. Filtering, Sorting, Cube Analysis, Inter Panel Communication on the dashboards all at lightning speed. Thereby, making best open-source Business Intelligence solution in the market.
It handles huge volumes of data effectively. Caching, Pagination, Load-Balancing and In-Memory not only provides you with amazing experience, but also and does not burden the database server more than required. Further effective use of computing power gives best performance and complex calculations even on the big data even with smaller machines for your personal use. Filtering, Sorting, Cube Analysis, Inter Panel Communication on the dashboards all at lightning speed. Thereby, making best open-source Business Intelligence solution in the market.
With advance NLP algorithm, business users simply ask questions like, “show me sales of last quarter”, “average monthly sales of my products”. Let the application give the power to users without knowledge of query language or underlying data architecture
With advance NLP algorithm, business users simply ask questions like, “show me sales of last quarter”, “average monthly sales of my products”. Let the application give the power to users without knowledge of query language or underlying data architecture
Our application is compatible with almost all databases, be it RDBMS, or columnar database, or even flat files like spreadsheets or csv files. You can even connect to your own custom database via JDBC connection. Further, our database connection can be switched dynamically based on logged in users or its organization or other parameters. So, all your clients can use the same reports and dashboards without worrying about any data security breech.
Our application is compatible with almost all databases, be it RDBMS, or columnar database, or even flat files like spreadsheets or csv files. You can even connect to your own custom database via JDBC connection. Further, our database connection can be switched dynamically based on logged in users or its organization or other parameters. So, all your clients can use the same reports and dashboards without worrying about any data security breech.
Our application can be installed on an in-house server where you have full control of your data and its security. Or on cloud where it is accessible to larger audience without overheads and maintenance of the servers. One solution that works for all.
Our application can be installed on an in-house server where you have full control of your data and its security. Or on cloud where it is accessible to larger audience without overheads and maintenance of the servers. One solution that works for all.
Different companies have different business processes that the existing BI tools do not encompass. Helical Insight permits you to design your own workflows and specify what functional module of BI gets triggered
Different companies have different business processes that the existing BI tools do not encompass. Helical Insight permits you to design your own workflows and specify what functional module of BI gets triggered