PostgreSQL-Nutzer und ‑Rollen

Auf dieser Seite erfahren Sie, wie Cloud SQL mit PostgreSQL-Nutzern und -Rollen arbeitet. Mit PostgreSQL-Rollen können Sie den Zugriff und die Funktionen von Nutzern steuern, die auf eine PostgreSQL-Instanz zugreifen.

Eine vollständige Dokumentation zu PostgreSQL-Rollen finden Sie in der PostgreSQL-Dokumentation unter Datenbankrollen. Weitere Informationen zum Erstellen und Verwalten von Cloud SQL-Nutzern finden Sie unter Nutzer erstellen und verwalten.

Unterschied zwischen Nutzern und Rollen

PostgreSQL-Rollen können eine einzelne Rolle oder eine Gruppe von Rollen darstellen. Ein Nutzer ist eine Rolle mit der Berechtigung zur Anmeldung (die Rolle hat das Attribut LOGIN). Da alle Rollen, die von Cloud SQL erstellt werden, das Attribut LOGIN enthalten, verwendet Cloud SQL die Begriffe Rolle und Nutzer synonym. Wenn Sie jedoch eine Rolle mit dem psql-Client erstellen, hat die Rolle nicht unbedingt das Attribut LOGIN.

Alle PostgreSQL-Nutzer müssen ein Passwort haben. Sie können sich nicht mit einem Nutzer anmelden, der kein Passwort hat.

Superuser-Einschränkungen und -Berechtigungen

Cloud SQL for PostgreSQL ist ein verwalteter Dienst, daher wird der Zugriff auf bestimmte Systemprozeduren und -tabellen eingeschränkt, für die erweiterte Berechtigungen erforderlich sind. In Cloud SQL können Kunden keine Nutzer mit Superuser-Attributen erstellen oder darauf zugreifen.

Sie können keine Datenbanknutzer mit Superuser-Berechtigungen erstellen. Sie können jedoch Datenbanknutzer mit der Rolle cloudsqlsuperuser erstellen, die einige dieser Superuser-Berechtigungen hat, darunter:

  • Erweiterungen erstellen, die Superuser-Berechtigungen erfordern.
  • Ereignistrigger erstellen.
  • Replikationsnutzer erstellen.
  • Replikationspublikationen und -abos erstellen.
  • Ausführen der Anweisungen CREATE CAST und DROP CAST als Datenbanknutzer mit der Rolle cloudsqlsuperuser. Dieser Nutzer muss jedoch die Berechtigung USAGE für die Quell- und Zieldatentypen haben. Ein Nutzer kann beispielsweise eine Umwandlung erstellen, die den Quelldatentyp int in den Zieldatentyp boolean konvertiert.

  • Vollständiger Zugriff auf die Katalogtabelle pg_largeobject.

PostgreSQL-Standardnutzer

Wenn Sie eine neue Cloud SQL for PostgreSQL-Instanz erstellen, wird der Standardadministrator postgres erstellt, aber nicht das zugehörige Passwort. Sie müssen ein Passwort für diesen Nutzer festlegen, bevor Sie sich anmelden können. Sie können dies entweder in der Google Cloud Console oder mit dem folgenden gcloud-Befehl tun:

gcloud sql users set-password postgres \
--instance=INSTANCE_NAME \
--password=PASSWORD

Der postgres-Nutzer gehört zur cloudsqlsuperuser-Rolle und hat die folgenden Attribute (Berechtigungen): CREATEROLE, CREATEDB und LOGIN. Er hat nicht die Attribute SUPERUSER oder REPLICATION.

Ein cloudsqlimportexport-Standardnutzer wird mit den minimalen Berechtigungen erstellt, die für CSV-Importe- und -Exporte erforderlich sind. Sie können Ihre eigenen Nutzer erstellen, um diese Vorgänge auszuführen. Wenn Sie das nicht tun, wird der cloudsqlimportexport-Standardnutzer verwendet. Der cloudsqlimportexport-Nutzer ist ein Systemnutzer, der von Ihnen nicht direkt verwendet werden kann.

Cloud SQL-Systemnutzer und -rollen

