Introduction

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

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.

• • Navigate to the User profile and click on the Settings option.

• • On the Settings page, click on the Apps tab.

  • Click on Manage Developer Apps

• • On the Manage Developer Apps page, click on the Create new token button.

• • Enter the Token name.

  • Agree to the Asana API terms by marking the checkbox.

  • Click on the Create token button.

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

• How to get Organization's Name

  • Go to your Asana Account.

  • Navigate to the User profile and click on the Settings option.

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

• How to get API URL:

  • Access the Asana API documentation by clicking on the provided link.

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

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.

• Hover over the Asana integration card and click on the Configure button.

• Enter the following:

  • API URL

  • Organization Name

  • API Token

• Enter the Auto Sync frequency.

• Click on the Test Connection button.

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

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

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

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

Did this article help?

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

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.