Flexera IT Visibility

Flexera IT Visibility is a configuration management tool. You can bring software data from Flexera into Brinqa to facilitate a consolidated view of your attack surface, thus strengthening your cybersecurity posture.

This document details the information you must provide for the connector to authenticate with Flexera IT Visibility and how to obtain that information from Flexera. See create a data integration for step-by-step instructions on setting up the integration.

Required connection settings

When setting up a data integration, select IT Visibility from the Connector drop-down. If you cannot find the connector in the drop-down, make sure that you have installed it first. You must provide the following information to authenticate Flexera IT Visibility with Brinqa:

API URL: The Flexera API base URL. The default URL is: https://api.flexera.com.
Login URL: The authentication URL for Flexera IT Visibility. The default URL is: https://login.flexera.com/oidc/token
Organization ID: The unique identifier for your organization's Flexera IT Visibility account.

You can find your organization ID in the URL when you're logged in to Flexera. For example:

https://app.flexera.com/orgs/<ORGANIZATION-ID>/
Refresh token: The API refresh token associated with the FlexeraOne account.

The associated FlexeraOne account must have the View IT Visibility role assigned. For additional information on Flexera roles, see FlexeraOne documentation.

Obtain a Flexera API refresh token

For the Flexera IT Visibility connector to access the Flexera API, you must provide an API refresh token. To do so, follow these steps:

In your web browser, go to the appropriate login URL based on your region, and log in to your organization's FlexeraOne account:
- North America: app.flexera.com
- Europe (EU): app.flexera.eu
- Asia-Pacific (APAC): app.flexera.au
In the top-right corner of the page, click your profile icon, and then select User Settings from the drop-down.
In the left-hand navigation menu, click API Credentials, and then click Create API Refresh Token.

Your new refresh token displays. You cannot view the token again after this. Copy and save it to a secure location.
Click Close.

note

If you do not have permission to generate a refresh token, contact your Flexera administrator. For additional information, see FlexeraOne documentation.

Additional settings

The Flexera IT Visibility connector contains an additional option for specific configuration:

Page size: The maximum number of records to get per API request. The default setting is 1000. It is not recommended to go over 1000.

Types of data to retrieve

The Flexera IT Visibility connector can retrieve the following types of data from the Software Vulnerability Research API:

Table 1: Data retrieved from Flexera

Connector Object	Required	Maps to Data Model
Software	Yes	Package

info

The Flexera IT Visibility connector does not currently support operation options for the types of data it retrieves.

For detailed steps on how to view the data retrieved from Flexera in the Brinqa Platform, see How to view your data.

Attribute mappings

The table below details the mappings between the source and the Brinqa data model attributes.

Table 2: Software attribute mappings

Source Field Name	Maps to Attribute
CATEGORIES	categories
CURRENT_VERSION	currentVersion
IS_OPERATING_SYSTEM	isOperatingSystem
MANUFACTURER	manufacturer
NAME	name
PRODUCT_NAME	productName
UID	uid
SOURCE_CREATED_DATE	sourceCreatedDate

APIs

The Flexera IT Visibility connector uses the Flexera GraphQL API v1. Specifically, it executes the following GraphQL query to retrieve data:

Software GraphQL Query

query ($limit: Int, $offset: Int) {
  software(limit: $limit, offset: $offset) @flatten @distinct {
    isOperatingSystem
    lifecycleId
    majorVersionId
    manufacturerId
    manufacturerName
    marketVersionId
    name
    productId
    productName
    versionName
  }
}

Changelog

The Flexera IT Visibility connector has undergone the following changes:

Table 3: Flexera IT Visibility connector changelog

Version	Description
3.1.0	Initial Integration+ release.

Required connection settings​

Obtain a Flexera API refresh token​

Additional settings​

Types of data to retrieve​

Attribute mappings​

APIs​

Changelog​