How can we help?

Asana Integration

Uri Nativ
Uri Nativ
  • 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: Torii uses the Audit Logs API to gather the latest activity data for users. However, Asana has clarified that this API is mainly intended for tracking critical events such as logins and changes in permissions, and it might not record everyday user actions like creating tasks or commenting. Therefore, there might be inconsistencies between the "last used" date reported by Torii and the data shown on the Asana admin console. Torii will expand its support to include full usage data once Asana releases an API that captures this information.

 

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