Asana Setup

Organizations: Set up your Asana integration

Updated over a week ago

Integrate with Asana to synchronize data between your HackerOne reports and Asana tasks.

Setup

  1. Navigate to Program Settings > Program > Integrations.

  2. Click on the Connect with Asana link.

    Integrations page, connect with Asana link

  3. Select the Set up new integration button.

    set up new integration prompt

  4. Provide a name and description(optional) for your new integration, then click Next.

    Integration setup: connection details

  5. In the following account select New authentication.

  6. A popup window will open to Asana. Log in, preferably with a dedicated integration user account. This user will be the author of the newly created tasks and comments within Asana.

    Grant permission in Asana

  7. Grant permissions to HackerOne by clicking ‘Allow’ on the following screen

  8. Configure the desired Asana organization and workspace you want to escalate reports to, and click Next.

    Integration setup: Organization & workspace

  9. Select a project within your workspace for the newly created tasks, then click Next.

    Integration setup: Add Asana projects

  10. Configure the project to create a task related to the escalated report, then click Next.

  11. Configure the mapping between Asana Task Name and Description to HackerOne fields. You can use existing HackerOne fields or use integration variables. When done, click Next.

  12. When creating a new Asana task, you can assign a priority based on the severity of the report. To enable this feature, activate a custom field for priorities within Asana. For detailed instructions, refer to Asana's custom field documentation. We recommend using a single-select field type.

    Integration setup: New custom field

  13. Configure HackerOne severity to Asana priority mapping. Click Next.

    Integration setup: HackerOne severity to Asana priority

  14. Optionally, you can select which actions in HackerOne you'd like to post to Asana in the Select HackerOne to Asana events window, then click Next.
    You can choose from:

    1. Comment added: Update the associated Asana issue when someone comments on a report.

    2. State changed: Update the associated Asana issue when someone changes the state of a report.

    3. Reward changed: Update the associated Asana issue when someone awards or suggests a bounty and/or bonus.

    4. Assignee changed: Update the associated Asana issue when someone assigns a user/group to a report.

    5. Disclosure: Update the associated Asana issue when disclosure is requested or a report becomes public.

    6. Synchronize attachments: Synchronize attachments linked with reports and comments to the associated Asana issue.

    Integration setup: HackerOne to Asana events

  15. Optionally, select which Asana actions you'd like to post onto HackerOne in the Select Asana to HackerOne events window, then click Next.
    You can choose from:

    1. Status changed: Post an internal comment when a task changes status.

    2. Closed issue status: Resolve the report when a task is closed with the selected status.

    3. Comment added: Post an internal comment when someone comments on a task.

    4. Assignee changed: Post an internal comment when a task changes assignees.

    5. Close on resolved: Close the report when a task gets marked as resolved.

    Integration setup: Asana to HackerOne events

  16. Enable the integration after completing the setup wizard.

Integration setup: Enable the integration on the integrations page

You're all set! Now that you've finished setting up the Asana integration, you can create an Asana task right from your HackerOne report.

Multiple Integrations

If you have multiple HackerOne programs, you can integrate them into the same Asana instance. Skip steps 5-6 for each subsequent program you need to add an integration for.

Multiple Asana Instances per Program

This feature is available for Enterprise programs only.

If you want to integrate the same program into multiple Asana instances, follow all the steps above for each integration.

Did this answer your question?