Set up IoT Security and XSOAR for BlueCat Integration
Set up IoT Security and Cortex XSOAR to integrate with BlueCat.
To set up IoT Security to integrate through Cortex XSOAR with a BlueCat Address Manager, you must add an XSOAR engine to your network.
You must also configure Cortex XSOAR with a BlueCat IPAM integration instance and a job to periodically collect IPAM data from the BlueCat Address Manager. To do this, you need the IP address or hostname of the BlueCat Address Manager API and the username and password of the read/write user account that the XSOAR engine will use when forming a secure connection with it.
XSOAR Engine Installation
An on-premises XSOAR engine facilitates communications between the Cortex XSOAR cloud and a BlueCat Address Manager. Although it's possible to install an XSOAR engine on machines running Windows, macOS, and Linux operating systems, only an engine on a Linux machine supports IoT Security integrations. For more information about operating system and hardware requirements, see the Cortex Administrator’s Guide.
We recommend downloading the XSOAR engine using the shell installer script and installing it on a Linux machine. This simplifies the deployment by automatically installing all required dependencies and also enables remote engine upgrades.
When placing the XSOAR engine on your network, make sure it can form HTTP or HTTPS connections to the API of your BlueCat Address Manager.
The firewall must allow the engine to form HTTPS connections on TCP port 443 to the Cortex cloud at https://<your-domain>.iot.demisto.live/. You can see the URL of your XSOAR instance when you log in to the IoT Security portal and click
. It’s visible in the address bar of the web page displaying the XSOAR interface.
Launch Cortex XSOAR
To create an XSOAR engine, access the Cortex XSOAR interface (from the IoT Security portal, click
Launch Cortex XSOAR
+ Create New Engine
Shellas the type.
For installation instructions, see Install Cortex XSOAR Engines.
IoT Security and Cortex XSOAR
- Log in to IoT Security and from there access BlueCat IPAM settings in Cortex XSOAR.
- Log in to IoT Security and then clickIntegrations.
- IoT Security uses Cortex XSOAR to integrate with a BlueCat Address Manager, 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.
- Click Settings in the left navigation menu, search forbluecatto locate it among other instances.
- Configure the BlueCat IPAM integration instance.
- ClickAdd instanceto open the settings panel.
- Enter the following settings:Name: Use the default name of the instance or enter a new one.Remember the instance name because you are going to use it again when creating a job that Cortex XSOAR will run to gather IPAM data from the BlueCat Address Manager specified in this instance.Server URL: Enter the IP address or hostname of the BlueCat Address Manager, preceded byhttp://orhttps://, depending on your Address Manager configuration. For example,https://bluecat1.acme.com.Username: Type the name of the user account that you previously created in the BlueCat Address Manager UI for the XSOAR engine to use when connecting to the BlueCat API.Password: Type the password associated with the user account.Run on Single engine: Choose the XSOAR engine that you want to communicate with this BlueCat Address Manager.
- When finished, clickTest.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.
- Create a job for XSOAR to query the BlueCat Address Manager for IPAM data about its subnets and blocks (referred to asnetworksandblocksby BlueCat) and send them to IoT Security.
- Copy the name of the BlueCat IPAM integration instance you just created, clickJobsnear the bottom of the left navigation menu and then clickNew Jobat the top of the page.
- In the New Job panel that appears, enter the following and leave the other settings at their default values:Recurring: Select this if you want to periodically import the BlueCat Address Manager for IPAM data. Leave it unselected to run the bulk data import job manually.Every: If you selectRecurring, enter a number and set the interval value (Minutes, Hours, Days, or Weeks) and select the days or time of day to run the job. (If you don’t select specific days, then the job will run everyday by default.) This determines how often and when XSOAR queries the BlueCat Address Manager. For example:1 dayand2:00Name: Enter a name for the job.Playbook: ChooseBulk Import of subnet network info from BlueCat IPAM to PANW IoT Cloud.Import IPAM site definitions to IoT Security: Because BlueCat Address Manager does not support the concept of sites, this setting is ignored.Integration Instance Name: Paste the instance name you copied a few moments ago.Overwrite non-site data when an IP block or subnet is the same in IPAM and IoT Security: Non-site data for an IP block or subnet consists of its name and, for subnets, its gateway IP address. SelectYesif you want BlueCat non-site data to overwrite IoT Security data when there are matching IP blocks and subnets. SelectNoif you don’t want BlueCat non-site data to overwrite IoT Security data.Overwrite site data when a root block is the same in IPAM and IoT Security: Because BlueCat Address Manager does not support the concept of sites, this setting is ignored.
- ClickCreate new job.
- Enable the job and run it.
- Check the Job Status for the job you created. If it’sDisabled, select its check box and then clickEnable.
- After you enable it, keep the check box selected and clickRun now. The Run Status changes fromIdletoRunning.If you configured the job to be run manually, it begins immediately. If you configured it to recur at a defined interval, it will start at the time you set. When it does start, XSOAR queries the BlueCat Address Manager for IPAM data, which it then forwards to the IoT Security cloud.
- If you created more integration instances for multiple BlueCat Address Managers, add more instances as necessary.Each BlueCat IPAM instance requires a separate job.
- When done, return to the IoT Security portal and check the status of the BlueCat IPAM integration.Four states can appear in the Status column on the Integrations page.
When you see that its status isActive, the setup for IoT Security/Cortex XSOAR integration with BlueCat IPAM is complete.
- Disabledmeans that either the integration was never configured (its default state) or it was configured but intentionally disabled.
- 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.
Recommended For You
Recommended videos not found.