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

# ClickUp

> Authorization ヘッダーで送信する個人用 API トークン（Bearer プレフィックスなし）を使用して ClickUp を Iru Compliance に接続し、ワークスペース、チーム、タスクのエビデンスを収集します。

### ClickUp について

Iru は ClickUp API から**ワークスペース**、**スペース**、**フォルダ**、**リスト**、**タスク**、**メンバー**を読み取ります。ClickUp の**個人用トークン**は **`pk_…`** の形式で、**`Authorization`** ヘッダーの値として**そのまま**送信する必要があります。**`Bearer`** のプレフィックスを付けると認証に失敗するため、付け**ないでください**。

### 仕組み

```http theme={null}
Authorization: pk_XXXXXXXXXXXXXXXX
```

| 項目 | 値 |
| - | - |
| **カテゴリ** | プロジェクト管理 |
| **認証** | 個人用 API トークン（`pk_…`） |

公式の参考資料: [認証](https://developer.clickup.com/docs/authentication)、[API リファレンス](https://developer.clickup.com/reference)、[ヘルプセンター](https://help.clickup.com/hc/en-us/articles/6303426241687-Use-the-ClickUp-API)。

### 前提条件

* エビデンスの対象とするすべての**ワークスペース**のメンバーである ClickUp ユーザー。

### ClickUp を Iru に接続する

<Tabs>
  <Tab title="ClickUp">
    <Note>
      Compliance でソースを接続する前に、このタブを完了してください。
    </Note>

    <Steps>
      <Step title="ClickUp にサインインする">
        [ClickUp](https://clickup.com) を開き、Iru に読み取らせるすべての**ワークスペース**のメンバーであるユーザーでサインインします。
      </Step>

      <Step title="アバターメニューを開く">
        ClickUp のレイアウトに応じて、左下またはヘッダーにある**アバター**（プロフィール写真またはイニシャル）を選択します。
      </Step>

      <Step title="設定とアプリを開く">
        **設定** を選択し、次に **アプリ** を選択します（テナントで API トークンが **ClickApps** / **インテグレーション** に配置されている場合はそちらを選択します。**API Token** が表示されるパスを使用してください）。
      </Step>

      <Step title="API Token を開く">
        **API Token** を選択して、既存のトークンと新しいトークンを作成するためのコントロールを表示します。
      </Step>

      <Step title="個人用 API トークンを生成する">
        **生成**（または **トークンを作成**）を選択して、新しい **`pk_…`** トークンを発行します。
      </Step>

      <Step title="トークンの値をコピーする">
        **`pk_`** 文字列全体をコピーします。**Regenerate** を実行すると以前のトークンは無効になるため、ローテーションする場合は同じ日に Iru を更新してください。
      </Step>
    </Steps>

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

  <Tab title="Iru Compliance">
    <Note>
      先に [**ClickUp**](#clickup) タブを完了してください。
    </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="ClickUp をオンにする">
        **ClickUp** を探します（**カテゴリ** または **名前または説明で検索** を使用します）。そのカードの**トグル**をオンにします。コネクタウィザード用のブラウザタブまたはウィンドウが開く場合があります。
      </Step>

      <Step title="個人用 API トークンを貼り付ける">
        **`Bearer`** を付け**ずに**、**`pk_…`** を **Authorization** フィールドに貼り付けます。
      </Step>

      <Step title="接続を完了する">
        **APIキーを送信** を選択します。接続に成功すると、ウィザードに **接続が構成されました** と表示されます。
      </Step>

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

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

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

  <Accordion title="Bearer を追加した後に 401 が発生する">
    **`Bearer`** を削除してください。ヘッダーにはトークン文字列のみを含めます。
  </Accordion>

  <Accordion title="ワークスペースが表示されない">
    トークンのユーザーがそのワークスペースに参加している必要があります。
  </Accordion>

  <Accordion title="ローテーション後に接続できない">
    **新しい** `pk_` トークンを Iru に貼り付けてください。
  </Accordion>
</AccordionGroup>

### 関連記事

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