Explore Cisco
How to Buy

Have an account?

  •   Personalized content
  •   Your products and support

Need an account?

Create an account

Cisco SecureX Getting Started Guide

Bias-Free Language

The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.

Book Contents
Find Matches in This Book
Available Languages
Download Options

Book Title

Cisco SecureX Getting Started Guide

Chapter Title

Configuration

Results

Updated:
December 8, 2021

Chapter: Configuration

Configuration

This chapter provides instructions for configuring your Cisco SecureX environment, including:

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 section 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 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.

Figure 1. Integration Modules

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

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

Figure 2. Integration Modules in SecureX Demo

Note

If your product is an on-premises device, it must be registered in Security Services Exchange before configuring the integration module. See your specific product documentation for configuring devices prior to adding the integration module in SecureX.

Add Integration Module

Perform the following steps to add an integration module:

Procedure

Step 1

Log in to Cisco SecureX.

Step 2

Click the Integration Modules tab on the SecureX menu bar.

Figure 3. 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.

Step 3

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.

Figure 4. 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.

Step 4

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

Figure 5. Add New Module Form
Step 5

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 messsage displays indicating that either there were no issues with the configuration or that errors were found.

Figure 6. Health Check

If errors occur, correct the configuration and click Save.

Step 6

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 drop-down and check the check boxes next to the capability to filter the modules that are displayed on the page.

Figure 7. Filter by Capability

The modules that match your selections are displayed on the page.

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.

Updating 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.

Perform the following steps to edit an integration module:

Procedure

Step 1

Log in to Cisco SecureX.
Step 2

Click the Integration Modules tab on the SecureX menu bar.

Step 3

Navigate to the module on the My Integration Modules page and click Edit in the module pane. The Edit Integration Module form opens with the current integration module settings.

Step 4

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 Module form indicating that the health check is running. Once it completes, a messsage displays indicating that either there were no issues with the configuration or that errors were found.

Step 5

Click Cancel to exit the form.

Deleting Integration Module

All modules associated with your account shown on the My Integration Modules page. You can delete an integration module, and all data from that integration will no longer be available.

Perform the following steps to delete an integration module:

Procedure

Step 1

Log in to Cisco SecureX.
Step 2

Navigate to the module on the My Integration Modules page and click Edit in the module panel. The Edit Module form opens with the current integration module settings.

Step 3

Click Delete.

Step 4

On the confirmation dialog, click Delete.

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

Note 

If you are deleting an integration module with a Bidirectional icon, ensure that the integration is also disabled in the integrating product.

Configuring Dashboard Tiles

The Tiles panel in the center of the Cisco SecureX dashboard presents metrics and data from the integrated products to provide visibility across your security environment and accelerate threat response. After you have added your integrations in SecureX, the tiles that are provided by the underlying products are available to add to your dashboard. If you enabled the option to automatically create a shared dashboard of all the tiles associated with the integration module, a shared dashboard is automatically created and displayed on the SecureX dashboard for all users.

You can create up to 20 dashboards (see Adding or Removing Dashboards)) and add tiles to customize your view. For example, you may want a dashboard for each integration module, with tiles specific to that integration.

Figure 8. Dashboard Tiles

Adding Tiles to Dashboard

If there are no dashboards configured, you must add the tiles that you want to be displayed on the dashboard.

Procedure

Step 1

In the Tiles panel in the center of the dashboard, click Add Tiles.

Figure 9. Add Tiles
Note 

The Add Tiles button is only visible until you have configured a dashboard.

You can also click the Customize button on the dashboard menu bar to add, modify, and delete the tiles on a dashboard, to share dashboards, and to create new dashboards and reorder them.

Figure 10. Customize Dashboards
Step 2

Use the default Dashboard Name or enter a unique name (the dashboard name is required and must be unique with a maximum of 32 characters).

Step 3

Expand the integration module name and check or uncheck the check boxes for the tiles to be displayed on the dashboard.

You can also click the Add All (to check all check boxes) or Remove All (to uncheck all check boxes) toggle for the specific integration module.

Note 

To update the list of tile definitions, click Refresh Tiles.

