Managing connectors

Connectors link Monad to your security tools, information systems, communication tools, and data warehouses. They’re how you get data into, and out of the Monad platform.

There are two main types of connectors: inputs, and outputs.

  • Input connectors are how you get data into Monad from your security tools, and from data sources that provide contextual and supporting information about your organization.
  • Output connectors allow you to send your data to your communications and productivity tools, and to data warehouses for later analysis.

Workspace administrators can add, edit, and remove connectors. Normal users in the workspace have read-only access and can view a connector’s sync status, but they cannot make changes or restart the sync process.

Adding a connector

Administrators can add connectors from any page in the Connectors section.

  1. Click Add connector at the top right of the page.
  2. In the list that appears, select the connector you want to add.
  3. In the dialog that appears, review the Name field, and optionally change it. This field is the display name that appears on your Monad workspace’s Map view, and Monad sets it to the connector tool’s name by default. If you have more than one instance of a connector type, for example two Qualys connectors, edit the Name field so you can tell them apart.
  4. Enter authentication information for the connector you chose. Monad tells you briefly what each connector needs to connect to Monad, and provides a link to more detailed instructions if you want them. It’s a good idea to read the detailed docs so you can make sure the connector has the correct permissions.
  5. Click Connect.

Monad tests the connection to the external service, and if it is able connect, begins a data sync.

Editing a connector

Administrators can edit connectors. Use this to update the connector’s settings in Monad if the authentication information for the tool changes, for example if you rotate access tokens, or create a new role ARN. You can also edit a connector to change the display name if you have more than one of a certain type of connector.

To edit an existing connector:

  1. From the Monad Map view, click the connector you want to edit.
  2. On the connector’s details page, click the gear icon, and select Edit connector.
  3. Edit the connector information, and click Update.

If you changed the authentication information, Monad tests the connection to the external service and starts a new data sync. (Monad skips this if you just changed the connector’s name.)

Setting the connector schedule

When adding a connector you can choose how often you would like it to synchronise (Weekly, Daily, 12 hours, 8 hours, 4 hours) and optionally the time it should start this frequency.

Good to know: You can set the Sync Frequency to ‘Never’ to ensure the connector does not auto-sync. It can still be manually run via the “Sync Now” option in the connector overview.

Output connector Model Export

Output connectors allow you the option of which models (groups of database tables) to export. By default, the Monad Object Model (MoM) will be exported but there are options for other enrichment sets available. The data models you select will be placed in your data warehouse by this output connector.

Removing a connector

Administrators can delete connectors to permanently remove them from the workspace. This deletion cannot be undone.

Good to know: If you delete an input connector, Monad does not delete any of the data that came from that connector.

To delete a connector:

  1. From the Map view, click the connector you want to delete.
  2. Click the gear icon at the top right, and select Delete connector.
  3. Click Yes to confirm the deletion.

This page was last modified: 23 Oct 2023