Skip to main content

​
Smartsheet について

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

​
仕組み

Smartsheet は Bearer トークンで認証します。トークンはユーザーごとに生成され、そのユーザーの実効アクセス権を持ちます。エンドポイントごとの個別のスコープはありません。シートとワークスペースは個別に共有されるため、ワークスペースのメンバーではないユーザーのトークンでは、そのワークスペースについて何も返されません。Iru は、これと報告すべき共有がないワークスペースを区別できません。 最も完全なユーザーとライセンスのインベントリを取得するには、System Admin アカウントからトークンを生成してください。 公式リファレンス: API overview、Authentication and access tokens。

​
前提条件

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

​
Smartsheet を Iru に接続する

Compliance でソースを接続する前に、このタブの手順を完了してください。
1

Smartsheet にサインインする

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

Personal Settings を開く

アカウント (左下のアバター) を選択し、Personal Settings を選択します。
3

API Access を開く

API Access を選択します。
4

新しいアクセストークンを生成する

Generate new access token を選択します。
5

トークンに名前を付けてコピーする

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

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

Iru サイトのポップアップブロッカー設定を確認して、もう一度お試しください。
トークンを再生成し、文字列全体を貼り付けてください。Smartsheet では既存のトークンを表示できないため、部分的にしかコピーされていないかどうかを後から確認することはできません。
トークンの所有者がそのワークスペースやシートの共有対象になっていません。System Admin アカウントからトークンを再生成するか、対象のワークスペースを使用したアカウントと共有してください。
管理者以外のトークンでは、そのユーザーが参照できるユーザーのみが返されます。ユーザーとライセンスのインベントリを完全にするには、System Admin のトークンを使用してください。
これは想定どおりの動作です。Iru は共有とアクセスの構成を収集し、セルのデータは収集しません。

​
関連記事

ソース管理

すべての Compliance ソースを参照および管理します。

Compliance の使用を開始する

フレームワーク、アクション、アーティファクト。

Iru の概要

Endpoint、Compliance、Identity がどのように連携するか。

アーティファクト管理

ソースとアクションから得たエビデンスをアップロード、確認、整理します。