Bewährte Methoden für Unity Catalog-Geheimnisse

Organisiere Unity-Catalog-Geheimnisse so, dass jede Anwendung nur auf ihre eigenen Geheimnisse zugreifen kann, die meisten Principals ein Geheimnis verwenden, ohne dessen Wert zu lesen, und du kontrollierst den Schlüssel, der die Werte verschlüsselt. Informationen zum Erstellen, Vergeben und Lesen von Geheimnissen finden Sie unter Secrets in Unity Catalog.

Geheimnisse gruppieren nach dem, wer sie braucht

Erstellen Sie für jede Anwendung, Umgebung oder jedes Team ein Schema und gewähren Sie CREATE SECRET Rechte auf das Schema statt auf den Katalog. Ein Schema hält bis zu 1.000 Secrets, ein Metastore bis zu 10.000.

  • Grant auf ein einzelnes Secret: Ein Grant auf ein Schema gilt für jedes darin enthaltene Secret, einschließlich später hinzugefügter Secrets. Wenn ein Prinzipal nur ein Geheimnis benötigt, gewähren Sie READ SECRET für dieses Geheimnis anstatt für dessen Schema.
  • Gib Produktionsgeheimnissen bei Bedarf einen eigenen Katalog: Workspace-Bindung und kundenverwaltete Schlüssel gelten für einen ganzen Katalog. Um Produktionsgeheimnisse aus Entwicklungsarbeitsräumen herauszuhalten oder sie mit einem eigenen Schlüssel zu verschlüsseln, sollte man sie in einen separaten Katalog aufnehmen. Siehe Workspace-catalog binding und Von Azure Databricks verwaltete Geheimnisse mit Ihrem eigenen Schlüssel verschlüsseln.

Jeder Key Vault verwendet sein eigenes Schema. UC-Privilegien entscheiden, wer die Geheimnisse nutzen darf.

Um der Bestellungsanwendung ein eigenes Schema zu geben und einen Berichtsauftrag zu erlauben, nur eines seiner Geheimnisse zu lesen, führen Sie Folgendes aus:

-- The application's service principal reads every secret in its schema
CREATE SCHEMA main.orders_app;
GRANT USE CATALOG ON CATALOG main TO `orders-service-principal`;
GRANT USE SCHEMA, READ SECRET ON SCHEMA main.orders_app TO `orders-service-principal`;

-- The reporting job reads only the warehouse password
GRANT USE CATALOG ON CATALOG main TO `reporting-service-principal`;
GRANT USE SCHEMA ON SCHEMA main.orders_app TO `reporting-service-principal`;
GRANT READ SECRET ON SECRET main.orders_app.warehouse_password TO `reporting-service-principal`;

Für Geheimnisse, die durch Azure Key Vault gesichert sind, verwenden Sie für jedes Schema einen Key Vault, mit eigener Service-Zugangsdaten und Verbindung. Key Vault-Verbindungen unterstützen keine Tag-Filter, daher ist der Vault die Grenze. Wenn ein Tresor mehr als 1.000 Geheimnisse enthält, importiert der Unity-Katalog zuerst die ältesten und überspringt den Rest.

Sichern Sie kein Schema, auf das viele Anwendungen mit einem gemeinsamen Key Vault-Zugriff haben, ab.

Verwalten Sie Berechtigungen, um Geheimnisse separat zu entdecken, zu wechseln und zu lesen

Jedes davon ist ein separates Privileg, sodass ein Prinzipal, der ein Geheimnis aktualisiert oder es im Katalog-Explorer findet, seinen Wert nicht sehen muss:

Um einen Prinzipal zuzulassen Grant Gibt den Wert zurück
Geheimnisse finden und Zugang anfordern BROWSE auf den Katalog. Es zeigt die Metadaten jedes Geheimnisses, wie Name, Besitzer und Ablaufdatum. No
Rotiere ein Secret, indem du seinen Wert aktualisierst WRITE SECRET No
Lesen Sie den Wert, zum Beispiel in einem Job mit dbutils.secrets READ SECRET Yes

Für die vollständige Liste der Privilegien siehe Zugriff auf Secrets gewähren.

Damit alle die Geheimnisse finden und Zugriff anfordern können und ein Rotationsauftrag das Warehouse-Passwort aktualisieren kann, ohne es zu lesen, führe Folgendes aus:

GRANT BROWSE ON CATALOG main TO `account users`;

GRANT USE CATALOG ON CATALOG main TO `rotation-service-principal`;
GRANT USE SCHEMA ON SCHEMA main.orders_app TO `rotation-service-principal`;
GRANT WRITE SECRET ON SECRET main.orders_app.warehouse_password TO `rotation-service-principal`;

