Reference Solution for Integrating a Data Asset Portal with Guandata

As a platform for managing and displaying enterprise data assets, the Data Asset Portal has become an important investment direction for many enterprises. It provides a centralized hub for managing data assets, making it easier for internal departments and employees to search for, access, and use data assets, as well as data products such as Dashboards, reports, and data applications. Through a Data Asset Portal, enterprises can better manage data, improve data usability and reliability, and thereby improve decision-making efficiency and business outcomes.

As a core platform for enterprise data capability construction, Guandata provides leading mobile and desktop portal capabilities, and also supports integration with independently built enterprise data asset portals through various open capabilities. This article provides a basic introduction to those capabilities.

Introduction to Open Capabilities

Based on Guandata's practical experience, the following capabilities can help enterprises integrate with Guandata BI more efficiently and quickly.

Data Asset Lists

Supports retrieving complete lists of Dashboards, big screens, and Datasets within the system.

Related APIs:

• Get Dashboard Pages
• Get Dashboard Pages in Tree Structure, Including Directory Information
• Get Dataset List

Asset Lists Accessible to Specific Users

If the Data Asset Portal does not record which data assets an employee is allowed to access, the following APIs can be used to query that information.

• Query Dashboard Pages Accessible to a Specific User
• Query Datasets Usable by a Specific User

Password-Free Login to Guandata BI

When embedding Pages or providing quick access, users often do not want to repeatedly enter account credentials or scan codes. Guandata provides multiple password-free login capabilities.

Guandata Standard SSO Service

Guandata Standard SSO transfers user information through RSA encryption and decryption. Specifically, an encrypted token is appended to the embedded URL or the URL to be accessed.

API reference: Guandata BI SSO Integration

Use Standard Password-Free Protocols Such as OAuth, CAS, and SAML

When Guandata has already configured any password-free login method and enabled the option to prioritize the unified authentication service, there is no need to add extra parameters to the embedded URL or the URL to be accessed. Simply access the corresponding service address directly. When the browser contains a valid cookie, the user can access the resource directly. When the browser does not contain a valid cookie, the user is first redirected to the unified authentication service for authorization and then redirected back to the target resource. Once login succeeds, a valid cookie is obtained and login is not triggered again for a period of time.

Page Element Hiding Capabilities

When embedding pages through iframe, it is often necessary to hide the navigation bar, directory panel, and other elements as needed. Guandata supports this by adding specific query parameters to the URL. One environment can support multiple hiding strategies to meet different needs.

• General Page Hiding Capability
• Custom Page Element Hiding Capability

When using iframe embedding, pay attention to cross-origin issues. Common solutions are provided here.

Resource Authorization and Revocation

Some Data Asset Portals are integrated with internal approval workflows. When employees need to access Resources they do not currently have permission for, an approval process may be required, and some approvals may be time-limited. The asset platform can call APIs related to Resource authorization and revocation as needed to synchronize permission information to Guandata.

• Authorize or Revoke Dashboard Access Permissions
• Authorize or Revoke Dataset Access Permissions

Access to the above APIs requires compliance validation, so administrators must apply for an access key. For details, see Token Authentication.

Convenient Resource Access Through URL

The access URLs of Guandata data asset content follow a straightforward construction pattern. By replacing the Dashboard ID, pgId, or Dataset ID, dsId, you can build a URL for a specific Resource. Common URL patterns include:

• Dashboard page: service base domain/page/DashboardID
• Dataset overview page: service base domain/data-source/DatasetID/details/overview
• Dataset create-card page: service base domain/data-source/DatasetID/details/card

We look forward to hearing about your integration achievements with Guandata.

If you have related questions, feel free to contact Guandata support.