API-Zugriff – Überblick

Auf dieser Seite werden die Möglichkeiten der API-Zugriffssteuerung beschrieben, die in Cloud Endpoints zur Verfügung stehen.

Übersicht

In Endpoints wird der Zugriff auf die API über Cloud Identity and Access Management (Cloud IAM) gesteuert. Sie können den Zugriff auf Projektebene und auf der individuellen Dienstebene von Endpoints erteilen. Sie können zum Beispiel:

  • Projektmitgliedern Zugriff auf einzelne Dienste gewähren
  • Nutzer- oder Dienstkonten die Berechtigung erteilen, eine aktualisierte Endpoints-Konfiguration zu implementieren
  • Ihren API-Nutzern Zugriff erteilen, damit diese die API in ihrem eigenen Google Cloud-Projekt aktivieren können

Rollen, mit denen der Zugriff auf Dienste gesteuert wird

Sie können die folgenden Rollen für einen bestimmten Dienst auf der Seite Endpoints > Dienste in der Google Cloud Console vergeben. Verwenden Sie dazu die API oder das gcloud-Befehlszeilentool.

Name der Cloud IAM-Rolle Rollentitel Beschreibung
roles/servicemanagement.serviceConsumer Dienstnutzer Berechtigungen für ein Nicht-Projektmitglied zum Aufrufen und Aktivieren der API im eigenen Projekt des Mitglieds. Die Rolle Dienstnutzer kann nur für Google-Konten, Google Groups oder Dienstkonten zugewiesen werden. Wenn Sie ein Portal für Ihre API erstellt haben, ermöglicht diese Rolle Ihren API-Nutzern den Zugriff auf das Portal. Informationen zu dieser Rolle finden Sie unter Zugriffssteuerung für die Service Management API.
roles/servicemanagement.serviceController Dienstüberwacher Berechtigung zum Aufrufen der Methoden check und report in der Service Infrastructure API während der Laufzeit. Diese Rolle wird in der Regel Dienstkonten zugewiesen. Informationen zu dieser Rolle finden Sie unter Zugriffssteuerung für die Service Management API.
roles/servicemanagement.configEditor Dienstkonfigurationsbearbeiter Berechtigung zum Bereitstellen von Endpoints-Konfigurationen. Diese Rolle ist restriktiver als die Rolle Projektbearbeiter, die für einen Dienst erteilt wird.
roles/servicemanagement.admin Dienstverwaltungsadministrator Alle Dienstkonfigurationsbearbeiter-Berechtigungen und Berechtigungen zum Verwalten des Zugriffs auf die API. Vergleichbar mit der Rolle Projektinhaber, die für einen Dienst erteilt wird.

Portalberechtigungen für Endpunkte

Die Rolle Endpoints-Portal-Administrator, die eine Rolle auf Projektebene ist, enthält die folgenden Berechtigungen.

Berechtigung Beschreibung
endpoints.portals.listCustomDomains Berechtigung zum Zugriff auf die Endpoints-Portalseite in der Cloud Console. Projektmitglieder, denen die Rolle Projektbetrachter erteilt wurde, haben ebenfalls diese Berechtigung.
endpoints.portals.attachCustomDomain Berechtigung zum Hinzufügen einer benutzerdefinierten Domain auf der Endpoints-Portalseite in der Cloud Console. Projektmitglieder, denen die Rolle Projektbearbeiter zugewiesen wurde, haben ebenfalls diese Berechtigung.
endpoints.portals.detachCustomDomain Berechtigung zum Löschen einer benutzerdefinierten Domain auf der Endpoints-Portalseite in der Cloud Console. Projektmitglieder, denen die Rolle Projektbearbeiter zugewiesen wurde, haben ebenfalls diese Berechtigung.
endpoints.portals.update Auf dem Portal, das für eine API erstellt wurde, Berechtigung zum Öffnen des Tabs Gesamte Website auf der Seite Einstellungen, um beispielsweise Einstellungen wie die Farbe und das Logo des Portals zu ändern.

Weitere Informationen