Configure IoT Security and Cortex XSOAR

1. Log in to IoT Security and from there access Infoblox IPAM settings in Cortex XSOAR.

   1. Log in to IoT Security and then click Integrations.

   2. IoT Security uses Cortex XSOAR to integrate with Infoblox Grid Masters, and the settings you must configure to integrate with it are in the XSOAR interface. To access these settings, click Launch Cortex XSOAR.
      The Cortex XSOAR interface opens in a new browser window.
   3. Click Settings in the left navigation menu, search for infoblox to locate it among other instances.

2. Configure the Infoblox IPAM integration instance.

   1. Click Add instance to open the settings panel.
   2. 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 Infoblox Grid Master specified in this instance.
      Server URL: Enter the IP address or hostname of the Infoblox Grid Master.
      Username: Type the name of the user account that you previously created in the Infoblox Grid Manager UI for the XSOAR engine to use when connecting to the Infoblox 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 Infoblox Grid Master.

   3. When finished, click Run test or Test.
      If the test is successful, a Success message appears. If not, check that the settings were entered correctly and then test the configuration again.

   4. After the test succeeds, click Save & exit to save your changes and close the settings panel.
3. Create a job for XSOAR to query the Infoblox Grid Master for IPAM data about its subnets and IP CIDR blocks (referred to as networks and containers by Infoblox) and send them to IoT Security.

   1. Copy the name of the Infoblox IPAM integration instance you just created, click Jobs near the bottom of the left navigation menu and then click New Job at the top of the page.
   2. In the New Job panel that appears, enter the following and leave the other settings at their default values:
      Time triggered: (select)
      Recurring: Select this if you want to periodically import the Infoblox Grid Master for IPAM data. Leave it unselected to run the bulk data import job manually.
      Every: If you select Recurring, 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 Infoblox Grid Master. For example: 1 day and 2:00
      Name: Enter a name for the job.
      Playbook: Choose Bulk Import of subnet network info from Infoblox IPAM to PANW IoT Cloud.
      Import IPAM site definitions to IoT Security: Select Yes to import site definitions along with subnets from Infoblox IPAM into IoT Security. Select No to import subnets without any site data.
      Integration Instance Name: Paste the instance name you copied a few moments ago.
      Use IPAM non-site data if the same block or subnet is in IoT Security: Non-site data for an IP block or subnet consists of its VLAN and description. Select Yes if you want Infoblox non-site data to overwrite IoT Security data when there are matching IP blocks and subnets. Select No if you don’t want Infoblox non-site data to overwrite IoT Security data.
      Use IPAM site data if the same root block is in IoT Security: Select Yes if you want the site data of a root IP block in Infoblox IPAM to overwrite site data for a matching root IP block in IoT Security. Because child and grandchild IP blocks and subnets inherit their site from the root IP block that’s their parent or grandparent, the root block site is the one that decides the site for itself and all those below it. Select No if you don’t want Infoblox site data to overwrite IoT Security site data for a matching root IP block.

   3. Click Create new job.
4. Enable the job and run it.

   1. Check the Job Status for the job you created. If it’s Disabled, select its check box and then click Enable.
   2. After you enable it, keep the check box selected and click Run now. The Run Status changes from Idle to Running.
      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 Infoblox Grid Master for IPAM data, which it then forwards to the IoT Security cloud.
      The first time you run a job, it triggers XSOAR to report the integration instance that the job references to IoT Security, which then displays the instance on the Integrations page.
5. If you created more integration instances for multiple Infoblox Grid Masters, add more jobs as necessary. Be sure to run each job you create at least once to populate the Integrations page in the IoT Security portal with all the integration instances you’re using.

   Each Infoblox IPAM instance requires a separate job.
6. When done, return to the IoT Security portal and check the status of the Infoblox IPAM integration instances.

   An integration instance can be in one of the following four states, which IoT Security displays in the Status column on the Integrations page:

   • Disabled means that either the integration was configured but intentionally disabled or it was never configured and a job that references it is enabled and running.
   • Error means that the integration was configured and enabled but is not functioning properly, possibly due to a configuration error or network condition.
   • Inactive means that the integration was configured and enabled but no job has run for at least the past 60 minutes.
   • Active means that the integration was configured and enabled and is functioning properly.

   When you see that the status of an integration instance is Active, its setup is complete.