The number of tiles selected is displayed in parenthesis, next to the integration module name.
Step 4

If you are an Admin user, you can click Share in the right panel to share the dashboard with other users within your organization. For more information on shared dashboards, see Sharing Dashboards.

Step 5

To add more dashboards, click Create Dashboard and repeat the process.

Step 6

Optionally, reorder the newly created dashboards to the position you want them to appear on the SecureX dashboard. To reorder the dashboards, click and drag the dashboard in the left panel to the desired position in the list.

Step 7

Click Save to complete the process.

After the tiles are added, you can resize and move them around to the desired position on the SecureX dashboard.

Modifying Tiles on Dashboard

You can rename your dashboard, add tiles, or remove tiles. Perform the following steps to modify the tiles that display on your dashboard:

Procedure

Step 1

On the SecureX dashboard menu bar, click Customize to open the Customize Dashboard form.

Step 2

Choose the dashboard in the left panel.
Step 3

Make your modifications:

  • Dashboard Name - You can modify the name of the dashboard. The dashboard name is a required field and must be unique with a maximum length of 32 characters.

  • Available Tiles - Check (to add) or uncheck (to remove) the check boxes for the tiles to be displayed on the dashboard.

    You can also click the Add All (to check all check boxes) or Remove All (to uncheck all check boxes) toggle for the specific integration.

Step 4

If the dashboard is shared, you can click Share in the right panel to update the dashboard with your changes. Other users who are sharing the dashboard will be able to synchronize your edits to their shared version.

Note 

Only Admin users can share dashboards.
Step 5

Click Save.

Deleting Tiles on Dashboard

To remove a tile from the selected dashboard, you can simply click the Settings icon in the upper right corner of the tile and choose Remove Tile.

You can also remove tiles from the Customize Dashboards form:

Procedure

Step 1

On the SecureX dashboard menu bar, click Customize to open the Customize Dashboards form.

Step 2

Choose the dashboard in the left panel.
Step 3

Expand the integration module name and uncheck the check boxes for the tiles to be removed from the dashboard.

You can also click the Remove All (to uncheck all check boxes) for the specific integration module.

Step 4

If the dashboard is a shared, you can click Share to update the shared dashboard with your changes. Other users who are sharing the dashboard will be able to synchronize your edits to their shared version.

Note 

Only Admin users can share dashboards.
Step 5

Click Save.

Configuring Dashboards

You can create multiple dashboards (up to 20) in Cisco SecureX to customize your view of the data provided by your integration modules. You can also share dashboards, reorder how the dashboards are displayed, and remove dashboards.


Note

Only Admin users can share dashboards.

Adding Dashboards

You can create up to 20 dashboards to customize your views.

Procedure

Step 1

On the SecureX dashboard menu bar, click Customize to open the Customize Dashboards form.

Figure 11. Customize Dashboards
Step 2

Click Create Dashboard and enter a unique Dashboard Name.

Note 

The dashboard name is a required field and must be unique, with a maximum length of 32 characters.
Step 3

Expand the integration module name in the Available Tiles list, and check the check boxes for the tiles to be added to the dashboard.

You can also click the Add All (to check all check boxes) or Remove All (to uncheck all check boxes) toggle for the specific integration module.

Note 

To update the list of tile definitions, click Refresh Tiles.

The number of tiles selected is displayed in parenthesis, next to the integration module name.
Step 4

If you are an Admin user, click Share in the right panel if you want to share the new dashboard with other users within your organization. For more information on shared dashboards, see Sharing Dashboards.

Step 5

To add more dashboards, click Create Dashboard and repeat the process.

Step 6

Optionally, reorder the newly created dashboards to the position you want them to appear on the SecureX dashboard. To reorder the dashboards, click and drag the dashboard in the left panel to the desired position in the list.

Step 7

When you have completed adding dashboards and/or reordering them, click Save.

The new customized dashboards are displayed on the SecureX dashboard.

Adding Shared Dashboards

You can add dashboards shared by Admin users within your organization to the My Dashboards list for a customized view of the pre-defined tiles. Once added, a Sync to Original icon appears in the right panel for you to synchronize the dashboard with the latest version of the original dashboard.

