How can we help?

Asana Integration

Noga Tubi
Noga Tubi
  • Updated

Setup your Asana Integration and get the insights in Torii's dashboard

Overview

Torii integrates with Asana and syncs:

  • Users list - All users within the workspaces and organizations the user who connected the integration is a member of
    Note, that Torii doesn't support the "Personal Projects" workspace anymore since Asana deprecated it.
  • User status - Active, Not Active
  • User role - Guest, Member, or Admin
  • License types - Guest and Member
  • Usage - The number of days and average usage time of the application - For Enterprise accounts only

Note,

  • Asana integration is an OAuth connection
  • Torii can support multiple accounts

With this integration, you will be able to:

  • Identify users who haven't used Asana for a while
  • Recognize and remove from Asana employees leaving your company

Usage
Torii monitors Asana usage data daily.
We monitor all audit log events exposed by the Asana API:

  1. Logins - All login events operate on the User resource type (excluding failed logins).
  2. User updates - All user events run on the User resource type
  3. Admin settings - All admin settings events operate on the Workspace resource type except for workspace_announcement_created and workspace_announcement_removed that run on the Workspace Announcement resource type.
  4. Roles - All role events operate on the User resource type
  5. Content Export
  6. Access Control
  7. Apps
  8. Creation - all creation events
  9. Deletion - all deletion events

Please note: Tori utilizes the Audit Logs API to retrieve the last active data for users, but this API has limitations. Asana has confirmed that this API is primarily designed for critical events like logins and permissions changes, and may not capture routine user activities such as task creation or commenting. As a result, disparities between Tori's last used date and the information displayed on the Asana admin console are expected. Once Asana releases an API which provides full usage data, Torii will support this as well. 

 

Integration Process

  1. Go to the Integrations page and click on Asana
  2. Click Connect
  3. The Connect Asana box will pop up, enabling you to select the connection options - Read or Read and take action (setup/edit)

    Steps 4-5 are relevant when connecting a single organization or workspace in a multiple organizations/workspaces account.
    When you have more than one organization or workspace connected to your Asana account, and you only want to sync one of them
  4. Copy the "gid" number of the organization you want to connect from this link
    The GID enables us to sync only the specific group, if not provided, ALL groups will be synced.
  5. Paste the "gid" number to the OPTIONAL Organization or WorkspaceID field
  6. To see usage - for the Enterprise account, only paste the Token. Click here to see how to get a token
  7. Click Connect
    mceclip2.png

  8. You will be referred to Asana scopes
    Torii asks for the default scope as described in the Asana website documentation.
    This scope is the minimum required for the integration, and it provides access to all endpoints documented.
    Prior setup on your end is not required.mceclip3.png

  9. The "Test Connection" window will display, generating the connection test.
    Click Continue.
    mceclip4.png
  10. Once the integration is connected and synced, it will display a green checkbox.
    mceclip5.png

Get a token for the Enterprise account

  1. From Asana, go to your user
  2. Select Admin Console
  3. From the left menu, select Apps
  4. Go to Add service account
  5. Give a name to your account

  6. COPY NOW the token. You will not see it after saving

  7. Save changes

Configuration

This integration synchronizes all workspaces and organizations that the user who connected the integration is a member of.

Q&A

Q: Why are Torii and Asana's Admin Panel numbers different?

A: If your organization is using a Division plan, only members of the Division will be shown in the Admin Console.

The response Torii gets from the API includes the following:

  • All members of your organization
  • Invited users that still need to accept the invitation or finish the registration.
 
 

Was this article helpful?

0 out of 0 found this helpful

Have more questions? Submit a request