Add or Edit Upstream Connectors
Note: Upstream Connectors are a DefectDojo Pro-only feature.
The process for adding and configuring an Upstream Connector is similar, regardless of the tool you’re trying to connect. However, certain tools may require you to create API keys or complete additional steps.
Before you begin this process, we recommend checking our Tool-Specific Reference to find the API resources for the tool you’re trying to connect.
If you haven’t already, start by switching to the Pro UI in DefectDojo.
From the left-side menu, open the Connectors group nested under the Import header, and click Upstream Connectors.
Choose a new Connector you want to add to DefectDojo in Available Connectors, and click the Add Configuration button on the tool’s tile. You can use the Search Connectors box to filter each section by tool name, or the All / Asset / Finding toggle in the page header to filter by connector type.
You can also edit an existing Connector under the Configured Connectors header. Click Manage Configuration > Edit Configuration for the Configured Connector you want to Edit.
You will need an accessible Location URL for the tool, along with an API Secret key. The location of the API key will depend on the tool you are trying to configure. See our Tool-Specific Reference for more details.
Set a Label for this connection to help you identify it in DefectDojo.
Schedule the Connector’s automatic discovery and sync using the Discovery Configuration and Synchronization Configuration schedules. These can be changed later.
Select whether you wish to Enable Auto-Mapping. Enable Auto-Mapping will create a new Product in DefectDojo to store the data from this connector. Auto-Mapping can be turned on or off at any time.
Click Submit.
Next Steps
- Now that you’ve added a connector, you can confirm everything is set up correctly by running a Discover operation.