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

# Box

> OAuth を使用して Box を Iru Compliance に接続し、エンタープライズのファイルとフォルダのインベントリ、ユーザーとグループのアクセス、共有ポリシーの設定を収集します。

### Box について

Iru は **OAuth 2.0**（**認可コード**）を使用して、**ファイル**、**フォルダ**、**ユーザー**、**グループ**、**エンタープライズ**のメタデータを読み取ります。**認可する Box ユーザー**は、監査プログラムで対象とするコンテンツを閲覧できる必要があります。組織全体のエビデンスが必要な場合は、**管理者レベル**の閲覧権限を持つユーザーを推奨します。

### 仕組み

Iru は Box の **OAuth 2.0 認可コード**グラントを使用します。ウィザードの**ポップアップ**から Box にサインインし、スコープを確認してアクセスを承認します。Box はコードを返し、Iru はそのコードを以降の REST 呼び出しで使用するトークンと交換します。

| 項目 | 値 |
| - | - |
| **カテゴリ** | ストレージ |
| **認証** | OAuth 2.0 |
| **一般的なプラン** | Business または Enterprise（API のすべての機能） |

スコープには通常、ファイル/フォルダへの**読み取り**アクセスと、該当する場合は**エンタープライズ**管理が含まれます。正確な文字列は Box の同意画面に表示されます。

公式の参考資料: [OAuth 2.0](https://developer.box.com/guides/authentication/oauth2/)、[スコープ](https://developer.box.com/guides/api-calls/permissions-and-errors/scopes/)、[デベロッパードキュメント](https://developer.box.com/)。

### 前提条件

* Iru のドメインに対してブラウザの**ポップアップ**が許可されていること。
* レビュー対象のフォルダとユーザーに対して十分な権限を持つ Box アカウント。

### Box を Iru に接続する

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

    <Steps>
      <Step title="Box にサインインする">
        [box.com](https://www.box.com) を開き、OAuth ポップアップで使用するアカウントでサインインします（組織全体のエビデンスには、**共同管理者**または**管理者**の閲覧権限を推奨します）。
      </Step>

      <Step title="エンタープライズの閲覧範囲を確認する">
        **Admin Console**（または同等の画面）を参照し、監査プログラムで対象とする必要がある**ユーザー**、**グループ**、**フォルダ**をスポットチェックします。このユーザーが Box でオブジェクトを閲覧できない場合、Iru も読み取ることができません。
      </Step>

      <Step title="OAuth スコープを確認する">
        同意画面が想定どおりであることを確認できるよう、Box の [OAuth 2.0](https://developer.box.com/guides/authentication/oauth2/) と[スコープ](https://developer.box.com/guides/api-calls/permissions-and-errors/scopes/)のドキュメントにざっと目を通します。
      </Step>

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

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

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

      <Step title="ウィザードから OAuth を開始する">
        コネクタウィザードで **Launch OAuth**（または同等のコントロール）を選択します。
      </Step>

      <Step title="Box にサインインして承認する">
        Box へのログインを完了し、スコープを確認して **Grant access to Box**（**Grant** と表示される場合もあります）を選択します。ウィザードの指示に従ってポップアップを閉じます。
      </Step>

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

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

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

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

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

  <Accordion title="権限が不足している">
    不足しているエンタープライズのオブジェクトにアクセスできるユーザーで再認可してください。
  </Accordion>

  <Accordion title="リフレッシュが古くなっている">
    アクセストークンの有効期間は短いですが、Iru が自動的にリフレッシュします。**60 日間**使用されなかった後や同意内容が変更された後にリフレッシュが失敗する場合は、**再認可**してください。
  </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>
