---
title: "Asana"
slug: "asana"
updated: 2025-04-11T08:25:57Z
published: 2025-04-11T08:25:57Z
---

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

# Asana

## About this document

---

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

## Introduction

---

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

## Prerequisites

---

- Access required in **SAFE**:
  - SAFE Admin Access
- Access required in **Asana**:
  - Asana Admin Access
- Required User Inputs:
  - API URL
  - Organization Name
  - API Token
- Scope:
  - Read Access

## Generate Connection Details

---

- How to get **API Token**
  - Login to your Asana account as **Admin**.

![](https://cdn.document360.io/23dc20b8-a989-48c0-8653-f1d3e4abc734/Images/Documentation/1(20).png)
  - Navigate to the User profile and click on the **Settings** option.

![](https://cdn.document360.io/23dc20b8-a989-48c0-8653-f1d3e4abc734/Images/Documentation/2(18).png)
  - On the Settings page, click on the **Apps** tab.
  - Click on **Manage Developer Apps**

![](https://cdn.document360.io/23dc20b8-a989-48c0-8653-f1d3e4abc734/Images/Documentation/3(17).png)
  - On the Manage Developer Apps page, click on the **Create new token** button.

![](https://cdn.document360.io/23dc20b8-a989-48c0-8653-f1d3e4abc734/Images/Documentation/4(15).png)
  - Enter the **Token name**.
  - Agree to the Asana API terms by marking the checkbox.
  - Click on the **Create token** button.

![](https://cdn.document360.io/23dc20b8-a989-48c0-8653-f1d3e4abc734/Images/Documentation/5(17).png)
  - The system displays the API token. **Copy** and **save** the token to use it while configuring Asana in SAFE.
  - It's important to regularly update the API Token in SAFE according to its expiration date.

![](https://cdn.document360.io/23dc20b8-a989-48c0-8653-f1d3e4abc734/Images/Documentation/6(17).png)
- How to get **Organization's Name**
  - Go to your Asana Account.
  - Navigate to the User profile and click on the **Settings** option.

![](https://cdn.document360.io/23dc20b8-a989-48c0-8653-f1d3e4abc734/Images/Documentation/7(15).png)
  - On the Settings page, click on the **Account** tab.
  - Here the system displays the Organization Name. **Copy** and **save** the Organization Name to use it while configuring Asana in SAFE.

![](https://cdn.document360.io/23dc20b8-a989-48c0-8653-f1d3e4abc734/Images/Documentation/8(17).png)
- How to get **API URL:**
  - Access the Asana API documentation by clicking on the provided [link](https://developers.asana.com/reference/rest-api-reference).
  - Upon reaching the Asana API documentation page, locate the section titled "**Usage**".
  - In the exhibit provided, find the base URL highlighted as 3. **Copy** and **save** this *API Base URL* to use it while configuring Asana in SAFE.

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

## Configure Asana in SAFE

---

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

![](https://cdn.document360.io/23dc20b8-a989-48c0-8653-f1d3e4abc734/Images/Documentation/10(15).png)
- Hover over the **Asana** integration card and click on the **Configure** button.
- Enter the following:
  - **API URL**
  - **Organization Name**
  - **API Token**

![](https://cdn.document360.io/23dc20b8-a989-48c0-8653-f1d3e4abc734/Images/Documentation/11(12).png)
- Enter the **Auto Sync frequency**.
- Click on the **Test Connection** button.
- Once the connection is successful, click on the **Save** button.

![](https://cdn.document360.io/23dc20b8-a989-48c0-8653-f1d3e4abc734/Images/Documentation/12(13).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/12(12).png)
- Upon a successful sync, the system pulls the Asana assets and their findings in SAFE. You can track the status of the sync in the **History** table

## View Results

---

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

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

![](https://cdn.document360.io/23dc20b8-a989-48c0-8653-f1d3e4abc734/Images/Documentation/14(7).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.