Cloud SQL verwendet Systemnutzer und -rollen, um Cloud SQL-Features zu unterstützen. Sie können Cloud SQL-Systemrollen oder -Nutzer weder löschen noch ändern. Sie können Datenbanknutzern keine Systemrollen zuweisen, mit Ausnahme der Rolle cloudsqlsuperuser. Sie können Systemnutzern keine Datenbankrollen zuweisen.

  • Systemrollen

    • cloudsqliamgroup

      Wird verwendet, um ein IAM-Gruppenauthentifizierungskonto ohne Anmeldung festzulegen, das für die IAM-Gruppenauthentifizierung verwendet wird.

    • cloudsqlinactiveuser

      Wird verwendet, um ein IAM-Gruppenauthentifizierungskonto als inaktiv zu kennzeichnen.

    • cloudsqliamgroupserviceaccount

      Wird verwendet, um ein IAM-Dienstkonto festzulegen, das sich über die IAM-Gruppenauthentifizierung authentifiziert.

    • cloudsqliamgroupuser

      Wird verwendet, um einen IAM-Nutzer zu kennzeichnen, der sich über die IAM-Gruppenauthentifizierung authentifiziert.

    • cloudsqliamserviceaccount

      Wird verwendet, um ein IAM-Dienstkonto festzulegen, das sich über die IAM-Datenbankauthentifizierung authentifiziert.

    • cloudsqliamuser

      Wird verwendet, um einen IAM-Nutzer zu kennzeichnen, der sich über die IAM-Datenbankauthentifizierung authentifiziert.

    • cloudsqlsuperuser

      Rolle, die Nutzern mit eingeschränkten Superuser-Berechtigungen zugewiesen wird. Die Rolle cloudsqlsuperuser wird neuen PostgreSQL-Nutzern, die die integrierte Authentifizierung verwenden, automatisch zugewiesen.

  • Systemnutzer

    • cloudsqladmin

      Systemnutzer mit Superuser-Berechtigungen für die Datenbank.

    • cloudsqlagent

      Wird für das Monitoring von Datenbanken verwendet.

    • cloudsqlconnpooladmin

      Wird für das verwaltete Verbindungs-Pooling verwendet.

    • cloudsqlimportexport

      Wird für den Datenimport und -export verwendet.

    • cloudsqllogical

      Wird zum Erstellen einer logischen Replikation verwendet.

    • cloudsqlobservability

      Wird für die Beobachtbarkeit von Datenbanken verwendet, z. B. für den Indexberater und aktive Abfragen.

    • cloudsqlreplica

      Wird für die Replikation verwendet.

Cloud SQL-IAM-Nutzer für die IAM-Authentifizierung

Identity and Access Management (IAM) ist in Cloud SQL über ein Feature namens IAM-Datenbankauthentifizierung eingebunden. Wenn Sie Instanzen mit dieser Funktion erstellen, können sich IAM-Nutzer mit ihren IAM-Nutzernamen und -Passwörtern in der Instanz anmelden. Der Vorteil der IAM-Authentifizierung besteht darin, dass Sie die vorhandenen IAM-Anmeldedaten eines Nutzers verwenden können, wenn Sie ihm Zugriff auf eine Datenbank gewähren. Wenn der Nutzer die Organisation verlässt, wird sein IAM-Konto gesperrt und der Zugriff wird automatisch aufgehoben.

Weitere PostgreSQL-Nutzer

Sie können weitere PostgreSQL-Nutzer oder -Rollen erstellen. Mit Cloud SQL erstellte Nutzer, die nicht mit IAM erstellt wurden, werden als Teil der Rolle cloudsqlsuperuser erstellt und haben dieselben Attribute wie der Nutzer postgres: CREATEROLE, CREATEDB und LOGIN. Mit dem Befehl ALTER ROLE können Sie die Attribute jedes Nutzers ändern.

Wenn Sie einen neuen Nutzer mit dem psql-Client erstellen, können Sie ihn mit einer anderen Rolle verknüpfen oder ihm andere Attribute zuweisen.

PostgreSQL-Rollen

Sie können in PostgreSQL benutzerdefinierte Rollen erstellen, um Datenbankberechtigungen für Ihre PostgreSQL-Nutzer zu organisieren und zuzuweisen. Sie können Rollen verwenden, um Nutzern beim Erstellen einer Cloud SQL-Instanz erste Datenbankberechtigungen zu gewähren.

Weitere Informationen zum Erstellen und Verwenden von Rollen in PostgreSQL finden Sie unter Datenbankrollen.

Wenn Sie einen integrierten PostgreSQL-Nutzer in Cloud SQL for PostgreSQL erstellen und keine Datenbankrollen zuweisen, wird dem Nutzer automatisch die Rolle cloudsqlsuperuser zugewiesen. Alternativ können Sie einen neuen PostgreSQL-Nutzer erstellen und eine andere benutzerdefinierte Rolle oder Rollen mit detaillierteren Berechtigungen zuweisen. Weitere Informationen zum Zuweisen von Rollen zu Nutzern in Cloud SQL for PostgreSQL finden Sie unter Nutzer mit integrierter Authentifizierung verwalten.

Sicherer Suchpfad

Um Suchpfad-Hijacking zu verhindern, muss für Nutzer mit hohen Berechtigungen der Parameter search_path auf pg_catalog gesetzt sein. So wird sichergestellt, dass der Suchpfad geschützt ist und nicht vertrauenswürdige Schemas wie public umgangen werden.

Führen Sie den folgenden Befehl aus, um dies für einen Nutzer dauerhaft festzulegen:

ALTER ROLE <var>USER_NAME</var> SET search_path = pg_catalog;

Führen Sie den folgenden Befehl aus, um sie für die aktuelle Sitzung festzulegen:

SET search_path TO pg_catalog;

