Configuring Integration Modules

Cisco SecureX offers integration modules for Cisco security products and third-party solutions. You must configure the module for your product integrations, so the data (and response actions if applicable) are available in SecureX. This topic describes the overall process for how to configure a new integration module for your product.

Note: Only Admin users can add integration modules. The Add or Enable button is not visible if you are logged in as a non-admin user.

Use the Integration Modules tab on SecureX menu bar to configure and view your integration modules, and to view all integration modules that are available for configuration.

Integration Modules

You can view the integration modules you have configured on the My Integration Modules page and view all integration modules that are available for configuration on the Available Integration Modules page.

A Bidirectional icon on the My Integration Modules page indicates that SecureX and the integrating product has bidirectional API communication with each other through the integration module interface.

In SecureX Demo, you can view all the integration modules that are available for configuration to activate SecureX on the Integration Modules page.

Demo Integration Module

Prerequisite: If your product is an on-premises device, it must be registered in Security Services Exchange before configuring the integration module. See Configure Devices.

  1. Click the Integration Modules tab on the SecureX menu bar.

    Available Integration Modules

    You can filter the modules that are displayed on the page based on capability. You can also search for modules that are displayed on the page based on integration module name and description.

    Note: If you are an unactivated user in SecureX Demo, the Integration Modules page lists the available integration modules only.

  2. On the Available Integration Modules page, navigate to the integration module you want to configure and click Add or Enable in the module panel. If you are on the My Integration Modules page, click Add New Integration Module to open the Available Integration Modules page.

    Add New Module

    Note: If you click Enable, the configuration and activation of the integration module is completed within the integrating product. Once enabled, it is automatically integrated in SecureX and the integration module is displayed on the My Integration Modules page with a Bidirectional icon. You do not need to complete the remaining steps.

    In SecureX Demo, navigate to the integration module you want to configure and click Enable in the module panel.

  3. Complete the Add New Integration Module or Enable Module form, following the instructions in Quick Start panel.

    Add New Module Form

  4. Click Save to add the integration module.

    A health check is performed to determine if the module was properly configured. A message is displayed in the upper portion of the form (the form changes to Edit Module since it’s been saved) indicating that the health check is running. Once it completes, a message displays indicating that either there were no issues with the configuration or that errors were found.

    Health Check

    If errors occur, correct the configuration and click Save.

  5. Click Cancel to exit the form.

    The module is displayed on the My Integration Modules page and shows whether it is Integrated or if there are Errors with the configuration.

Filter Integration Modules

On the Available Integration Modules page, click the Filter by Capability drop-down and check the check boxes next to the capability to filter the modules that are displayed on the page.

Filter Modules

The modules that match your selections are displayed on the page. For more information on the capabilities, see Integration Modules.

Search Integration Modules

Enter the search criteria in the Search Integrations text box on the Available Integration Modules or My Integration Modules page to search for integration modules by integration module name and description. The integration modules that match your search criteria are displayed on the Available Integration Modules or My Integration Modules page.

Update Integration Modules

All integration modules configured for your environment are shown on the My Integration Modules page. The module panel indicates whether the module is Integrated (successfully configured) or if it has an Error with the configuration. If it has errors, you can edit the module:

  1. On the My Integration Modules page, click Edit in the module panel. The Edit Integration Module form opens with the current integration module settings.

  2. Edit the settings as needed, and click Save.

    A health check is performed to determine if the module was properly configured. A message is displayed in the upper portion of the Edit Integration Module form indicating that the health check is running. Once it completes, a message displays indicating that either there were no issues with the configuration or that errors were found.

  3. Click Cancel to exit the form.

Delete Integration Modules

  1. On the My Integration Modules page, click Edit in the module panel. The Edit Integration Module form opens with the current integration module settings.

  2. Click Delete.

  3. On the confirmation dialog, click Delete.

    The integration module is removed and its data is no longer available.

More Information

  • Integration Modules - Learn more about product integrations and specific instructions for adding your product as a module in SecureX.
  • Devices - Learn more about configuring your product prior to adding the integration module.