Skip to main content

Brinqa User Interface

This article describes the different tabs and menus in your Brinqa Platform, how to edit the list view columns, and how to export and download your list views.

The Brinqa user interface (UI) is the main way to interact with menus and pages in your instance. Since the Brinqa UI is customizable, the exact menus in your Brinqa Platform may vary. See the Navigation Menu Items for reference.

Most of the pages in the Brinqa UI display a list view of your data. You can search through the records to limit what's displayed, and then click each item to view more details. You can also add more filters for the basic search, edit the list view columns to display more or fewer columns, select multiple items at once to perform bulk actions, or export the list view.

Your Brinqa Platform contains several pages or modules in the navigation menu. The following table describes the different items you may see in the navigation menu:

ItemDescription
HomeDisplays the homepage of your Brinqa Platform.
DashboardDisplays the default dashboard for specific topics pertaining to your data. For example, Asset management, Findings counts and trends, SLA compliance, and more. You can modify the dashboard to fit the needs of your organization.
InventoryDisplays a list view of your assets retrieved from data integration. Hold the pointer over Inventory to display and choose from different Inventory categories, including Assets, Apps, Cloud, Network, and Human Resources.
ClustersDisplays a container of your clusters. Hold the pointer over Clusters to display and choose from different cluster types, including Assets, Finding Definitions, and Ownership.
FindingsDisplays a list view of your findings retrieved from data integration and data orchestration.
ExploreA global search for all your data and displays results in a graph or list view. You must enter your search using the Brinqa query language (BQL).
RemediationDisplays a list view of your remediation efforts. Hold the pointer over Remediation to display and choose from different Remediation categories, including Tickets, Sprints, and Requests.
AutomationDisplays a list view of your automations.
AnalyticsDisplays a list view of your reports.
IntegrationsHold the pointer over Integrations to display and choose from your configured data integrations, access the connector store, or view or create data servers.
Notifications notification iconDisplays notifications in your instance.
Apps app iconSwitch to different apps in your instance.
Administration admin buttonAccess the Administration menu, including user administration, views, data models, risk factors, SLA definitions, and more.
Help help iconAccess the Brinqa documentation, contact the Brinqa Service Desk, or raise an issue by sending an email to support@brinqa.com. Click About to find out the build and version number, host IP address, host name, and uptime of your Brinqa Platform.
Account account iconEdit your user information, change your password, view exports, or log out of your account.

Bulk actions

The Brinqa UI supports bulk actions. You can perform certain actions to one or more selections at the same time, as opposed to performing the same action to individual records over and over.

For example, you can navigate to Findings and select one or more of the findings in the list view, and then click the Select an action menu to choose from the available actions to apply to your selected records. Actions include: create an exception request, create a risk acceptance request, or create a false positive request.

Modify list view filters

Within the list view, there are default attribute filters designed to help refine your dataset. These filters are displayed next to the search bar. You can add more filters if needed. For example, to add Risk rating to the Findings page, follow these steps:

  1. Navigate to the Findings page.

  2. Click More next to the default filters.

  3. Select Risk rating.

  4. Click Apply.

The Risk rating filter is added to the Findings page. If you want to remove some of the default filters, please refer to Modify default filters and columns on the host list view.

findings page basic filters

Modify list view columns

You can customize what columns are displayed on a list view by clicking the Select columns column-button menu.

You can select additional columns or remove some columns. For example, the Findings list view displays a default set of columns. If you want to add a Risk rating column, follow these steps:

  1. Navigate to Findings > All findings.

  2. Click the Select columns column select menu.

  3. Select Risk rating.

  4. Click Apply.

The Risk rating column is added to the Findings list view.

tip

You may need to scroll horizontally to the end to see the new column in the list view.

Export and download list views

The Brinqa Platform stores highly sensitive data. Many organizations desire a dedicated role that allows users to view data but not export it outside of the Brinqa Platform. To address this, the Brinqa Platform has designated a Data exporter role to manage user privileges at a more granular level.

The Data exporter role on its own does not provide permissions to data in list views. To access the data, users must be assigned additional roles that grant access to data, such as Administrator, Remediation owner, or Risk owner. For additional information on role permissions, please see the Roles documentation.

