Custom connectors

Custom connectors, also known as universal connectors, discover user and user activity data from SaaS vendors that are not supported by out-of-the-box SaaS connectors. Custom connectors are custom integrations you build with SaaS vendors by mapping fields from the third-party vendor APIs to the data structures supported in SaaS. This enables recurring collection of user and user activity data, which is then consolidated and presented in indicators, charts, and tables on the SaaS pages.

Once the custom connector has been created, it functions the same as the default SaaS connectors. For information on managing connectors, see Manage SaaS connectors.

note

This feature is in Early Access and available only in select tenants. To request access for your organization, contact your account manager.

To set up a custom connector, you must first create a template that maps information about the vendor API to the Flexera One SaaS Management system. Once you have created this template, you can proceed with the steps to Add custom connectors.

Create custom connector templates

1. On Settings > SaaS connectors page, select Create connector.

2. On the General step:

   1. Enter a Name for the connector and choose the Vendor to integrate with.

   2. Select Next.

3. On the Authentication step:

   1. Choose an Authentication method that is supported by the vendor API.

   2. If you select API key: enter the Token type that is supported by the vendor API. Refer to the vendor's documentation for how to find your API key and the token schema that is used.

   3. If you select Authentication method:

   • For OAuth2 flow, select the grant type used to obtain access tokens from the vendor API.

   • Enter the Token URL. This is the endpoint URL that is used to obtain access tokens from the vendor API.

   • For Scope, enter the permissions that are required by the vendor API. If the vendor API does not require that you specify scopes in authorization requests, leave this field empty.

   • For How to send client credentials, select the method used send your client_id and client_secret in the access token request. Refer to the vendor's documentation for information on supported methods.

4. On the Request step:

   1. For Users URL, enter the endpoint URL used by the vendor API to send user data.

   2. For Pagination, if applicable, choose a pagination method that is supported by the endpoint.

5. On the Response step, map the system fields in Flexera One SaaS Management to the equivalent Vendor fields used by the vendor API.

   tip

   Call the endpoint that returns user data for the vendor, and refer to the response body to complete this step.

6. On the Filters step, select Add filter to limit the data that is consolidated in Flexera One SaaS Management:

   1. Enter the Response field from the vendor API that you want to filter. For example, department.

   2. Enter the Value for the response field that you want to filter on.

   3. Choose the Operator:

   • Equal only include data where the Response field matches the Value.

   • Not equal only include data where the Response field does not match the Value.

7. On the Activity step, you can select User as the Activity type to retrieve user activity data for a vendor application.

   1. If you select User as the Activity type, enter the name of the Last activity field from the vendor API response.

   2. Select the Application for which you want to collect user activity.

Once you have created a custom connector template, follow the procedure below to add the connector to the system. This is required for the data to be consolidated in Flexera One SaaS Management.

Add custom connectors

1. On the SaaS connectors page, on the Discover tab, find the custom connector template from the list of connectors in the Not added section.

2. Select Add connector.

3. Enter a Name for the connector.

4. In Settings, enter the required values depending on the authentication method chosen when creating the template. Refer to the vendor documentation for information on retrieving these values.

5. Under Schedule, you can schedule data imports for this connector.

   By default, schedule is Enabled and set to daily at 23:00 in your time zone. You can change the time or disable scheduling:

   • To change the time for data imports, in Daily, select the time.

     The selected time is in your time zone, based on the time zone of your browser. The offset of your browser's time zone from UTC is shown in parentheses. Someone in another time zone sees the scheduled time in their time zone.

     The selected time, and the displayed offset, adjusts automatically for daylight saving time, when applicable.

   • To disable scheduling, in Schedule, select Disabled.

     A disabled schedule requires that you manually import data. Data from the vendor will not be updated automatically in your system.

6. To add the connector and test the connection, select Save.

   The connector is added to the system.