Skip to main content

​
Databricks について

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

​
仕組み

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

​
前提条件

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

​
Databricks を Iru に接続する

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

ワークスペースにサインインする

admin ロールを持つアカウントで、Iru に読み取らせる Databricks ワークスペースにサインインします。
2

設定を開く

上部のバーでユーザー名を選択し、設定 を選択します。
3

Access tokens を開く

Developer に移動し、Access tokens の横にある 管理 を選択します。
4

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

Generate new token を選択します。
5

名前と有効期間を設定する

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

トークンとワークスペース URL をコピーする

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

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

Iru サイトのポップアップブロッカーの設定を確認してから、もう一度お試しください。
入力した URL と同じワークスペースでトークンが作成されたことを確認してください。トークンはワークスペース間で移行できません。
ワークスペース管理者が個人用アクセストークンを無効にしています。再度有効にするか、サービスプリンシパルで認証してください。
トークンが管理者以外のアカウントに属しており、そのアカウントが閲覧できる内容のみが返されています。ワークスペース管理者でトークンを再作成してください。
ワークスペースで Unity Catalog を使用していない場合は想定どおりの動作です。Iru は Unity Catalog のデータが存在する場合にのみ収集します。
トークンの Lifetime が経過しています。新しいトークンを生成して再接続してください。

​
関連記事

Sources の管理

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

Compliance の利用を開始する

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

Iru の概要

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

Artifacts の管理

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