シークレット管理
Databricks シークレットは、パスワード、APIキー、ハッシュソルトなどの機密値を格納するため、ノートブック、ジョブ、関数は、その値がコードに表示されることなく値を使用できます。シークレットは、以下の2つの場所で管理できます。
- ワークスペースSecret Scope :単一のワークスペースにあるシークレットの名前付きコレクション。権限はスコープ全体に適用されます。「ワークスペースSecret Scope」を参照してください。
- Unity Catalog のシークレット :メタストアにアタッチされたすべてのワークスペースで利用可能なセキュリティ保護可能なオブジェクト(
catalog.schema.secret)。各シークレットへのアクセスを許可できます。Unity Catalog のシークレットを参照してください。
Unity Catalog のシークレットは、Databricks が管理することも、AWS Secrets Manager でバックアップすることもできます。「Unity Catalog の AWS Secrets Manager シークレット」を参照してください。
シークレットの格納先を選択します
次の表は、各オプションがシークレット値をどこに保存するか、どのワークスペースがそれらを使用できるか、およびアクセスをどのように制御するかを比較したものです。
ワークスペースSecret Scope | Unity Catalog の Databricks 管理シークレット | Unity CatalogにおけるAWS Secrets Managerバックアップのシークレット(ベータ) | |
|---|---|---|---|
値の格納場所 | Databricks(ワークスペース内) | Databricks (Unity Catalog 内) | AWS Secrets Manager (Databricks は Unity Catalog にシークレット名のみを保存します) |
独自のキーによる暗号化 | はい。マネージドサービスのための顧客管理キーがあります。 | はい、カタログの顧客管理キーを使用します | - |
利用可能 | 1つのワークスペース | メタストアにアタッチされたすべてのワークスペース | メタストアにアタッチされたすべてのワークスペース |
アクセス制御 | Secret scopeの権限(シークレットレベルのアクセス制御なし) | シークレット、スキーマ、またはカタログに対する Unity Catalog 権限 | シークレット、スキーマ、またはカタログに対する Unity Catalog 権限 |
ローテーションする | Databricksの値を更新 | Databricksの値を更新 | AWS Secrets Manager でローテーションします。Databricks に変更はありません。 |
シークレットを使用できる場所
ワークスペースSecret ScopeとUnity Catalogシークレットは、異なる場所でサポートされています。いずれかを選択する前に、コードをランする場所で機能することを確認してください。
表面 | ワークスペースSecret Scope | Unity Catalogのシークレット |
|---|---|---|
| はい。シークレットを読み取るを参照してください。 | はい、Serverless環境バージョン4以上、またはDatabricks Runtime 17.3 LTS以上で可能です。「シークレットを読み取る」を参照してください。 |
REST API と Databricks CLI | はい。APIによって返される値は編集されません。 | はい。APIによって返される値は編集されません。 |
Databricks Connectなどのリモート開発 | はい。Databricks Connectクライアントの | No |
Unity Catalog Python および Scala UDF | No | はい。呼び出し側は |
SQLウェアハウス | はい、secret関数を使用します | シークレットを宣言する Unity Catalog Python または Scala UDF を介してのみ |
コンピュート上のSpark構成プロパティと環境変数 | はい。「Spark 構成プロパティまたは環境変数でのシークレットの使用」を参照してください。 | No |
モデルサービングEndpoint環境変数 | はい。シークレットベースの環境変数の追加を参照してください。 | No |
デフォルトパッケージリポジトリ | はい。 | No |
その他のリソース
-
- Unity Catalogのシークレット
- Unity Catalogシークレットを作成し、アクセスを許可し、ノートブック、ジョブ、UDFで読み取ります。
-
- Unity Catalogシークレットのベストプラクティス
- 環境、アプリケーション、またはチームごとにシークレットを整理し、ワークロードがシークレットを読み取ることなくシークレットを使用できるようにします。