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

# Figma

> OAuth を使用して Figma を Iru Compliance に接続し、組織、チーム、ファイル、ライブラリのインベントリとメンバーおよびアクセス制御のエビデンスを収集します。

### Figma について

Iru は **OAuth 2.0**（**認可コード**）を使用します。ソースを有効にすると、**ブラウザのポップアップ** で Figma に移動し、サインインしてスコープ（ファイル、プロジェクト、組織、チーム、コンポーネント、Webhook、分析など）を承認します。一部のスコープ（**例: `variables:read`**）には **Enterprise** が必要です。下位のプランでは、接続が失敗するのではなく、それらのデータセットが単に省略されます。

### 仕組み

Iru は Figma の **OAuth 2.0 認可コード** フローを使用します。ソースをオンにすると、**ブラウザのポップアップ** で Figma に移動します。サインインしてスコープを確認し、アクセスを許可します。Figma は **認可コード** を返し、Iru はそれを **アクセストークン**（および該当する場合はリフレッシュトークン）に交換します。

| 項目 | 値 |
| - | - |
| **カテゴリ** | 開発者ツール |
| **認証** | OAuth 2.0 |
| **推奨プラン** | 幅広い API カバレッジには Organization または Enterprise |

代表的なスコープには **`files:read`**、**`projects:read`**、**`org:read`**、**`org_teams:read`**、**`components:read`**、**`webhooks:write`**（増分更新用）、**`analytics:read`** が含まれます。正確な一覧は Figma の認可画面に従います。

公式リファレンス: [認証](https://www.figma.com/developers/api#authentication)、[スコープ](https://www.figma.com/developers/api#scopes)、[REST API](https://www.figma.com/developers/api)。

### 前提条件

* Iru に読み取らせる Figma **組織** の **管理者** または **所有者**。

### Figma を Iru に接続する

<Tabs>
  <Tab title="Figma">
    <Note>
      適切な組織メンバーが OAuth を完了できるよう、**Iru Compliance** で **Figma** を有効にする前にこのタブの手順を完了してください。
    </Note>

    <Steps>
      <Step title="Figma にサインインする">
        [figma.com](https://www.figma.com) を開き、Iru が読み取る **組織** の **管理者** または **所有者** でサインインします。
      </Step>

      <Step title="組織とファイルの可視性を確認する">
        コンプライアンスプログラムでエビデンスとして想定している **チーム**、**プロジェクト**、**ファイル** を開きます。Enterprise 専用のスコープ（例: 一部の **variables** の読み取り）には、適切なプランとロールが必要です。
      </Step>

      <Step title="スコープのドキュメントを確認する">
        同意画面が想定と一致するよう、[Figma の認証](https://www.figma.com/developers/api#authentication) と [スコープ](https://www.figma.com/developers/api#scopes) に目を通します。
      </Step>

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

    <Note>
      [**Iru Compliance**](#iru-compliance) タブに進んでください。
    </Note>
  </Tab>

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

      <Step title="ウィザードから OAuth を開始する">
        （ポップアップを許可した後で）コネクタウィザードから OAuth フローを開始します。
      </Step>

      <Step title="Figma にサインインして承認する">
        求められた場合は Figma へのログインを完了します。スコープを確認し、**Allow access**（または **Authorize**）を選択します。
      </Step>

      <Step title="接続を完了する">
        Figma のポップアップが閉じて Iru が OAuth の交換を完了すると、ウィザードに **接続が構成されました** と表示されます。
      </Step>

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

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

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

  <Accordion title="ポップアップがブロックされる">
    Iru のポップアップを許可し、ソースをオフにしてから再度オンにしてください。
  </Accordion>

  <Accordion title="アクセスが拒否される">
    **組織管理者**/**所有者** で承認してください。Editor には組織スコープがない場合があります。
  </Accordion>

  <Accordion title="チーム/ファイルが表示されない">
    それらのチーム/プロジェクトにアクセスできるユーザーで再承認してください。
  </Accordion>

  <Accordion title="トークンの有効期限切れ">
    Iru から OAuth フローを再実行してください。
  </Accordion>
</AccordionGroup>

### 考慮事項

<CardGroup cols={2}>
  <Card title="承認したユーザーを組織から削除すると…" icon="circle-info">
    承認したユーザーを組織から削除すると、アクセスが無効になる場合があります。継続的に利用できる管理者アカウントで再接続してください。
  </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>