BROWSE zeigt Kommentare allen an, die es haben. Nutze den Kommentar eines Secrets, um zu sagen, wem es gehört und wie man Zugang anfordert. Setzen Sie niemals einen Wert oder auch nur einen Hinweis darauf in einen Kommentar.

Verschlüsseln Sie Azure Databricks-managed Geheimnisse mit Ihrem eigenen Schlüssel

Customer-Managed Key (CMK)-Einstellungen in einem Katalog gelten für jedes von Azure Databricks verwaltete Geheimnis darin. Um Produktionsgeheimnisse mit einem separaten Schlüssel zu verschlüsseln, speichern Sie sie in ihrem eigenen Katalog. Wie CMK auf Geheimnisse angewendet wird, siehe Verschlüsselung von Geheimniswerten mit kundenseitig verwalteten Schlüsseln.

Geheimnisse an der Quelle rotieren

Für Geheimwerte, die in Azure Key Vault gespeichert sind, wechseln Sie Werte in Azure Key Vault, zum Beispiel mit einer Key Vault-Rotationsrichtlinie. Kopieren Sie ihre Werte nicht in von Azure Databricks verwaltete Geheimnisse, denn jede Kopie ist ein weiterer Wert, der rotiert werden muss.

Für von Azure Databricks verwaltete Geheimnisse aktualisieren Sie den Wert im Catalog Explorer oder mit der REST-API. Setze ein Ablaufdatum, sodass der Katalog-Explorer eine Warnung anzeigt, wenn das Secret abläuft.

Code, der bereits einen Wert enthält, behält ihn, bis er das Secret erneut liest. In lang laufenden Jobs solltest du das Secret jedes Mal lesen, wenn du eine Verbindung öffnest, statt nur beim Start.

Ermögliche Workloads, Secrets zu verwenden, ohne sie zu lesen

Die meisten Benutzer, die sich auf ein Geheimnis verlassen, müssen dessen Wert nie sehen. Ein Unity Catalog UDF, das ein Geheimnis deklariert, liest es mit den Berechtigungen seines Besitzers, sodass Aufrufer nur EXECUTE auf dem UDF benötigen, zum Beispiel um persönliche Daten zu maskieren oder zu hashen. Im Gegensatz dazu benötigt jeder, der eine SQL-Funktion ausführt, die secret() für einen Workspace-Secret-Scope aufruft, READ für den Scope, wodurch jedes darin enthaltene Geheimnis offengelegt wird. Siehe Geheimnisse in UDFs verwenden.

  • Gewähren Sie READ SECRET nur den Service-Principals, die Jobs ausführen, den Eigentümern der UDFs, die das Geheimnis deklarieren, und der kleinen Gruppe, die die Geheimnisse besitzt.
  • Mach eine Gruppe oder einen Service Principal zum Besitzer jedes UDF, das ein Secret deklariert, damit das UDF nicht ausfällt, wenn jemand das Unternehmen verlässt.
  • Verwenden Sie sitzungsgebundene UDFs nur, wenn jeder Anrufer das Secret bereits lesen kann. Sie lesen Geheimnisse mit den Berechtigungen des Aufrufers.

Warning

Gib niemals einen geheimen Wert von einem UDF zurück. Redaction verhindert nicht, dass UDF-Code einen Wert in den Abfrageergebnissen zurückgibt.

Ein Modell-Provider-Dienst kann auch ein Unity-Catalog-Geheimnis als Provider-Zugangsdaten verwenden, sodass Aufrufer das Modell abfragen, ohne den Schlüssel zu sehen. Weitere Informationen finden Sie unter „Anmeldeinformationen eines Anbieters mit einem Geheimnis in Unity Catalog absichern“.

Kontrollieren, wer Zugriff gewähren kann, und dies auditieren

  • Weisen Sie den Besitz von Secrets und deren Schemata einer Gruppe statt einer Einzelperson zu.
  • Metastore-Admins und Prinzipale mit MANAGE können keinen Wert lesen, aber sie können sich selbst READ SECRET gewähren. Beschränke MANAGE auf eine kleine Gruppe.
  • Überprüfen Sie Lesezugriffe und Berechtigungen für Geheimnisse in der system.access.audit Systemtabelle. Siehe Audit-Geheimniszugriff.

Zusätzliche Ressourcen

Resource Description
Geheimnisse im Unity-Katalog Erstellen Sie Unity Catalog-Geheimnisse, vergeben Sie sie und lesen Sie sie.
Verwaltung von Geheimnissen Vergleichen Sie Unity Catalog-Geheimnisse mit Workspace-Geheimnisbereichen, und erfahren Sie, wo Sie diese jeweils verwenden können.