Introduction

This document provides the step-by-step procedure to configure Zendesk in SAFE.

SAFE integrates with Zendesk and fetches the security misconfiguration of the Zendesk account in SAFE.

Prerequisites

• Access required in SAFE:
  • SAFE Admin Access
• Access required in Zendesk:
  • Zendesk Admin
• Required User Inputs:
  • API URL
  • Username
  • API Token
  • Asset Name in SAFE (optional)
• Required Scope:
  • Admin Access

Generate Connection Details

Generate an API Token

Steps:

1. Log in to your Zendesk account as Admin.
2. Click on the Setting icon on the left panel.

3. Click the Go to Admin Center option.

4. Navigate to Apps and Integrations.
5. Click on Zendesk API.

6. Click the Add API token button.

7. Enter the API token description.
8. The system displays the API token. Copy and save the API token to use it while configuring Zendesk in SAFE.

9. Click the Save button.

9. Notice: Regularly update the API Token in SAFE according to its expiration date.

How to get API URL

Steps:

• Log in to your Zendesk account as Admin.

• In the exhibit provided, find the URL highlighted. Copy and save this API URL to use it while configuring Zendesk in SAFE.

Configure Zendesk in SAFE

Steps:

1. Log in to your SAFE account as Admin.
2. Click on the Integrations option from the left navigation.

3. Scroll to find the Zendesk integration card or use the search bar to locate it.

4. Hover over the Zendesk integration card and click on the Configure button.

5. Enter the following properties parameters:

   • API URL
   • Username
   • API Token
   • Asset Name in SAFE (optional): Provide a unique identifier which can uniquely identify the asset.
6. Enter the Auto Sync Frequency.
7. Click on the Test Connection button to verify the integration.

8. Once the connection is successful, click on the Save button.

9. Once the configuration is saved successfully, click on the Sync Now button to trigger an on-demand sync.

9. Notice: Upon a successful sync, the system pulls the Zendesk assets and their findings into SAFE. You can track the status of the sync in the History table.

View Results

Navigate to the baseline integration parameters window block to check operational data results:

• Finding View: This tab displays all the findings details pulled from Zendesk.

• Asset View: This tab displays all the assets pulled from Zendesk.

To check sync status and errors for this integration, see Integration History.

Did this article help?

Let us know by leaving a star rating at the top of this article.