Asana Destination
Configuring Asana as an alert destination in your Panther Console
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.
- 1.Determine which Asana user you will use to be the reporter of issues.
- 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.
- 3.In the dropdown menu that appears, click Copy project link:
- 4.The copied link should look like
https://app.asana.com/0/xxxxxxxxxxxxxxxx/board. TheProject GIDis 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 for more information.
Note: This token should be treated as sensitively as a password, and you will not be able to access it again in the future.
- 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.
- 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
Returnkey. - 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:Panther Alert StatusAsana Task StatusOpenOpenTriagedOpenResolvedCompletedInvalidCompleted
- 5.Click Continue.
- 6.Click Finish Setup to complete your setup, or click Send Test Alert to test your setup.
For more information on alert routing order, modifying or deleting destinations, and workflow automation, please see the Panther docs: Destinations.
Last modified 22d ago