Connecting to data sources

To be able to stream data to IBM Security Guardium® Insights for analysis, you first need to connect to your data sources.

Before you begin

Ensure that Guardium Insights supports the data source environment that you will connect to.

If you are connecting to data sources for the first time, Guardium Insights guides you through your first connections as part of the getting started experience. To add more data sources (or work with data sources that are already defined), click Connections in the Settings menu (main menu).

Procedure

  • The Connections page lists all of the connections that you have created.
    1. You can filter this view by opening the Filter panel (select the filter criteria and then click Apply filters).
    2. To customize the columns in the table, click the Customize columns button. Then, in the Customize columns dialog box, select all columns that you want to display in the table - and drag and drop the columns to reorder them. Click Done when you are finished.
  • If you have filtered the table or customized its columns, you can save these settings by creating a Preset view. When you click a preset view, the table changes to reflect the filter and columns. Guardium Insights provides two default preset views: All connections and All unhealthy connections.
    To create a new preset view, filter the list of connections and organize the columns as desired, and then click New preset view. Give the preset card a unique name and a description, if desired. You can also set the preset view to default.

    Each preset view card has a menu with actions that allow you to rename the card, reorder the cards, and remove the card. Non-default cards also include an action to make the card default.

    If you are viewing a preset view and you change the table filter or modify its columns, the preset card will prompt you to save the modifications that you have made (click Modify).

  • To create a new connection, click Add connection to open the Connect new data source page. This page lists all of the currently-supported data sources.
  • Select the data source to connect to. This opens a panel that aids you in initiating the connection:
    1. Select data source environment: Select the environment that hosts your data source.
    2. Select connection method: Select the type of connection that you want to create.
    3. Other options: If your data source requires additional options, select them here.
    4. The remainder of the panel provides Additional information about the connection type that you are creating.
  • After reading the Additional information, you have one of these options:

What to do next

After you add a data source, it is scanned almost immediately. You can use these actions to work with connections:

  • To delete a connection, select its checkbox, and click Remove in the banner that opens. You can select multiple connections and remove them with this button.
  • To edit a connection, select its Connection name link in the table. This opens a panel that allows you to Enable or Disable the connection. In addition, you can see the status of the connection and edit its configurations.
  • To export a CSV list of the connections in the table, click Export CSV. This will export a list of only the connections that are currently in the table - it will not include any that have been filtered out.
  • To refresh the list of connections, click Refresh.