Configure Service Graph Connector for Trellix using guided setup
Set up scheduled import jobs to pull in data from a Trellix project into your CMDB.
Before you begin
Important: Unless there are configuration issues, use SGC Central to configure the connection. The guided setup method for configuration is being deprecated.
To use this Service Graph Connector, you need a subscription to a Subscription Unit that is based in the IT Operations Management (ITOM) Visibility application or in the ITOM Discovery application. As defined in the section titled "Managed IT Resource Types" in ServiceNow Subscription Unit Overview for your subscription, for managed IT resources that are created or modified in the CMDB by this Service Graph Connector, but that aren’t yet managed by ITOM Visibility or ITOM Discovery, these resources will increase Subscription Unit consumption from that application. Review your current Subscription Unit consumption within ITOM Visibility or ITOM Discovery to ensure available capacity.
Dependencies and requirements:
- The Integration Commons for CMDB store app, which is automatically installed. See Integration Commons for CMDB.
- The CMDB CI class models store app, which is automatically installed. See CMDB CI Class Models app.
- The ITOM Licensing plugin (com.snc.itom.license). See Request Discovery.
Role required: admin
Procedure
Verify that the application scope is set to the Service Graph Connector for Trellix application by using the application picker.
For more information, see Application picker.
Navigate to All > Service Graph Connectors > Trellix > Setup.
On the Service Graph Connector for Trellix page, verify that the Quick Start option is selected, and then select Continue.
Configure the connection to send requests to the Trellix application.
On the Service Graph Connector for Trellix page, in the Configure the Connection and Credentials section, select Start.
Configure the authentication credentials.
For the Configure Trellix authentication credentials task, fill in the fields on the Basic Auth Credentials form.
Field Description Name Credentials to use for the connection. For example, SGTrellix.Credentials.Order The sequence in which the records are processed. The default value is 100.User name User name of your Trellix account. Password Password of your Trellix account. Active Verify that the check box is selected. Select Update to save the authentication credentials.
Set the Configure Trellix authentication credentials task to complete by selecting Mark as complete, and then select Continue.
- Configure the HTTP connection.
For the Configure Trellix HTTP Connection task, fill in the fields on the HTTP(s) Connection form.
| Field | Description |
|---|---|
| Name | Name to identify the Trellix connection record. For example, `SGTrellix`.Don’t modify the name for the default `SGTrellix` connection. |
| Active | Verify that the check box is selected. |
| Credential | Credentials to use for the connection. |
| Domain | Domain that contains the connection. |
| Connection alias | Connection alias that resolves your connection and credentials at runtime.Note: Only one connection is active per connection alias at a time. |
| Connection URL | Base URL of the connection. The base URL is the hostname of your Trellix instance. For example, `https://*subdomain*.*domain*.com:*port*`. |
| Use MID server | Option to use a MID Server. Select this check box if you're using an on-premises instance of Trellix. Complete the Advanced MID Server Configuration.Note: A MID Server must be configured on your ServiceNow instance before you select this option. |
| MID selection | Select a MID Server from the list.This field appears only when the Use MID Server check box is selected. |
| MID application | Select a MID Server application from the list.This field appears only when the Use MID Server check box is selected. |
| Connection timeout | The maximum time \(in seconds\) the system waits while attempting to establish a connection. |
2. Select **Update** to save the HTTP connection details.
3. Set the Configure Trellix HTTP Connection task to complete by selecting **Mark as complete**, and then select **Continue**.
4. Test the Trellix API connection to import data from the Trellix application.
1. Test the connection by selecting the **Test Connection** related link in the Test Connection task.
Testing the connection might take a few moments. The page is refreshed to show the test results.
2. When the **Status** field is set to **Success**, set the Test Connection task to complete by selecting **Mark as complete**, and then select **Continue**.
If any of the tests have errors, follow the suggestions for remediation.
Add multiple instances.
Note: If you don't need to add multiple instances, you can skip this step.
On the Service Graph Connector for Trellix page, in the Add Multiple Instances section, select Start.
In the Update Data Source Access section, select the Data Source [sys_data_source] table.
Select the Global application scope by using the application picker.
In the Application Access related list, select the Can create, Can update, and Can delete check boxes, if not already selected.
Modify the application scope again to Service Graph Connector for Trellix by using the application picker.
Select Update to save the data source access details.
Set the Update Data Source Access task to complete by selecting Mark as Complete, and then select Continue.
Repeat steps 5.c to 5.e for the Update Scheduled Data Import Access task with the Scheduled data import [scheduled_data_set] table.
Select Update to save the scheduled data import access details.
Set the Update Scheduled Data Import Access task to complete by selecting Mark as Complete, and then select Continue.
In the Add Another Connection section, modify the application scope to Service Graph Connector for Trellix by using the application picker.
Select Click Here.
On the Workflow Studio page, select Add Connection in the SGTrellix section.
Fill in the fields on the Create Connection form, and then select Create Connection.
| Field | Description |
|---|---|
| Connection name | Name to identify the Trellix connection record. |
| Connection url | URL of the connection. |
| Use MID server | Option to use a MID Server. Select this check box if you're using an on-premises instance of Trellix. Complete the Advanced MID Server Configuration.Note: A MID Server must be configured on your ServiceNow instance before you select this option. |
| MID selection | Select a MID Server from the list.This field appears only when the Use MID Server check box is selected. |
| MID application | Select a MID Server application from the list.This field appears only when the Use MID Server check box is selected. |
| User name | User name of your Trellix account. |
| Password | Password of your Trellix account. |
15. Close the Workflow Studio page, and navigate back to the guided setup.
16. Set the Add Another Connection task to complete by selecting **Mark as Complete**, and then select **Continue**.
17. In the Test New Connections section, select the newly created connection record, and then select the **Test Connection** related link.
Testing the connection might take a few moments. The page is refreshed to show the test results.
18. When the **Status** field is set to **Success**, set the Test New Connections task to complete by selecting **Mark as complete**, and then select **Continue**.
If any of the tests have errors, follow the suggestions for remediation.
Configure the scheduled jobs to import data from the Trellix application.
On the Service Graph Connector for Trellix page, in the Set up scheduled import jobs section, select Start.
For the Configure the scheduled jobs task, select the connection.
Note: The SG-Trellix-Devices scheduled import job is set to inactive by default.
On the Scheduled Data Import form, verify the field values for the scheduled job.
For more information, see Schedule a data import.
Select the Active check box to activate the SG-Trellix-Devices scheduled import job.
In the Run field, select Periodically to specify how often the job runs.
Select Execute Now to execute the import schedule.
Set the Configure the scheduled jobs task to complete by selecting Mark as complete, and then select Continue.
On the Service Graph Connector for Trellix page, select Exit to exit the guided setup.
Related topics
Service Graph Connector for Trellix
CMDB classes targeted in Service Graph Connector for Trellix
Accessing the connection details of Service Graph Connector for Trellix