EXPORT LIMITS

The Brinqa Platform supports a limit of 200,000 records per export.

Users with the Data exporter or System administrator role can export and download list views as a CSV file to share with others, or edit and view in a third party spreadsheet application. To export and download a list view, follow these steps:

  1. Navigate to a list view page. For example, Inventory > All assets.

  2. Click Export export arrow icon. A new window appears.

  3. Enter a name for the export.

  4. For Include, select either Displayed attributes or All exportable attributes.

    • Displayed attributes: This option includes only those attributes that are currently visible in your list view. If you have customized your list view to show specific attributes, only these will be included in the export.

    • All exportable attributes: This option includes all attributes that can be exported for the items in your list view, regardless of whether they are currently visible in your list view or not. This option is useful when you want a comprehensive export of all available data. This option might result in a larger CSV file, depending on the number of attributes available.

  5. Click Export. The following message appears on the lower-left corner: "Data will be generated and it will be available on the Export page."

  6. To download the export, navigate to Account account menu icon > Exports. You will also receive an email that contains a link to download the export.

    On the exports page, there are four statuses associated with your exports:

    • Ready: The export process is complete, and the file is ready for download. The data in the list view has been successfully exported and converted into a CSV file.

    • Processing: The export is currently in progress. The data from the list view is being processed and converted into a CSV file.

    • Scheduled: The export has been queued and is scheduled to run.

    • Failed: There was an error during the export process and it could not be completed successfully.

  7. Click the name of the export. A new page appears.

    • You can also hold your pointer over the entry in the list view and click Download. The CSV file downloads directly to your local storage.
  8. Click Download. The CSV file downloads directly to your local storage.

Add comments to records

The Brinqa Platform gives you the ability to add, edit, and delete comments on the following records:

  • Assets and all data models that extend Asset: Account, API endpoint, Application, Assessment, Certification, Code project, Code repository, Container, Container image, Device, Host, Host image, IP range, Network segment, Package, Person, Service, Site, Site certificate, and Subnet.

  • Findings and all data models that extend Finding: Alert, Dynamic code finding, Finding, Incident, Manual finding, Open source finding, Pentest Finding, Static code finding, Violation, and Vulnerability.

  • Requests: Exception requests, False positive requests, Remediation validation requests, and Risk acceptance requests.

  • Tickets: Alert ticket, Dynamic code ticket, Incident ticket, Manual ticket, Open source ticket, Pentest ticket, Static code ticket, Ticket, Violation ticket, and Vulnerability ticket.

  • As well as Remediation campaigns and Security advisories.

Comments can enhance collaboration by letting you share insights and updates directly with other users in the Brinqa Platform.

Add a comment

To add a comment, follow these steps:

  1. Navigate to the record that you want to leave a comment on.

  2. Click the Comments Tab.

  3. In the Add a comment text box, type your comment.

    There is no limit to the amount of characters in a comment.

  4. Click Comment to save your comment.

    Commenting on a finding

    Your comment displays in the Comment tab.

Other Brinqa users with access to that data can see your comments. For example, if you are part of a Risk Owner team and you leave a comment on a finding, other team members with access to that finding can see your comment. The same applies to tickets, remediation requests, and remediation campaigns.

Edit or delete comments

Comments can be edited or deleted after they are posted. To edit a comment, follow these steps:

  1. Locate the comment you wish to edit.

  2. Click the 3-dot kebab menu next to the comment.

  3. Select Edit from the drop-down.

  4. Make the necessary changes to your comment.

  5. Click Update.

To delete a comment, follow these steps:

  1. Locate the comment you wish to delete.

  2. Click the 3-dot kebab menu next to the comment.

  3. Select Delete from the drop-down.

  4. In the Remove comment dialog, click Delete.

Disable comments

If you wish to disable the commenting functionality, follow these steps:

  1. Navigate to the data model where you want to disable comments, such as Finding.

  2. Click Attributes.

  3. Search for and click the Comments attribute.

  4. Navigate to the Options section and uncheck the Active option.

When you uncheck the Active option, the Comments tab still displays on that record, but the ability to add new comments is disabled. On the other hand, if you see the Comments tab but cannot add comments, it's because commenting has been disabled for that data model.