# Asana Destination

## Overview

Destinations are integrations that receive alerts from rules, policies, system health notifications, and rule errors. Panther supports configuring Asana as the destination where you will receive alerts.

When an alert is forwarded to an Asana destination, a new task is created in the configured Asana project(s).

The Asana destination requires a **Service Account Token** for Asana Enterprise customers (or a **Personal Access Token** for a basic Asana account) and one or more **Project GID**. 

## How to set up Asana alert destinations in Panther

### Completing prerequisites in Asana

1. Determine which Asana user you will use to be the reporter of issues.
   * To ensure continuity, we recommend creating a [service account](https://asana.com/guide/help/premium/service-accounts) specifically for this purpose.
2. Copy your Asana project's **Project GID** and store it a secure location. You will need this in the next steps. \
   To find the Project GID:
   1. In Asana, click **Home** in the left sidebar.
   2. Scroll down to the Projects section. Hover over the project you want to use, then click **…** on the right side of the project name.\
      ![The image shows a project name labeled "My Test Project" in Asana. The 3 dots icon is circled on the right side. ](https://4011785613-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LgdiSWdyJcXPahGi9Rs-2910905616%2Fuploads%2FM1mgfpMbfuqF8dRav5ao%2Fasana-project.png?alt=media\&token=9ec0b052-3e0c-42c2-95ab-a28f03a87218)
   3. In the dropdown menu that appears, click **Copy project link:**\
      ![In Asana, the dropdown menu on the "Test Project" is expanded. An arrow is pointing to the option "Copy project link."](https://4011785613-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LgdiSWdyJcXPahGi9Rs-2910905616%2Fuploads%2F8iHsauD5WLGyvOPHcqEL%2Fasana-project-link.png?alt=media\&token=c27e2de4-bbad-4933-8248-82c87ce94361)
   4. The copied link should look like `https://app.asana.com/0/xxxxxxxxxxxxxxxx/board`. The `Project GID` is the 16-digit number in the URL.
3. Copy your Asana user's **Service Account Token** (or **Access Token** if you are using a basic Asana account) and store it in a secure location. You will need this in the next steps. 
   * **Asana Enterprise**: When you create or edit an existing Service Account, you can view its token. See [Asana's service account documentation](https://asana.com/guide/help/premium/service-accounts) for more information.
   * **Asana Basic**: Follow [Asana's instructions for getting a Personal Access Token](https://developers.asana.com/docs/personal-access-token).

Note: This token should be treated as sensitively as a password, and you will not be able to access it again in the future.

### Setting up the Destination in Panther

1. Log in to your Panther Console and navigate to **Configure > Alert Destinations**. 
2. Click **+Add your first Destination**.
   * If you have already created Destinations, click **Create New** in the upper right side of the page to add a new Destination.
3. Click **Asana** from the list of options.
4. Fill in the form to configure the Asana Destination.\
   ![](https://4011785613-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LgdiSWdyJcXPahGi9Rs-2910905616%2Fuploads%2FkDP71Q1T0LErx0DDZTLf%2Fasana-form-destination.png?alt=media\&token=851ce540-01da-4586-ba4d-410dcb7b9bd2)
   * **Display Name**: Enter a descriptive name.
   * **Access Token**: Paste in the Access Token you created for your user in Asana.
   * **Project GIDs**: Paste in your Asana project(s) GID then hit the `Return` key.
   * **Severity**: Select the severity level of alerts to send to this Destination.
   * **Alert Types**: Select the alert types to send to this Destination.
   * **Log Type**: By default, we will send alerts from all log types. Specify log types here if you want to only send alerts from specific log types.
   * **One-Way Status Syncing**: When set to `ON`, alert status changes being made via the Panther Console, API, or Slack Bot will sync and update the status of any corresponding Asana Tasks. 
     * Any Alert Status changes made via Panther will also be added as a comment within the Asana Task. Any updates made in Asana will not sync back to Panther.
     * The Panther Alert Status and corresponding Asana Task status will be mapped as follows:

       <table><thead><tr><th width="247">Panther Alert Status</th><th>Asana Task Status</th></tr></thead><tbody><tr><td>Open</td><td>Open</td></tr><tr><td>Triaged</td><td>Open</td></tr><tr><td>Resolved</td><td>Completed</td></tr><tr><td>Invalid</td><td>Completed</td></tr></tbody></table>
5. Click **Continue**.
6. Click **Finish Setup** to complete your setup, or click **Send Test Alert** to test your setup.

## Additional Information on Destinations

For more information on alert routing order, modifying or deleting destinations, and workflow automation, please see the Panther docs: [Destinations](https://docs.panther.com/destinations).