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

# Databricks

> ワークスペース URL と読み取り専用のアクセストークンを使用して Databricks を Iru Compliance に接続し、ユーザーとグループのインベントリ、ワークスペースの権限、クラスターのセキュリティ設定、シークレットスコープのアクセス制御を収集します。

### Databricks について

Iru は Databricks REST API から、**ユーザーとグループ**、**ワークスペースの権限**、**クラスターの設定**、**シークレットスコープ**、**Unity Catalog の権限**（Unity Catalog を使用している場合）を読み取ります。認証には **Bearer** トークンを使用します。**User Settings** → **Developer** → **Access tokens** で作成した**個人用アクセストークン**、または**サービスプリンシパル**のトークンのいずれかを使用します。リクエストはワークスペースのホストを宛先とするため、Iru は最初に**ワークスペース URL** を保存し、次にトークンを保存します。

### 仕組み

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

Databricks は**ワークスペース単位**です。各ワークスペースには独自のホスト（例: AWS では `https://dbc-1234abcd-5e6f.cloud.databricks.com`、Azure では `https://adb-1234567890.12.azuredatabricks.net`）と独自のトークンがあります。トークンは発行元のワークスペースに対してのみ有効なため、エビデンスが必要なワークスペースごとに 1 つのソースを接続してください。Iru は**シークレットスコープの名前とそのアクセス制御リスト**を読み取ります。**シークレットの値**は読み取りません。

| 項目 | 値 |
| - | - |
| **カテゴリ** | アナリティクス |
| **認証** | Bearer（アクセストークン） |

公式の参考資料: [REST API リファレンス](https://docs.databricks.com/api/workspace/introduction)、[認証](https://docs.databricks.com/aws/en/dev-tools/auth/)。

### 前提条件

* ワークスペースにサインインした状態でブラウザからコピーした**ワークスペース URL**。
* **ワークスペース管理者**のアクセス権。トークンの作成はワークスペースの設定によって制限される場合があり、管理者以外のトークンでは、そのアカウントがすでに閲覧できる権限とクラスターのみが返されます。
* ワークスペースで個人用アクセストークンが**有効**になっていること。管理者が無効にしている場合は、代わりに**サービスプリンシパル**を使用してください。
* 対象範囲を決めておきます。Databricks ではワークスペースやシークレットスコープを除外でき、除外されたオブジェクトからはエビデンスが生成されません。

### Databricks を Iru に接続する

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

    <Steps>
      <Step title="ワークスペースにサインインする">
        **admin** ロールを持つアカウントで、Iru に読み取らせる Databricks ワークスペースにサインインします。
      </Step>

      <Step title="設定を開く">
        上部のバーで**ユーザー名**を選択し、**設定** を選択します。
      </Step>

      <Step title="Access tokens を開く">
        **Developer** に移動し、**Access tokens** の横にある **管理** を選択します。
      </Step>

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

      <Step title="名前と有効期間を設定する">
        **コメント** に **Iru Compliance** などを入力し、チームで管理できる **Lifetime** を設定します。トークンの有効期限が切れると収集は停止します。有効期間を空欄にすると無期限のトークンが作成されますが、セキュリティポリシーによっては許可されていない場合があります。
      </Step>

      <Step title="トークンとワークスペース URL をコピーする">
        **生成** を選択し、Databricks に表示されている間にトークンの値を**一度だけ**コピーします。ブラウザのアドレスバーから**ワークスペース URL**（スキームとホストのみで、末尾のパスは含めない）をコピーします。
      </Step>
    </Steps>

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

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

      <Step title="ワークスペース URL を入力する">
        **ワークスペース URL** を入力します。ウィザードにプレビュー URL が表示された場合は確認します。
      </Step>

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

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

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

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

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

  <Accordion title="認証に失敗する">
    入力した URL と**同じワークスペース**でトークンが作成されたことを確認してください。トークンはワークスペース間で移行できません。
  </Accordion>

  <Accordion title="Settings でトークンを作成できない">
    ワークスペース管理者が個人用アクセストークンを無効にしています。再度有効にするか、**サービスプリンシパル**で認証してください。
  </Accordion>

  <Accordion title="ユーザーとクラスターは表示されるが、権限が不完全に見える">
    トークンが管理者以外のアカウントに属しており、そのアカウントが閲覧できる内容のみが返されています。ワークスペース管理者でトークンを再作成してください。
  </Accordion>

  <Accordion title="Unity Catalog のデータがない">
    ワークスペースで Unity Catalog を使用していない場合は想定どおりの動作です。Iru は Unity Catalog のデータが存在する場合にのみ収集します。
  </Accordion>

  <Accordion title="収集が動作した後に停止した">
    トークンの **Lifetime** が経過しています。新しいトークンを生成して再接続してください。
  </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>
