Skip to main content

Asana

Visualize Asana workspaces, teams, users, projects, and project memberships, map Asana users to employees, and monitor changes to Asana users through queries and alerts.

Installation​

Asana Setup Requirements

Before configuring this integration in JupiterOne, you need to set up OAuth authentication in Asana:

Required in Asana:

  • An Administrator user account with permission to create OAuth applications
  • An OAuth application registered in your Asana account with a Client ID and Client Secret
  • An OAuth refresh token generated through the OAuth authorization flow

Authentication: This integration uses OAuth 2.0 with refresh tokens. JupiterOne will automatically refresh access tokens as needed using the credentials you provide.

Permissions: The OAuth application will have access to read all workspaces, teams, users, projects, and project memberships that the authorizing user can access.

For detailed OAuth setup instructions, see the Asana OAuth documentation.

To install the Asana integration in JupiterOne, navigate to the Integrations tab in JupiterOne and select Asana. Click New Instance to begin configuring your integration.

Creating an Asana integration requires the following:

  • The Account Name used to identify the Asana account in JupiterOne. Ingested entities will have this value stored in tag.AccountName when the AccountName toggle is enabled.

  • Description to assist in identifying the integration instance, if desired.

  • Polling Interval that you feel is sufficient for your monitoring needs. You may leave this as DISABLED and manually execute the integration.

After clicking Create, you'll be prompted to authorize JupiterOne with Asana. Completing the authorization process will finalize the integration setup.

Next steps​

Now that your integration instance has been configured, it will begin running on the polling interval you provided, populating data within JupiterOne. Continue on to our Instance management guide to learn more about working with and editing integration instances.