For more information on shared dashboards, see Sharing Dashboards.

Procedure

Step 1

On the SecureX dashboard menu bar, click Customize to open the Customize Dashboards form.

Step 2

In the Shared Dashboards list, click the add (+) button next to the dashboard you want to add to your list of dashboards in the My Dashboards list.

A copy of the shared dashboard is added to the My Dashboards list.

Step 3

You can optionally make changes to the newly added shared dashboard by modifying the name and/or tiles.
Step 4

When you have completed adding shared dashboards, click Save.

Modifying Dashboards

You can modify the dashboard name and the tiles that are displayed on it using the Customize button on the menu bar.

Procedure

Step 1

On the SecureX dashboard menu bar, click Customize to open the Customize Dashboards form.

Step 2

Make your modifications; you can modify the Dashboard Name (the name must be unique), add or remove tiles to be displayed on the dashboard (see Configure Dashboard Tiles), and reorder the dashboards.

Step 3

Click Save.

Reordering Dashboards

You can reorder how the dashboards appear on the menu bar using the Customize button on the SecureX dashboard:

Procedure

Step 1

On the SecureX dashboard menu bar, click Customize to open the Customize Dashboards form.

Step 2

In the My Dashboards list, click and drag the dashboard to the desired position in the list.

Step 3

When you have completed reordering the dashboards, click Save.

Deleting Dashboards

Use the Customize button on the SecureX dashboard to delete dashboards:

Procedure

Step 1

On the SecureX dashboard menu bar, click Customize to open the Customize Dashboards form.

Step 2

Choose the dashboard in the My Dashboards list and click Delete.

A confirmation message is displayed in the lower portion of the form.
Step 3

Click Delete to confirm the action.

If the deleted dashboard is a shared dashboard, the dashboard is removed from My Dashboards list, but it continues to be shared in the Shared Dashboards list.

Sharing Dashboards

Admin users can share dashboards with other users within an organization.

Procedure

Step 1

On the SecureX dashboard menu bar, click Customize to open the Customize Dashboards form.

Figure 12. Customize Dashboards
Step 2

In the My Dashboards list, choose the dashboard you want to share with other users within your organization.

Step 3

Click Share in the right panel.

The dashboard is added to the Shared Dashboards list.

Step 4

When you have completed sharing dashboards, click Save.

To display the selected tiles for each dashboard, select the dashboard in the Shared Dashboards list.

Activating Orchestration

Before workflow automation is available in Cisco SecureX, an organization Administrator must activate SecureX orchestration for their organization. Once it is activated, all users in that organization have access to the Orchestration tab and the workflow automation features.

Procedure

Step 1

In SecureX, click the Orchestration tab on the menu bar.

Step 2

On the SecureX Orchestration page, click Request Access.

A message is displayed informing you that your request has been received and that you will be notified via email when access is available.

Note 

If you are an unactivated user in SecureX Demo, you must click Get Started to activate your SecureX account by enabling an integration module before you can activate Orchestration.

Step 3

Click Back to SecureX Dashboard to return to the dashboard.

Inviting Users

You can invite users to join your organization via Cisco SecureX if you are logged in with a SecureX account as an Admin user. Use the Users tab on the Administration page to manage the users in your Cisco SecureX organization and to invite users to join your SecureX organization.

Procedure

Step 1

In SecureX, click the Administration tab and choose Users in the navigation pane.

Step 2

Click Invite Users.

Figure 13. Invite New Users
Step 3

Complete the Invite New Users form:

  1. Choose User or Admin from the User Role drop-down list.

  2. Enter the Email address for the person you want to invite to your organization's SecureX account.

  3. Click Add to add the user to the invitation. Repeat the process to add additional users to the invitation.

Step 4

Once you have completed adding users to the invite list, click Send Invites.

The user will receive an email notifying them that they have been invited to join your Cisco SecureX organization's account. They should follow the instructions in the email to log in to Cisco SecureX.

Was this Document Helpful?

FeedbackFeedback

Contact Cisco