---
title: "Zendesk"
slug: "zendesk"
updated: 2024-06-07T04:18:25Z
published: 2024-06-07T04:18:25Z
canonical: "docs.safe.security/zendesk"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.safe.security/llms.txt
> Use this file to discover all available pages before exploring further.

# Zendesk

## **About this document**

---

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

## **Introduction**

---

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:**

---

- Log in to your Zendesk account as **Admin**.
- Click on the **Setting** icon on the left panel.
- Click **Go to Admin Center** option.

![](https://cdn.document360.io/23dc20b8-a989-48c0-8653-f1d3e4abc734/Images/Documentation/1(38).png)
- Navigate to **Apps and Integrations.**
- Click on **Zendesk API**.
- Click the **Add API token**button.

![](https://cdn.document360.io/23dc20b8-a989-48c0-8653-f1d3e4abc734/Images/Documentation/2(35).png)
- Enter the API token description.
- The system displays the API token. Copy and save the API token to use it while configuring Zendesk in SAFE.
- Click the **Save** button.

![](https://cdn.document360.io/23dc20b8-a989-48c0-8653-f1d3e4abc734/Images/Documentation/3(34).png)

> 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.

![](https://cdn.document360.io/23dc20b8-a989-48c0-8653-f1d3e4abc734/Images/Documentation/4(33).png)

## **Configure Zendesk in SAFE**

Steps:

---

- Log in to your SAFE account as **Admin**.
- Click on the **Integrations**option from the left navigation.
- Scroll to find the Zendesk integration card or use the search bar to locate it.

![](https://cdn.document360.io/23dc20b8-a989-48c0-8653-f1d3e4abc734/Images/Documentation/5(33).png)
- Hover over the Zendesk integration card and click on the **Configure** button.
- Enter the following:
  - **API URL**
  - **Username**
  - **API Token**
  - **Asset Name in SAFE**(optional): Provide a unique identifier which can uniquely identify the asset.
- Enter the **Auto Sync Frequency**.
- Click on the **Test Connection** button to verify the integration.
- Once the connection is successful, click on the **Save** button.

![](https://cdn.document360.io/23dc20b8-a989-48c0-8653-f1d3e4abc734/Images/Documentation/6(33).png)
- Once the configuration is saved successfully, click on the **Sync** **Now** button to trigger an on-demand sync.

![](https://cdn.document360.io/23dc20b8-a989-48c0-8653-f1d3e4abc734/Images/Documentation/7(32).png)

> Upon a successful sync, the system pulls the Zendesk assets and their findings in SAFE. You can track the status of the sync in the **History** table.

## **View Results**

Steps:

---

- Go to the **Integrations** homepage.
- Scroll to find the Zendesk integration card or search for Zendesk in the search bar.
- Click on the Zendesk integration card for **Finding View** and **Asset View**.
  - **Finding View:** This tab displays all the findings details pulled from Zendesk.

![](https://cdn.document360.io/23dc20b8-a989-48c0-8653-f1d3e4abc734/Images/Documentation/8(34).png)
  - **Asset View:**This tab displays all the assets pulled from Zendesk.

![](https://cdn.document360.io/23dc20b8-a989-48c0-8653-f1d3e4abc734/Images/Documentation/9(33).png)

## **History**

Learn More about Integration History [here](https://docs.safe.security/safe-4/docs/integration-history).

---

## **SAFE's Outgoing IP Addresses**

---

Click [here](https://docs.safe.security/safe-4/docs/safes-outgoing-ip-addresses) to find the outgoing IP addresses of SAFE. All traffic to any integrations in SAFE will see one IP address as the source IP of the incoming connection.

<input spellcheck="false" tabindex="0" class="labels__input" style="font:inherit;width:156.25px;color:inherit;background:0px center;opacity:1;grid-area:1 / 2;min-width:2px;border:0px;margin:0px;outline:0px;padding:0px;" id="react-select-8-input" type="text" value="" autocomplete="off" data-display="block">