How do I integrate with TOPdesk?

This article describes how to set up the integration between Security Center and TOPdesk. Once integrated, vulnerabilities can be automatically converted to tickets in TOPdesk, and ticket status is automatically synchronized between the two systems.

Before you begin

Before setting up the integration, ensure that your TOPdesk operator account has the required permissions. See the related article for more information: What permissions does the TOPdesk integration need?

You will also need your TOPdesk application password. If you have not generated one yet, see the related article for more information: How do I generate my application password for TOPdesk integration?

Set up the integration

Set up the TOPdesk integration in Security Center:

1. Log in to Security Center.
2. Click the menu icon in the top right corner.
3. Click Integrations.
4. Click Configure on the TOPdesk integration.
5. Enable the toggle to activate the integration.
6. Under Credentials, enter the following:
   • Username: your TOPdesk operator username.
   • Password: your TOPdesk application password.
   • URL: your TOPdesk instance URL.
7. Click Establish connection.
8. Once the connection is established, configure the ticket status mapping and operator group assignment using the dropdown menus that appear.
9. Click Update settings.
10. Done!

Automatic ticket status synchronization

Once the integration is active, ticket status automatically synchronizes between Security Center and TOPdesk. When the scanner confirms that a vulnerability no longer exists, the corresponding ticket is automatically closed in both systems with a status of "fixed."

Example workflow

Here is how the integration works in a typical vulnerability remediation scenario:

1. The scanner detects a vulnerability and reports it in Vulnerability Manager.
2. A security engineer reviews the vulnerability and creates a ticket from Security Center.
3. The ticket is created in both the Remediation module and in TOPdesk, with all necessary details included.
4. The responsible team member remediates the vulnerability.
5. A scan is rerun to verify the fix.
6. The scanner confirms that the vulnerability has been resolved.
7. The ticket is automatically closed in both the Remediation module and TOPdesk.

For more information, please contact our customer support.