Guides
sevco.io

Manage Sevco Integrations

Suggest Edits

⚠️

Note:

This article provides a general overview of Integrations and the role they play in the Sevco platform. For integration-specific documentation, please refer to the SEVCO INTEGRATIONS section of this documentation site.

What are Integrations?

Integrations create communication channels between your organization in Sevco and the platforms you've already been using to manage your assets such as endpoint agents and directory services.

Sevco integrates with a large number of platforms that fall into one of about a dozen categories – asset inventory, cloud infrastructure, and vulnerability assessment to name a few.

When an Integration is initially configured, one or more of the following actions will occur:

  • Asset information from the integrated platform will automatically import into Sevco
  • Sevco will automatically export asset information to the integrated platform

Once multiple integrations have been configured, data is sent through the Sevco Inventory Processing Pipeline to provide you with a unified inventory of your assets.

What Information is Collected by Integrations?

Updated Diagram Chart

Asset Types

Integrations can collect information about one or more of the following asset types:

  • Devices
  • Users
  • Software
  • Vulnerabilities

Attributes

Sevco collects both asset and platform-specific attributes from an Integration using available APIs. As such, the attribute data collected will vary based on the platforms you have chosen to integrate.

An asset-specific attribute is any piece of information about an asset that helps uniquely identify or provide context about the asset itself. Examples of asset-specific attributes include but are but not limited to:

  • Hostname(s)
  • IP Address(es)
  • MAC Address(es)
  • Fully Qualified Domain Name
  • Operating System
  • Serial Number
  • Asset Category

A platform-specific attribute is any information reported by an Integration about an asset's configuration that provides context about its state. Examples of platform-specific attributes include but are not limited to:

  • Agent Version
  • Agent Status
  • Management State
  • Applied Policy or Groups
  • Controls

To view a complete list of available fields and attributes for a specific Integration, please refer to the SEVCO INTEGRATIONS section of our documentation site.

How Do I Configure an Integration?

ℹ️

Sevco now uses Static IP Addresses for its integration cloud runners. You may need to whitelist these IP addresses, depending on your organization's security practices. Contact our support team at [email protected] to access this information.

You can configure an integration from the Integrations page; however, integrations that fall under the Identity Access Management, Endpoint Protection, and Network or Cloud Management categories can also be configured from the dashboard.

Integrations page

Click here for instructions on adding integrations to your Sevco organization.

Where Can I Monitor My Integration Health?

After an Integration is configured, it is important to check on its Configuration Status periodically to ensure that it is in an Active status () and consistently syncing data to your Sevco organization.

Active Configuration Status

Sevco Integrations can be in the following statuses:

  • Active: The Sevco Integration is operating normally and collecting data.
  • Error: Sevco had an error connecting with the Integration. Review the Logs tab.
  • Disabled: The Sevco Integration has been disabled.

If an Integration is in an Error status (), we recommend reviewing the Logs tab of its configuration panel to identify any sync errors that may be causing the issue.

Navigate to Logs tab

Information about Integration health is located on the Integrations page, which can be accessed by selecting the Admin icon () on the Navigation bar and clicking the Integrations link from the dropdown.

Navigate to Integrations

Click here to learn more about monitoring Integration health.

Where Can I Monitor My Assets?

User and Device assets can be monitored from the Integration and Live Inventory pages.

Live Inventory

⚠️

Note: This page can only display information about one asset class at a time and does not currently support software assets or cross-asset searches.

The Live Inventory page provides an aggregated view of all of your Integration Assets in an Asset Class. This page has several search features that allow you to filter and view information about specific assets. Access this page by selecting the Live Inventory icon on the Navigation bar and clicking the Devices or Users link from the dropdown.

Navigate to Live Inventory pages

In addition to filtering your assets, this page also provides three ways for you to view your assets: List, Geo (map), and Network.

Live Inventory page views

Integration Inventory

Integration Inventory pages are integration-specific and only display asset data from a single Integration. These pages can be accessed by selecting the Integration Inventory icon on the Navigation bar then selecting the Integration you would like to view information about from the dropdown.

Navigate to Integration Inventory page

Click here for an in-depth review of the Integration and Live Inventory pages.

Updated 4 months ago