> ## Documentation Index
> Fetch the complete documentation index at: https://docs.iru.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Asana

> Connect Asana to Iru Compliance with OAuth so Iru can collect workspace inventory, team and project membership, and access-control evidence for audits.

### About Asana

The **Asana** connector pulls **workspace**, **team**, **project**, and **membership** information your controls need for access reviews and operational evidence. The integration uses **OAuth 2.0** (authorization code). The Asana user who completes consent must already **see** the workspaces and teams you expect to audit - otherwise collections will look incomplete even after a successful login.

### How It Works

Iru redirects you through Asana’s OAuth screen and stores tokens so **refresh** can happen without asking you to sign in every hour. Scopes are **read-oriented** - they let Iru enumerate teams, users, projects, workspaces, and memberships appropriate for compliance reporting.

| Detail             | Value                                                                                            |
| ------------------ | ------------------------------------------------------------------------------------------------ |
| **Category**       | Project management                                                                               |
| **Authentication** | OAuth 2.0                                                                                        |
| **Plans**          | Premium, Business, or Enterprise tiers align with API capabilities Asana exposes to integrations |

Documentation: [Asana OAuth](https://developers.asana.com/docs/oauth), [API docs](https://developers.asana.com/docs), [Developer console](https://app.asana.com/0/my-apps).

### Prerequisites

* An Asana account with visibility into the **workspaces**, **teams**, and **projects** you want evidence for (often a workspace admin).
* Browser **pop-ups allowed** for your Iru hostname - the OAuth window opens as a popup.

### Connect Asana to Iru

<Tabs>
  <Tab title="Asana">
    <Note>
      Complete this tab before you enable the source in **Iru Compliance**, so the right user is ready for OAuth.
    </Note>

    <Steps>
      <Step title="Sign in to Asana">
        Open [asana.com](https://asana.com) and sign in with the account you will use in the OAuth popup (often a **workspace admin** with broad visibility).
      </Step>

      <Step title="Confirm workspace coverage">
        Open each **workspace**, **team**, and **project** your compliance program expects in evidence. If this user cannot browse it in the Asana UI, Iru cannot read it either.
      </Step>

      <Step title="Review OAuth documentation (optional)">
        Skim [Asana OAuth](https://developers.asana.com/docs/oauth) so you know which read scopes the consent screen will reference.
      </Step>

      <Step title="Allow pop-ups for Iru">
        In the browser profile you will use for Compliance, allow **pop-ups** for your **Iru** hostname so the Asana OAuth window is not blocked.
      </Step>
    </Steps>

    <Note>
      Continue on the [**Iru Compliance**](#iru-compliance) tab.
    </Note>
  </Tab>

  <Tab title="Iru Compliance">
    <Note>
      Finish the [**Asana**](#asana) tab first.
    </Note>

    <Steps>
      <Step title="Open Sources">
        In Iru Compliance, on the left navigation bar, expand **Compliance** and select **Sources**.

        <Frame>
          <img src="https://mintcdn.com/iru/7HsGH7lnQ8GpVmI0/assets/media/images/iru-navigation-compliance-sources.png?fit=max&auto=format&n=7HsGH7lnQ8GpVmI0&q=85&s=595982441fd777b333b3ecfea24adc24" alt="Left navigation: Compliance expanded, Sources selected" width="424" height="1056" data-path="assets/media/images/iru-navigation-compliance-sources.png" />
        </Frame>
      </Step>

      <Step title="Turn on Asana">
        Find **Asana** (use **Category** or **Search by name or description**). On that card, turn on the **toggle**. A browser tab or window may open for the connector wizard.
      </Step>

      <Step title="Review scopes and start OAuth">
        On the connector screen, review the **required read scopes** (teams, users, projects, workspaces, memberships). Select **Launch OAuth authentication**.
      </Step>

      <Step title="Sign in to Asana and approve">
        When Asana opens, sign in if prompted. Review the permissions and select **Allow**.
      </Step>

      <Step title="Finish the connection">
        When the Asana window closes and Iru finishes the token exchange, the wizard shows **Connection Configured**.
      </Step>

      <Step title="Confirm the source is Active">
        Close the **Iru is requesting access to external services** browser tab, then return to **Compliance** → **Sources** and confirm the **Asana** card is **Active**.
      </Step>
    </Steps>
  </Tab>
</Tabs>

### Troubleshooting

<AccordionGroup>
  <Accordion title="Nothing opens when you turn the source on">
    Check **pop-up blocker** settings for the Iru site and try again.
  </Accordion>

  <Accordion title="Popup blocked">
    Allow pop-ups for your Iru domain, disable the source, then enable it again.
  </Accordion>

  <Accordion title="Insufficient permissions in Asana">
    Re-authorize with a user who can see the missing workspaces or teams.
  </Accordion>

  <Accordion title="Empty data">
    Confirm the authorizing user belongs to real teams/projects - brand-new accounts may have nothing to read.
  </Accordion>

  <Accordion title="Disconnected later">
    Tokens expire roughly hourly; Iru refreshes automatically unless the authorizing user was deactivated - re-run OAuth with an active account.
  </Accordion>
</AccordionGroup>

### Considerations

<CardGroup cols={2}>
  <Card title="The connection follows whichever Asana user…" icon="circle-info">
    The connection **follows** whichever Asana user authorized it - transfer ownership before that person offboards.
  </Card>

  <Card title="Asana rate limits large workspaces; first sync can…" icon="shield">
    Asana **rate limits** large workspaces; first sync can take several minutes.
  </Card>
</CardGroup>

### Related Articles

<CardGroup cols={2}>
  <Card title="Sources Management" icon="plug" href="/en/compliance/sources-management">
    Browse and manage every Compliance source.
  </Card>

  <Card title="Getting Started With Compliance" icon="rocket" href="/en/compliance/getting-started-with-compliance">
    Frameworks, actions, and **Artifacts**.
  </Card>

  <Card title="Iru Overview" icon="layer-group" href="/en/iru/platform-overview/iru-overview">
    How Endpoint, Compliance, and Identity fit together.
  </Card>

  <Card title="Artifacts Management" icon="folder-open" href="/en/compliance/artifacts-management">
    Upload, review, and organize evidence from sources and actions.
  </Card>
</CardGroup>