Set up IoT Security and XSOAR for ServiceNow Integration
Set up IoT Security and Cortex XSOAR to integrate with ServiceNow.
To set up IoT Security to integrate with ServiceNow, you need the URL of your ServiceNow instance and the username and password of a ServiceNow user account that allows XSOAR to add device attributes, security alerts, and device vulnerabilities to the device and incident tables you created in ServiceNow.
- Log in to the IoT Security portal and then access ServiceNow settings in Cortex XSOAR.
- Log in to IoT Security and then clickIntegrations.
- IoT Security uses Cortex XSOAR to integrate with ServiceNow, and the settings you must configure to integrate with it are in the XSOAR interface. To access these settings, clickLaunch Cortex XSOAR.The Cortex XSOAR interface opens in a new browser window.
- ClickSettingsin the left navigation menu, search forservicenowto locate it among other instances.
- Configure the ServiceNow integration instance.
- Click the integration instance settings icon ( ) for PANW IoT 3rd Party ServiceNow Integration Instance to open the settings panel.Do not change the default integration instance name (PANW IoT 3rd Party ServiceNow Integration Instance). XSOAR jobs for ServiceNow use playbooks that refer to this integration instance name specifically
- Scroll down until you reach the section with the ServiceNow URL, Username/Client ID, and Password fields.
- Fill in these three fields with the URL of the ServiceNow instance and the username and password of the user account you created in ServiceNow. Leave the other settings at their default values.
- When finished, clickRun testorTest.If the test is successful, a Success message appears. If not, check that the settings were entered correctly and then test the configuration again.
- After the test succeeds, clickSave & exitto save your changes and close the settings panel.
- If you want to convert the device category names that IoT Security sends to ServiceNow to match those that ServiceNow uses, create category name mappings.In XSOAR, map the names for IoT Security device categories to those in ServiceNow. You must define these mappings in the two jobs that XSOAR uses to send device attributes to ServiceNow.
- ClickJobsand then search forservicenow. XSOAR displays two jobs:PANW IoT Bulk Export To ServicenowandPANW IoT ServiceNow integration.
- SelectPANW IoT ServiceNow integration, and then clickEdit.
- Scroll down to the Custom Fields section and find the PANW-ServiceNow-Category-Map table.
- Click+ Add rowand enter a name in the PANW IoT Category column and its corresponding name in the ServiceNow Category column.
- Continue adding rows and entries in the two columns to map more IoT Security device categories to ServiceNow categories.
- When done, clickUpdate Job.
- Add the same entries to the PANW-ServiceNow-Category-Map table in the PANW IoT Bulk Export To Servicenow job.
- If you use an existing device cmdb table with a different table label or different column labels, set the corresponding table and column names in Cortex XSOAR jobs that send device records to ServiceNow.If you are using the default table and column labels in ServiceNow, skip this step.
- ClickJobs, selectPANW IoT ServiceNow integration, and then clickEdit.
- Edit the default values to match those you used in the ServiceNow table to which XSOAR will send device records.
- When done, clickUpdate Job.
- SelectPANW IoT Bulk Export to ServiceNow, clickEdit, make the same changes there, and then clickUpdate Job.
- To enable the ServiceNow integration instance, clickSettingsand then clickEnablenext to the instance name.
- Return to the IoT Security portal and check the status of the ServiceNow integration.XSOAR automatically runs a preconfigured job for ServiceNow integration and reports the integration instance to IoT Security, which displays it on the Integrations page. The integration instance can be in one of the following four states as shown in the Status column on the Integrations page:
When you see that the integration instance status has changed fromDisabledtoActive, its setup is complete.XSOAR begins an automated process that sends ServiceNow incrementally updated data from IoT Security about changes to device attributes occurring within the last 15 minutes.
- Disabledmeans that either the integration was configured but intentionally disabled or it was never configured and a job that references it is enabled and running.
- Errormeans that the integration was configured and enabled but is not functioning properly, possibly due to a configuration error or network condition.
- Inactivemeans that the integration was configured and enabled but no job has run for at least the past 60 minutes.
- Activemeans that the integration was configured and enabled and is functioning properly.
- Export the IoT device inventory from IoT Security to ServiceNow.Although regular, automated incremental updates are now in progress, ServiceNow doesn’t yet have a complete device inventory from IoT Security. This requires a bulk data export from IoT Security to ServiceNow that you initiate from the XSOAR interface. The process is somewhat time consuming; for example, exporting an inventory of 30,000–40,000 IoT devices can take up to 36 hours.To start the bulk export of the entire device inventory, clickLaunch Cortex Accessto return to the XSOAR interface. ClickJobs, selectPANW IoT Bulk Export to ServiceNow, and then clickRun now.During the bulk export and after the job completes, the automated incremental update will continue running every 15 minutes.
Recommended For You
Recommended videos not found.