Asana
  • 2 Minutes to read
  • PDF

Asana

  • PDF

Article summary

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.

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

History


Learn More about Integration History here.

SAFE's Outgoing IP Addresses


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


Was this article helpful?

What's Next