> ## 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

> OAuth を使用して Asana を Iru Compliance に接続し、Iru が監査用にワークスペースのインベントリ、チームとプロジェクトのメンバーシップ、アクセス制御のエビデンスを収集できるようにします。

### Asana について

**Asana** コネクタは、アクセスレビューや運用上のエビデンスとしてコントロールに必要な**ワークスペース**、**チーム**、**プロジェクト**、**メンバーシップ**の情報を取得します。この連携では **OAuth 2.0**（認可コード）を使用します。同意を完了する Asana ユーザーは、監査対象とするワークスペースとチームを事前に**閲覧**できる必要があります。そうでない場合、ログインに成功しても収集結果が不完全に見えます。

### 仕組み

Iru は Asana の OAuth 画面にリダイレクトし、トークンを保存するため、1 時間ごとにサインインを求めることなく**リフレッシュ**を行えます。スコープは**読み取り中心**で、Iru がコンプライアンスレポートに適したチーム、ユーザー、プロジェクト、ワークスペース、メンバーシップを列挙できるようにします。

| 項目 | 値 |
| - | - |
| **カテゴリ** | プロジェクト管理 |
| **認証** | OAuth 2.0 |
| **プラン** | Premium、Business、または Enterprise ティアが、Asana が連携に公開する API 機能に対応しています |

ドキュメント: [Asana OAuth](https://developers.asana.com/docs/oauth)、[API ドキュメント](https://developers.asana.com/docs)、[デベロッパーコンソール](https://app.asana.com/0/my-apps)。

### 前提条件

* エビデンスの対象とする**ワークスペース**、**チーム**、**プロジェクト**を閲覧できる Asana アカウント（多くの場合、ワークスペース管理者）。
* Iru のホスト名に対してブラウザの**ポップアップが許可**されていること。OAuth ウィンドウはポップアップとして開きます。

### Asana を Iru に接続する

<Tabs>
  <Tab title="Asana">
    <Note>
      OAuth に適切なユーザーを準備できるよう、**Iru Compliance** でソースを有効にする前にこのタブを完了してください。
    </Note>

    <Steps>
      <Step title="Asana にサインインする">
        [asana.com](https://asana.com) を開き、OAuth ポップアップで使用するアカウント（多くの場合、広い閲覧権限を持つ**ワークスペース管理者**）でサインインします。
      </Step>

      <Step title="ワークスペースの対象範囲を確認する">
        コンプライアンスプログラムがエビデンスとして想定している各**ワークスペース**、**チーム**、**プロジェクト**を開きます。このユーザーが Asana の UI で閲覧できない場合、Iru も読み取ることができません。
      </Step>

      <Step title="OAuth のドキュメントを確認する（任意）">
        同意画面でどの読み取りスコープが参照されるかを把握するため、[Asana OAuth](https://developers.asana.com/docs/oauth) にざっと目を通します。
      </Step>

      <Step title="Iru のポップアップを許可する">
        Compliance で使用するブラウザプロファイルで、**Iru** のホスト名に対して**ポップアップ**を許可し、Asana の OAuth ウィンドウがブロックされないようにします。
      </Step>
    </Steps>

    <Note>
      [**Iru Compliance**](#iru-compliance) タブに進みます。
    </Note>
  </Tab>

  <Tab title="Iru Compliance">
    <Note>
      先に [**Asana**](#asana) タブを完了してください。
    </Note>

    <Steps>
      <Step title="ソースを開く">
        Iru Compliance の左側のナビゲーションバーで **コンプライアンス** を展開し、**ソース** を選択します。

        <Frame>
          <img src="https://mintcdn.com/iru/tI0HDLDwHj8r9Ile/assets/media/images/iru-navigation-compliance-sources.png?fit=max&auto=format&n=tI0HDLDwHj8r9Ile&q=85&s=87dcef15fc17d2fb9a6e53f454e41710" alt="左側のナビゲーション: Compliance を展開し、Sources を選択した状態" width="410" height="1024" data-path="assets/media/images/iru-navigation-compliance-sources.png" />
        </Frame>
      </Step>

      <Step title="Asana をオンにする">
        **Asana** を探します（**カテゴリ** または **名前または説明で検索** を使用します）。そのカードの**トグル**をオンにします。コネクタウィザード用のブラウザタブまたはウィンドウが開く場合があります。
      </Step>

      <Step title="スコープを確認して OAuth を開始する">
        コネクタ画面で、**必要な読み取りスコープ**（チーム、ユーザー、プロジェクト、ワークスペース、メンバーシップ）を確認します。**Launch OAuth authentication** を選択します。
      </Step>

      <Step title="Asana にサインインして承認する">
        Asana が開いたら、求められた場合はサインインします。権限を確認して **許可** を選択します。
      </Step>

      <Step title="接続を完了する">
        Asana のウィンドウが閉じ、Iru がトークンの交換を完了すると、ウィザードに **接続が構成されました** と表示されます。
      </Step>

      <Step title="ソースが有効であることを確認する">
        **Iru が外部サービスへのアクセスをリクエストしています** のブラウザタブを閉じてから **コンプライアンス** → **ソース** に戻り、**Asana** カードが **有効** になっていることを確認します。
      </Step>
    </Steps>
  </Tab>
</Tabs>

### トラブルシューティング

<AccordionGroup>
  <Accordion title="ソースをオンにしても何も開かない">
    Iru サイトの**ポップアップブロッカー**の設定を確認してから、もう一度お試しください。
  </Accordion>

  <Accordion title="ポップアップがブロックされる">
    Iru のドメインに対してポップアップを許可し、ソースを無効にしてから、もう一度有効にしてください。
  </Accordion>

  <Accordion title="Asana の権限が不足している">
    不足しているワークスペースまたはチームを閲覧できるユーザーで再認可してください。
  </Accordion>

  <Accordion title="データが空になる">
    認可したユーザーが実際のチームやプロジェクトに所属していることを確認してください。作成したばかりのアカウントでは、読み取るデータが何もない場合があります。
  </Accordion>

  <Accordion title="後で接続が切断される">
    トークンはおよそ 1 時間ごとに期限切れになります。認可したユーザーが無効化されていない限り、Iru は自動的にリフレッシュします。無効化されている場合は、有効なアカウントで OAuth を再実行してください。
  </Accordion>
</AccordionGroup>

### 考慮事項

<CardGroup cols={2}>
  <Card title="接続は認可した Asana ユーザーに…" icon="circle-info">
    接続は、認可した Asana ユーザーに**紐付きます**。その担当者が退職する前に、所有権を移行してください。
  </Card>

  <Card title="Asana は大規模なワークスペースにレート制限を適用するため、初回同期に…" icon="shield">
    Asana は大規模なワークスペースに**レート制限**を適用するため、初回の同期には数分かかる場合があります。
  </Card>
</CardGroup>

### 関連記事

<CardGroup cols={2}>
  <Card title="Sources の管理" icon="plug" href="/ja/compliance/sources-management">
    すべての Compliance ソースを参照・管理します。
  </Card>

  <Card title="Compliance の利用を開始する" icon="rocket" href="/ja/compliance/getting-started-with-compliance">
    フレームワーク、アクション、**アーティファクト**。
  </Card>

  <Card title="Iru の概要" icon="layer-group" href="/ja/iru/platform-overview/iru-overview">
    Endpoint、Compliance、Identity がどのように連携するか。
  </Card>

  <Card title="Artifacts の管理" icon="folder-open" href="/ja/compliance/artifacts-management">
    ソースやアクションから得たエビデンスをアップロード、確認、整理します。
  </Card>
</CardGroup>