Weitere Informationen finden Sie in der PostgreSQL-Dokumentation zur sicheren Schemanutzung und im CVE-2018-1058-Leitfaden.

IAM-Nutzer und Datenbankrollen

Wenn Sie ein IAM-Nutzerkonto in Cloud SQL for PostgreSQL erstellen und keine Datenbankrollen zuweisen, werden dem Nutzer nicht automatisch Datenbankrollen zugewiesen.

Sie können IAM-Nutzern, Dienstkonten oder Gruppen die Rolle cloudsqlsuperuser und benutzerdefinierte Datenbankrollen zuweisen, indem Sie Datenbankrollen zuweisen, wenn Sie die IAM-Konten auf der Instanz erstellen oder aktualisieren.

Weitere Informationen zum Zuweisen von Rollen zu IAM-Nutzern finden Sie unter Datenbankrollen beim Hinzufügen eines IAM-Kontos zu einer Instanz zuweisen.

Zugriff auf die Ansicht pg_shadow und die Tabelle pg_authid

Durch Verwendung der Ansicht pg_shadow können Sie mit den Attributen von Rollen arbeiten, die in der Katalogtabelle pg_authid als rolcanlogin markiert sind.

Die Ansicht pg_shadow enthält gehashte Passwörter und andere Attribute der Rollen (Nutzer), die sich in einem Cluster anmelden dürfen. Die Katalogtabelle pg_authid enthält gehashte Passwörter und andere Attribute für alle Datenbankrollen.

In Cloud SQL können Kunden mit den Standardberechtigungen nicht auf die Ansicht pg_shadow oder die Tabelle pg_authid zugreifen. Der Zugriff auf Rollennamen und gehashte Passwörter ist jedoch in bestimmten Situationen nützlich, darunter:

  • Proxys oder Load Balancing mit vorhandenen Nutzern und Passwörtern einrichten
  • Nutzer ohne Passwortänderungen migrieren
  • Benutzerdefinierte Lösungen für die Verwaltung von Passwortrichtlinien implementieren

Flags für die Ansicht pg_shadow und die Tabelle pg_authid festlegen

Wenn Sie auf die Ansicht pg_shadow zugreifen möchten, legen Sie das Flag cloudsql.pg_shadow_select_role auf einen PostgreSQL-Rollennamen fest. Wenn Sie auf die Tabelle pg_authid zugreifen möchten, setzen Sie das Flag cloudsql.pg_authid_select_role auf einen PostgreSQL-Rollennamen.

Wenn cloudsql.pg_shadow_select_role vorhanden ist, dann hat es schreibgeschützt (SELECT )-Zugriff auf die pg_shadow-Ansicht: Wenn cloudsql.pg_authid_select_role vorhanden ist, hat es SELECT-Zugriff auf die Tabelle pg_authid.

Wenn eine der Rollen nicht vorhanden ist, haben die Einstellungen keine Auswirkungen, aber es tritt auch kein Fehler auf. Es wird jedoch ein Fehler protokolliert, wenn ein Nutzer versucht, auf die Ansicht oder die Tabelle zuzugreifen. Der Fehler wird im PostgreSQL-Datenbanklog protokolliert: cloudsql.googleapis.com/postgres.log. Informationen zum Aufrufen dieses Logs finden Sie unter Instanzlogs ansehen.

Prüfen Sie, ob die konfigurierten Rollen vorhanden sind und ob der Wert des Flags cloudsql.pg_shadow_select_role oder des Flags cloudsql.pg_authid_select_role einen Tippfehler enthält. Sie können auch die Funktion pg_has_role verwenden, um zu prüfen, ob ein Nutzer Mitglied dieser Rollen ist. Informationen zu dieser Funktion finden Sie auf der Seite Funktionen und Operatoren für Systeminformationen.

Sie können das Flag cloudsql.pg_shadow_select_role oder cloudsql.pg_authid_select_role mit der PostgreSQL-Rollenmitgliedschaft verwenden, um den Zugriff von pg_shadow oder pg_authid für mehrere Nutzer zu verwalten.

Änderungen an beiden Flags erfordern keinen Neustart der Datenbank.

Weitere Informationen zu unterstützten Flags finden Sie unter Datenbank-Flags konfigurieren.

Format für die Passwortspeicherung auswählen

Cloud SQL for PostgreSQL speichert Nutzerpasswörter in einem gehashten Format. Mit dem Flag password_encryption können Sie den Verschlüsselungsalgorithmus auf md5 oder scram-sha-256 festlegen. Der md5-Algorithmus bietet die größtmögliche Kompatibilität. scram-sha-256 ist zwar sicherer, dafür aber möglicherweise nicht mit älteren Clients kompatibel.

Wenn Sie den pg_shadow-Zugriff aktivieren, um Rollenattribute aus einer Cloud SQL-Instanz zu exportieren, sollten Sie den sichersten Algorithmus verwenden, der von Ihren Clients unterstützt wird.

Weitere Informationen finden Sie in der PostgreSQL-Dokumentation:

Nächste Schritte