Overview

ColorTokens XShield is a comprehensive cybersecurity solution that provides real-time visibility and protection for applications and workloads across cloud, on-premises, and hybrid environments.

Available Integrations

Product(s)	Supported Asset Type(s)	Integration Type
ColorTokens XShield	Devices	Source

Why You Should Integrate

Integrating with ColorTokens XShield will provide visibility into your devices being managed by ColorTokens XShield.

How Does the Integration Work

This integration works by pulling information about your devices from ColorTokens XShield using its REST API.

This data is only used internally; we do not share it with any parties outside of Sevco. Refer to our privacy policy for details.

⚠️
Please review the configuration instructions in the section below before setting up permissions for apps.

Configuration

Install a runner: Follow our instructions to install a runner .
Configure the Access Schema

Field	Description	Example
`URL`*	The URL associated with your instance of ColorTokens XShield	`https://company.colortokens.com`
`Tenant ID`*	The Tenant ID for your instance of ColorTokens XShield	`12345ab6-78c9-1011-1def-21gh314i1516`
`User ID`*	The User ID of the ColorTokens XShield account you would like to use	`0987zyxw-12ab-vut3-sr65-456cde78ponm`
`Fingerprint`*	The public-key fingerprint added to your user account after a private key is generated	`1a:2b:3c:4d:5e:6f:7a:8b:9c:0d:1e:2f:3a:4b:5c:6d`
`Private Key`*	The private key generated in your instance of ColorTokens XShield	`************************`
`Passphrase`	The passphrase to decrypt your account's private key. This is only required if your private key is encrypted.	`uN3!4s\@T$gHq92P#mF7LwZxC`

Add an Integration: Select the integration(s) you'd like to add.
- Collect devices
Configure General Information: OPTIONAL: You can use the following fields to provide additional information about your configuration.

Field	Description	Example
`Name (optional)`	Uniquely identifiable attribute of the configuration to delineate other similar configurations with the existing organization.	`DMZ network`
`Contact Person (optional)`	A placeholder to input a name or email address of a contact associated with the integration.	`Jane Doe`
`Link to Console (optional)`	A placeholder to input a link to the console of the product Sevco is integrating with for quick reference and access when configuring or editing the integration.	`www.product.com/devices`
`Email me about frequent errors`	Select this toggle to receive an email whenever an Integration has a ≥30% error rate in a 24-hour period.	n/a

Activate Config: Select "Activate" to enable this configuration and begin pulling data.

External Documentation

Creating credentials

You will be asked to provide credentials that Sevco will use for the integrations. This link will take you through the steps for obtaining your Tenant ID and User ID as well as creating a private key and fingerprint to configure the Access Schema.

Required Permissions

The account used to configure this integration must have the following permission scopes and permissions

Field	Value
`permissionScope`	`ADMIN`,`USER`
`permission`	`LIST_ASSET`

API Documentation

ListAssets

Contact Us

If you're having problems configuring an Integration, or if you've found something wrong in this document, please email us at [email protected] or suggest edits directly by selecting the Suggest Edits link located in the upper right hand corner of the documentation.