Verwaltung von Geheimnissen

Ein Azure Databricks-secret speichert einen sensiblen Wert, wie ein Passwort, einen API-Schlüssel oder Hashing-Salz, sodass Notebooks, Aufträge und Funktionen ihn verwenden können, ohne dass der Wert im Code erscheint. Du kannst Secrets an zwei Orten verwalten:

  • Workspace-Secret-Scopes: Benannte Sammlungen von Geheimnissen in einem Workspace. Die Berechtigungen gelten für den gesamten Scope. Siehe Workspace Secret Scopes.
  • Secrets in Unity Catalog: Securable Objekte (catalog.schema.secret), die in jedem Arbeitsbereich verfügbar sind, der dem Metastore angegliedert ist. Du kannst Zugriff auf jedes Secret gewähren. Siehe Geheimnisse im Unity Catalog.

Unity Catalog-Geheimnisse können von Azure Databricks verwaltet oder durch Azure Key Vault unterstützt werden. Siehe Azure Key Vault Secrets im Unity Catalog.

Auswahl des Speicherorts des Geheimnisses

Die folgende Tabelle vergleicht, wo jede Option geheime Werte speichert, von welchen Arbeitsbereichen sie verwendet werden können und wie Sie den Zugriff steuern.

  Workspace-Geheimnis-Scope Azure Databricks-managed secret in Unity Catalog Azure Key Vault-backed secret in Unity Catalog (Beta)
Wo der Wert gespeichert ist Azure Databricks, im Arbeitsbereich oder in Ihrem Azure Key Vault mit einem von Key Vault unterstützten Scope Azure Databricks, in Unity Catalog Azure Key Vault (Azure Databricks speichert nur den Namen des Secrets im Unity Catalog)
Verschlüsselung mit eigenem Schlüssel Ja, mit einem vom Kunden verwalteten Schlüssel für verwaltete Dienste Ja, mit einem kundenseitig verwalteten Schlüssel für den Katalog
Verfügbar in Ein Arbeitsbereich Jeder Arbeitsbereich, der mit dem Metastore verbunden ist Jeder Arbeitsbereich, der mit dem Metastore verbunden ist
Zugriffskontrolle Berechtigungen für den Secret-Scope (keine Zugriffskontrolle auf Geheimnisebene) Unity-Katalog-Privilegien für das Secret, das Schema oder den Katalog Unity Catalog-Berechtigungen für das Secret, das Schema oder den Katalog
Zum Rotieren Aktualisieren Sie den Wert in Azure Databricks oder in Key Vault für einen von Key Vault unterstützten Scope Aktualisieren Sie den Wert in Azure Databricks In Azure Key Vault rotieren. Keine Änderung in Azure Databricks.

Wo du Secrets nutzen kannst

Workspace-Secret-Scopes und Unity-Catalog-Secrets werden an verschiedenen Stellen unterstützt. Bevor du eine auswählst, prüfe, ob sie dort funktioniert, wo dein Code ausgeführt wird.

Surface Workspace-Geheimnis-Scope Secret in Unity Catalog
dbutils.secrets in Notebooks und Aufträge Yes. Siehe Lies ein Geheimnis. Ja, in der serverlosen Umgebung Version 4 und höher oder Databricks Runtime 17.3 LTS und höher. Siehe Lies ein Geheimnis.
REST API und Databricks CLI Yes. Von der API zurückgegebene Werte sind nicht geschwärzt. Yes. Von der API zurückgegebene Werte sind nicht geschwärzt.
Remote-Entwicklung, z. B. mit Databricks Connect Ja, mit dbutils.secrets im Databricks Connect-Client. Siehe Databricks Utilities with Databricks Connect für Python. No
Unity Catalog Python und Scala UDFs No Yes. Anrufer brauchen nur EXECUTE. Siehe Geheimnisse in UDFs verwenden.
SQL-Warenhäuser Ja, mit der geheimen Funktion Nur über ein Unity-Katalog-Python- oder Scala-UDF, das das Geheimnis deklariert
Spark-Konfigurationseigenschaften und Umgebungsvariablen auf Compute Yes. Weitere Informationen finden Sie unter Verwenden eines Geheimnisses in einer Spark-Konfigurationseigenschaft oder -Umgebungsvariable. No
Umgebungsvariablen des Modellbereitstellungsendpunkts Yes. Siehe Hinzufügen geheimer Umgebungsvariablen. No
Standard-Paketquellen Ja, im databricks-package-management Bereich. Siehe Standard-Paket-Repositorien konfigurieren. No

Zusätzliche Ressourcen

Resource Description
Geheimnisse im Unity-Katalog Erstellen Sie Unity Catalog-Geheimnisse, gewähren Sie Zugriff und lesen Sie sie in Notebooks, Aufträge und UDFs.
Bewährte Methoden für Unity Catalog-Geheimnisse Organisieren Sie Geheimnisse nach Umgebung, Anwendung oder Team und lassen Sie Workloads Geheimnisse verwenden, ohne sie zu lesen.