Überblick
Die Live Stream API verwendet Identity and Access Management (IAM) für die Zugriffssteuerung.
Sie können die Zugriffssteuerung für die Live Stream API auf Projektebene konfigurieren. Sie können Entwicklern dann beispielsweise Zugriff zum Auflisten und Abrufen aller Ereignisse innerhalb eines Projekts gewähren.
Eine ausführliche Beschreibung von IAM und den entsprechenden Funktionen finden Sie in der IAM-Dokumentation. Lesen Sie insbesondere den Abschnitt IAM-Richtlinien verwalten.
Der Aufrufer muss für jede Live Stream API-Methode die erforderlichen Berechtigungen haben. Weitere Informationen finden Sie unter Berechtigungen und Rollen.
Berechtigungen
In diesem Abschnitt werden die von IAM unterstützten Live Stream API-Berechtigungen zusammengefasst.
Erforderliche Berechtigungen
In den folgenden Tabellen sind die IAM-Berechtigungen aufgeführt, die mit der Live Stream API verknüpft sind.
| Name der Kanalmethode | Erforderliche Berechtigungen |
|---|---|
channels.create
|
livestream.channels.create für den übergeordneten Standort, d. h. eine bestimmte Kombination aus Google Cloud-Projekt und Datenstandort. |
channels.delete |
livestream.channels.delete für die Kanalressource. |
channels.get |
livestream.channels.get für die Kanalressource. |
channels.list
|
livestream.channels.list für den übergeordneten Standort, d. h. eine bestimmte Kombination aus Google Cloud-Projekt und Datenstandort. |
channels.patch |
livestream.channels.update für die Kanalressource. |
channels.start |
livestream.channels.start für die Kanalressource. |
channels.stop |
livestream.channels.stop für die Kanalressource. |
| Name der Ereignismethode | Erforderliche Berechtigungen |
|---|---|
events.create
|
livestream.events.create für den übergeordneten Kanal für die Ressource. |
events.delete |
livestream.events.delete für die Ereignisressource. |
events.get |
livestream.events.get für die Ereignisressource. |
events.list
|
livestream.events.list für den übergeordneten Kanal für die Ressource. |
| Name der Eingabemethode | Erforderliche Berechtigungen |
|---|---|
inputs.create
|
livestream.inputs.create für den übergeordneten Standort, d. h. eine bestimmte Kombination aus Google Cloud-Projekt und Datenstandort. |
inputs.delete |
livestream.inputs.delete für die Eingaberessource. |
inputs.get |
livestream.inputs.get für die Eingaberessource. |
inputs.list
|
livestream.inputs.list für den übergeordneten Standort, d. h. eine bestimmte Kombination aus Google Cloud-Projekt und Datenstandort. |
inputs.patch |
livestream.inputs.update für die Eingaberessource. |
| Name der Asset-Methode | Erforderliche Berechtigungen |
|---|---|
assets.create
|
livestream.assets.create für den übergeordneten Standort, d. h. eine bestimmte Kombination aus Google Cloud-Projekt und Datenstandort. |
assets.delete |
livestream.assets.delete für die Asset-Ressource. |
assets.get |
livestream.assets.get für die Asset-Ressource. |
assets.list
|
livestream.assets.list für den übergeordneten Standort, d. h. eine bestimmte Kombination aus Google Cloud-Projekt und Datenstandort. |
Rollen
In der folgenden Tabelle sind die IAM-Rollen der Live Stream API einschließlich der mit jeder Rolle verknüpften Berechtigungen aufgeführt:
Weitere Informationen zu Rollen finden Sie hier.
Zugriff auf Cloud Storage
Standardmäßig hat die Live Stream API Zugriff auf alle Cloud Storage-Buckets Ihres Projekts. Wenn Sie Ihr erstes Livestreaming-Ereignis erstellen, erstellt die Live Stream API ein Dienstkonto mit der folgenden Namenskonvention:
service-PROJECT_NUMBER@gcp-sa-livestream.iam.gserviceaccount.com
PROJECT_NUMBER ist die Anzahl Ihres Projekts mit aktivierter Live Stream API. Diesem Dienstkonto wird die Rolle „Live-Stream-Dienst-Agent“ zugewiesen und er kann die folgenden Aufgaben ausführen:
- Dateien in den Cloud Storage-Buckets Ihres Projekts lesen
- Dateien in die Cloud Storage-Buckets Ihres Projekts hochladen
- Dateien in den Cloud Storage-Buckets Ihres Projekts löschen
- Dateien und deren Metadaten in den Cloud Storage-Buckets Ihres Projekts auflisten
Zugriff einschränken
Wenn Sie diesen Zugriff auf Ihre Cloud Storage-Buckets beschränken möchten, entfernen Sie die Rolle „Live-Stream-Dienst-Agent“ aus dem Dienstkonto und ersetzen Sie sie durch einen feiner abgestimmten Zugriff. Gehen Sie so vor:
- Rufen Sie in der Google Cloud Console die Seite IAM (Tab Berechtigungen) auf.
- Suchen Sie das Dienstkonto mit der Rolle „Live Stream-Dienst-Agent“ und klicken Sie auf die Schaltfläche „Bearbeiten“.
- Löschen Sie die Rolle „Dienst-Agent für Livestream“ aus dem Dienstkonto.
- Gewähren Sie Zugriff auf das Dienstkonto für jeden einzelnen Cloud Storage-Bucket:
- Zum Cloud Storage-Browser
- Klicken Sie auf einen Bucket.
- Wählen Sie den Tab Berechtigungen aus.
- Klicken Sie auf Hinzufügen.
- Geben Sie im Feld Neue Hauptkonten den Namen des Dienstkontos ein.
- Wählen Sie unter Rolle die Rolle Storage-Objekt-Administrator aus.
- Klicken Sie auf Speichern. Die Live Stream API hat jetzt Zugriff auf den Bucket.
| Live Stream API-Rolle | Berechtigungen |
|---|---|
roles/livestream.viewer |
|
roles/livestream.editor |
Alle roles/livestream.viewer-Berechtigungen sowie:
|