How do I integrate with TOPdesk?

If you want Security Center to create tickets for vulnerabilities in TOPdesk, follow these step-by-step instructions. Once connected, ticket status is synchronized between the two systems, and tickets are closed automatically when a scan confirms that a vulnerability is fixed.

Before you begin, you need to prepare TOPdesk. The integration uses a dedicated API account with its own operator group, permission group and application token.

Create an operator group in TOPdesk

1. Log in to TOPdesk.
2. Go to Supporting Files > Operator groups and click New.
3. Enter a group name, for example Holm Security API, and select a Branch.
4. Under Tasks, select First line call operator and Second line call operator.
5. Click Save.

Create a permission group in TOPdesk

1. Go to Supporting Files > Permission groups and click New.
2. Enter a name, for example Holm Security API.
3. Under Call Management, select Read, Write, Create and Archive for Second line calls.
4. Under Supporting Files, select Read for:
   1. Persons
   2. Person groups
   3. Operators
   4. Operator groups
   5. Suppliers
   6. Supplier contacts
   7. Branches
   8. Locations
5. Under API Access, select Read for REST API and Write for Use application tokens.
6. Click Save.

Create an API account and application token in TOPdesk

1. Go to Supporting Files > API accounts and click New.
2. Enter a surname, for example Holm Security API, and select a Branch.
3. Under TOPdesk Account, enter a Login name, for example HOLM.SECURITY, and select Has access.
4. Under Tasks, select First line call operator and Second line call operator.
5. On the Operator groups tab, add the operator group you created.
6. On the Permissions tab, add the permission group you created.
7. Click Save.
8. Under Application tokens, click Add, enter an application name such as Holm Security, and copy the token.

Connect TOPdesk in Security Center

1. Log in to your Security Center.
2. Click the menu icon in the top right corner and select Integrations.
3. Click Configure on TOPdesk.
4. Enable the toggle to activate the integration.
5. Under Credentials, enter:
   1. Username: the login name of the API account, for example HOLM.SECURITY
   2. Password: the application token
   3. URL: your TOPdesk URL, for example https://yourcompany.topdesk.net
6. Click Establish connection.
7. Map the ticket statuses to your TOPdesk statuses and select the operator group you created.
8. Click Update settings.
9. Done!