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

# Smartsheet

> 読み取り専用の API アクセストークンを使用して Smartsheet を Iru Compliance に接続し、ユーザーとライセンスのインベントリ、シートの共有権限、ワークスペースのメンバーシップを収集します。

### Smartsheet について

Iru は Smartsheet API から、**ユーザーとそのライセンスの種類**、**シートとその共有権限**、**ワークスペースとメンバーのアクセス権**、**グループ**を読み取ります。認証には、**アカウント** → **Personal Settings** → **API Access** で生成した **API アクセストークン**を使用します。リクエストの送信先は `https://api.smartsheet.com/2.0` で、構成が必要なサブドメインはありません。

Iru が読み取るのは**共有とアクセスの構成**であり、シートの内容ではありません。各シートが誰と共有されているかを収集しますが、セル内のデータは収集しません。

### 仕組み

```http theme={null}
Authorization: Bearer YOUR_ACCESS_TOKEN
```

Smartsheet は **Bearer** トークンで認証します。トークンはユーザーごとに生成され、そのユーザーの**実効アクセス権**を持ちます。エンドポイントごとの個別のスコープはありません。シートとワークスペースは個別に共有されるため、ワークスペースのメンバーではないユーザーのトークンでは、そのワークスペースについて何も返されません。Iru は、これと報告すべき共有がないワークスペースを区別できません。

最も完全なユーザーとライセンスのインベントリを取得するには、**System Admin** アカウントからトークンを生成してください。

| 詳細 | 値 |
| - | - |
| **カテゴリ** | プロジェクト管理 |
| **認証** | Bearer (API アクセストークン) |

公式リファレンス: [API overview](https://smartsheet.redoc.ly/)、[Authentication and access tokens](https://smartsheet.redoc.ly/#section/Security/Authentication-and-Access-Tokens)。

### 前提条件

* API アクセストークンを生成できるアカウント。ユーザーとライセンスのインベントリを完全にするため、**System Admin** をお勧めします。
* エビデンスを収集するすべてのワークスペースへのアクセス権。Smartsheet のアクセス権はオブジェクトごとに設定されます。
* 対象とするワークスペースを決定しておくこと。対象外のワークスペースからはエビデンスが生成されません。

### Smartsheet を Iru に接続する

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

    <Steps>
      <Step title="Smartsheet にサインインする">
        インテグレーションに継承させるアクセス権を持つアカウント (理想的には **System Admin**) で Smartsheet にサインインします。
      </Step>

      <Step title="Personal Settings を開く">
        **アカウント** (左下のアバター) を選択し、**Personal Settings** を選択します。
      </Step>

      <Step title="API Access を開く">
        **API Access** を選択します。
      </Step>

      <Step title="新しいアクセストークンを生成する">
        **Generate new access token** を選択します。
      </Step>

      <Step title="トークンに名前を付けてコピーする">
        後でこのトークンを識別できるように、**Iru Compliance** などの名前を入力します。Smartsheet にトークンの値が表示されている間に**一度だけ**コピーします。後から取得することはできません。紛失した場合は、代わりのトークンを生成してください。
      </Step>
    </Steps>

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

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

      <Step title="Bearer トークンを貼り付ける">
        トークンを **Bearer** フィールドに貼り付けます。
      </Step>

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

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

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

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

  <Accordion title="認証に失敗する">
    トークンを再生成し、文字列全体を貼り付けてください。Smartsheet では既存のトークンを表示できないため、部分的にしかコピーされていないかどうかを後から確認することはできません。
  </Accordion>

  <Accordion title="ワークスペースまたはシートが表示されない">
    トークンの所有者がそのワークスペースやシートの共有対象になっていません。**System Admin** アカウントからトークンを再生成するか、対象のワークスペースを使用したアカウントと共有してください。
  </Accordion>

  <Accordion title="ユーザーリストが少ない">
    管理者以外のトークンでは、そのユーザーが参照できるユーザーのみが返されます。ユーザーとライセンスのインベントリを完全にするには、System Admin のトークンを使用してください。
  </Accordion>

  <Accordion title="シートの内容が表示されない">
    これは想定どおりの動作です。Iru は共有とアクセスの構成を収集し、セルのデータは収集しません。
  </Accordion>
</AccordionGroup>

### 関連記事

<CardGroup cols={2}>
  <Card title="ソース管理" 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="アーティファクト管理" icon="folder-open" href="/ja/compliance/artifacts-management">
    ソースとアクションから得たエビデンスをアップロード、確認、整理します。
  </Card>
</CardGroup>