Zugriffssteuerung für verwaltete Notebooks
Auf dieser Seite wird beschrieben, wie Sie Identity and Access Management (IAM) und einen Zugriffsmodus verwenden, um den Zugriff auf von Vertex AI Workbench verwaltete Notebook-Ressourcen zu verwalten. Informationen zum Verwalten des Zugriffs auf Vertex AI-Ressourcen finden Sie auf der Seite Vertex AI-Seite zur Zugriffssteuerung.
Vertex AI Workbench nutzt IAM für die Verwaltung des Zugriffs auf verwaltete Notebookinstanzen und einen Zugriffsmodus zur Verwaltung des Zugriffs auf die JupyterLab-Schnittstelle jeder Instanz.
Zugriff auf eine Instanz mit IAM steuern
Sie können den Zugriff auf eine verwaltete Notebookinstanz auf Projektebene oder pro Instanz verwalten.
- Weisen Sie einem Hauptkonto (Nutzer, Gruppe oder Dienstkonto) eine oder mehrere Rollen zu, um Zugriff auf Ressourcen auf Projektebene zu gewähren.
- Um Zugriff auf eine bestimmte Instanz zu gewähren, legen Sie eine IAM-Richtlinie für diese Ressource fest. Die Richtlinie definiert, welche Rollen welchen Hauptkonten zugewiesen werden. Weitere Informationen finden Sie unter Zugriff auf eine verwaltete Notebookinstanz verwalten.
Der Zugriff auf eine Instanz kann eine breite Palette von Funktionen umfassen. Beispielsweise können Sie einem Hauptkonto die Möglichkeit geben, eine Instanz zu starten, zu beenden und zu aktualisieren. Auch wenn Sie einem Hauptkonto vollständigen Zugriff auf eine verwaltete Notebook-Instanz gewähren, können Sie nicht die JupyterLab-Schnittstelle der Instanz verwenden. Weitere Informationen finden Sie im folgenden Abschnitt.
Den Zugriff auf die JupyterLab-Schnittstelle einer Instanz mit dem Zugriffsmodus steuern
Sie steuern den Zugriff auf die JupyterLab-Schnittstelle einer verwalteten Notebook-Instanz über den Zugriffsmodus der Instanz. Sie legen den Zugriffsmodus für JupyterLab fest, wenn Sie eine verwaltete Notebookinstanz erstellen. Der Zugriffsmodus kann nach dem Erstellen des Notebooks nicht mehr geändert werden.
Der Zugriffsmodus für JupyterLab bestimmt, wer die JupyterLab-Schnittstelle der Instanz verwenden kann. Der Zugriffsmodus legt auch fest, welche Anmeldedaten verwendet werden, wenn Ihre Instanz mit anderen Google Cloud-Diensten interagiert. Weitere Informationen finden Sie unter Zugriff auf die JupyterLab-Schnittstelle einer verwalteten Notebook-Instanz verwalten.
IAM-Rollentypen
In Vertex AI Workbench können verschiedene Arten von IAM-Rollen verwendet werden:
Mit vordefinierten Rollen können Sie auf Projektebene eine Reihe von zugehörigen Berechtigungen für Ihre Vertex AI Workbench-Ressourcen gewähren.
Einfache Rollen (Inhaber, Bearbeiter und Betrachter) ermöglichen die Zugriffssteuerung auf Ihre Vertex AI Workbench-Ressourcen auf Projektebene und sind für alle Google Cloud-Dienste üblich.
Benutzerdefinierte Rollen ermöglichen es Ihnen, einen bestimmten Satz von Berechtigungen auszuwählen, eine eigene Rolle mit diesen Berechtigungen zu erstellen und Nutzern in Ihrer Organisation diese Rolle zuzuweisen.
Informationen zum Hinzufügen, Aktualisieren oder Entfernen dieser Rollen in Ihrem Vertex AI Workbench-Projekt finden Sie in der Dokumentation zum Verwalten des Zugriffs auf Projekte, Ordner und Organisationen.
Vordefinierte Rollen für Vertex AI Workbench
Vertex AI Workbench-Ressourcen werden über die Notebooks API verwaltet. Daher definieren Notebooks-Rollen Berechtigungen und den Zugriff für die Verwendung von Vertex AI Workbench.
Role | Permissions |
---|---|
Notebooks Admin( Full access to Notebooks, all resources. Lowest-level resources where you can grant this role:
|
|
Notebooks Legacy Admin( Full access to Notebooks all resources through compute API. |
|
Notebooks Legacy Viewer( Read-only access to Notebooks all resources through compute API. |
|
Notebooks Runner( Restricted access for running scheduled Notebooks. |
|
Notebooks Viewer( Read-only access to Notebooks, all resources. Lowest-level resources where you can grant this role:
|
|
Einfache Rollen
Die älteren grundlegenden Rollen von Google Cloud sind für alle Google Cloud-Dienste üblich. Diese Rollen heißen "Inhaber", "Bearbeiter" und "Betrachter".
Die einfachen Rollen gewähren Berechtigungen in Google Cloud insgesamt und nicht nur für Vertex AI Workbench. Aus diesem Grund sollten Sie wann immer möglich Vertex AI Workbench-Rollen verwenden.
Benutzerdefinierte Rollen
Wenn die vordefinierten IAM-Rollen für Vertex AI Workbench nicht Ihren Anforderungen entsprechen, können Sie benutzerdefinierte Rollen definieren. Benutzerdefinierte Rollen ermöglichen es Ihnen, einen bestimmten Satz von Berechtigungen zu wählen, eine eigene Rolle mit diesen Berechtigungen zu erstellen und diese Rolle Nutzern in Ihrer Organisation zu gewähren. Weitere Informationen finden Sie unter Informationen zu benutzerdefinierten IAM-Rollen.
Richtlinien auf Projektebene/Ressourcenebene
Eine Ressource übernimmt alle Richtlinien von ihrem
Ancestor.
Eine auf Ressourcenebene festgelegte Richtlinie wirkt sich nicht auf Richtlinien auf Projektebene aus. Sie können Berechtigungen auf Projektebene und Ressourcenebene verwenden, um Berechtigungen anzupassen.
Beispiel: Sie können Nutzern roles/notebooks.viewer
-Berechtigungen auf Projektebene erteilen, damit sie alle Vertex-AI Workbench-Ressourcen im Projekt anzeigen können, und dann jedem Nutzer roles/notebooks.admin
-Berechtigungen für eine bestimmte verwaltete Notebookinstanz zuweisen, sodass diese alle admin
-Berechtigungen zum Verwalten dieser Instanz haben.
Nicht alle vordefinierten Rollen und Ressourcen von Vertex AI Workbench unterstützen Richtlinien auf Ressourcenebene. Sehen Sie sich Beschreibungen der einzelnen Rollen an, um zu sehen, welche Rollen für welche Ressourcen verwendet werden können.
Änderungen am Zugriff auf eine Ressource dauern etwas länger. Weitere Informationen finden Sie unter Zugriffsänderungsverteilung.
Informationen zu Dienstkonten
Ein Dienstkonto ist ein spezieller Kontotyp, der nicht von einer Person, sondern von einer Anwendung oder einer VM-Instanz verwendet wird. Sie können Dienstkonten erstellen und ihnen Berechtigungen zuweisen, um bestimmte Berechtigungen für eine Ressource oder Anwendung zu gewähren.
Wenn Ihr Notebook in einer verwalteten Notebookinstanz Code ausführt, der mit Vertex AI oder anderen Google Cloud-Diensten interagiert, können Sie ein Dienstkonto mit bestimmten IAM-Rollen verwenden, um Ihre verwaltete Notebook-Instanzen für diese Dienste zu authentifizieren.
Dienstkonten sind durch eine E-Mail-Adresse gekennzeichnet.