Auf dieser Seite wird beschrieben, wie sich Nutzer und Dienstkonten mithilfe der Cloud SQL-IAM-Datenbankauthentifizierung in Cloud SQL-Datenbanken anmelden können. Weitere Informationen finden Sie unter IAM-Authentifizierung.
Hinweise
- Konfigurieren Sie die Instanz, um die IAM-Datenbankauthentifizierung zu verwenden. Weitere Informationen finden Sie unter Neue Instanzen für die IAM-Datenbankauthentifizierung konfigurieren.
- Fügen Sie der Datenbank einen IAM-Nutzer, ein Dienstkonto oder eine Gruppe hinzu. Weitere Informationen finden Sie unter IAM-Nutzer oder Dienstkonto zur Datenbank hinzufügen und Gruppe zur Datenbank hinzufügen.
- Fügen Sie Ihrem IAM-Nutzer, Ihrem Dienstkonto oder Ihrer Gruppe die IAM-Rolle
roles/cloudsql.instanceUser
hinzu. Dies ist eine vordefinierte Rolle, die die erforderliche Cloud SQL-IAM-Berechtigungcloudsql.instances.login
enthält. Sie benötigen diese Berechtigung, um sich mit der IAM-Datenbankauthentifizierung bei einer Datenbankinstanz anzumelden. Weitere Informationen finden Sie unter Rollen und -Berechtigungen. Wenn ein IAM-Nutzer einer Datenbank hinzugefügt wird, erhält dieser neue Nutzer standardmäßig keine Berechtigungen für Datenbanken. Sie müssen den Befehl
GRANT
verwenden, um dem IAM-Datenbanknutzer alle erforderlichen Berechtigungen zu erteilen. Weitere Informationen finden Sie unter IAM-Nutzer Datenbankberechtigungen erteilen und Gruppen Datenbankberechtigungen erteilen.Wenn Sie die IAM-Gruppenauthentifizierung verwenden, muss das IAM-Nutzerkonto oder -Dienstkonto Mitglied einer Gruppe sein, der eine IAM-Rolle oder Berechtigungen zum Anmelden in der Cloud SQL-Instanz gewährt wurden. Cloud SQL erstellt ein Konto, nachdem sich der Nutzer oder das Dienstkonto zum ersten Mal in der Instanz angemeldet hat.
Mit automatischer IAM-Datenbankauthentifizierung anmelden
Sie können einen Cloud SQL-Connector so konfigurieren, dass die Authentifizierung bei der Cloud SQL-Instanz automatisch im Namen eines Nutzers oder einer Anwendung ausgeführt wird. Connectors umfassen den Cloud SQL-Auth-proxy, den Go-Connector, den Java-Connector und den Python-Connector, die alle die automatische IAM-Datenbankauthentifizierung unterstützen. Wenn Sie einen Cloud SQL-Connector mit der automatischen IAM-Datenbankauthentifizierung verwenden, muss das IAM-Konto, mit dem Sie den Connector starten, mit dem Konto übereinstimmen, mit dem Sie sich bei der Datenbank authentifizieren.
So melden Sie sich mit der automatischen IAM-Datenbankauthentifizierung an:
Cloud SQL Auth-Proxy
Authentifizieren Sie sich bei Google Cloud.
Nutzer
Authentifizieren Sie sich mit Standardanmeldedaten für Anwendungen bei Google Cloud.
Führen Sie den Befehl
gcloud auth application-default login
aus. Weitere Informationen finden Sie unter Standardanmeldedaten für Anwendungen einrichten.Dienstkonto
Wenn Sie sich mit Standardanmeldedaten für Anwendungen und einem Dienstkonto bei Google Cloud authentifizieren möchten, können Sie die Identitätsübernahme des Dienstkontos oder einen Dienstkontoschlüssel verwenden. Wenn Sie die Identitätsübernahme des Dienstkontos verwenden möchten, ersetzen Sie SERVICE_ACCOUNT_EMAIL_ADDRESS und führen Sie den folgenden Befehl aus:
gcloud auth application-default login --impersonate-service-account SERVICE_ACCOUNT_EMAIL_ADDRESS
Weitere Informationen finden Sie unter Standardanmeldedaten für Anwendungen einrichten.
Starten Sie den Cloud SQL Auth-Proxy mit dem Flag
--auto-iam-authn
.Ersetzen Sie Folgendes:
- INSTANCE_CONNECTION_NAME ist der Verbindungsstring zur Identifizierung einer Cloud SQL-Instanz. Wenn Sie einen anderen Port als den Standard-PostgreSQL-Port verwenden, geben Sie die Portnummer an. Informationen dazu, wie Sie diesen String ermitteln und erstellen, finden Sie unter Optionen für die Authentifizierung des Cloud SQL Auth-Proxys.
./cloud-sql-proxy --auto-iam-authn INSTANCE_CONNECTION_NAME
Weitere Informationen zum Starten des Proxys finden Sie unter Cloud SQL Auth-Proxy starten.
Wenn Sie bereit sind, über den Cloud SQL Auth-Proxy eine Verbindung zur Instanz herzustellen, melden Sie sich mit dem
psql
-Client an.Ersetzen Sie Folgendes:
- HOSTNAME: IP-Adresse, die vom Cloud SQL Auth-Proxy verwendet wird. Standardmäßig verwendet der Cloud SQL Auth-Proxy die localhost-Adresse
127.0.0.1
. Sie können beim Starten des Cloud SQL Auth-Proxys jedoch eine andere IP-Adresse zuweisen. - USERNAME: Bei einem IAM ist der Nutzername die vollständige E-Mail-Adresse des Nutzers. Bei einem Dienstkonto ist dies die E-Mail-Adresse des Dienstkontos ohne das Domain-Suffix
.gserviceaccount.com
. - PORT_NUMBER: Optional. Wenn Sie im Instanzverbindungsstring einen anderen Port angegeben haben, geben Sie diese Portnummer an.
- DATABASE_NAME: Der Name der Datenbank, zu der eine Verbindung hergestellt werden soll.
Führen Sie dazu diesen Befehl aus:
psql -h HOSTNAME \ -U USERNAME \ --port PORT_NUMBER \ --dbname=DATABASE_NAME
Weitere Informationen zum Herstellen einer Verbindung zum Cloud SQL-Authentifizierungsproxy finden Sie unter Verbindung mit dem psql-Client herstellen.
- HOSTNAME: IP-Adresse, die vom Cloud SQL Auth-Proxy verwendet wird. Standardmäßig verwendet der Cloud SQL Auth-Proxy die localhost-Adresse
Go
Java-JDBC
Java R2DBC
Python
Mit manueller IAM-Datenbankauthentifizierung anmelden
Ein Nutzer oder eine Anwendung kann sich mithilfe von IAM bei der Datenbank authentifizieren und dafür manuell ein Zugriffstoken von Google Cloud anfordern und es an die Datenbank übergeben. Mit der gcloud CLI haben Sie die Möglichkeit, explizit ein OAuth 2.0-Token im Geltungsbereich der Cloud SQL Admin API anzufordern, das für die Anmeldung bei der Datenbank verwendet wird. Wenn Sie sich als Datenbanknutzer mit der manuellen IAM-Datenbankauthentifizierung anmelden, verwenden Sie Ihre E-Mail-Adresse als Nutzernamen und das Zugriffstoken als Passwort. Sie können diese Methode entweder mit einer direkten Verbindung zur Datenbank oder mit einem Cloud SQL-Connector verwenden.
In diesem Verfahren authentifizieren Sie sich bei Google Cloud, fordern ein Zugriffstoken an und stellen dann eine Verbindung zur Datenbank her. Dazu übergeben Sie das Token als Passwort für den IAM-Datenbanknutzer. Führen Sie die folgenden Schritte aus, um eine Verbindung ohne den Cloud SQL-Authentifizierungsproxy herzustellen.
Für diese Schritte müssen Sie Folgendes tun:
gcloud sql generate-login-token
, um ein Authentifizierungstoken zu generieren.So melden Sie sich mit der manuellen IAM-Datenbankauthentifizierung an:
gcloud
Authentifizieren Sie sich bei Google Cloud.
Nutzer
Authentifizieren Sie sich mit
gcloud auth login
bei IAM. Weitere Informationen finden Sie unter Mit Nutzerkonten autorisieren.Dienstkonto
Authentifizieren Sie sich mit
gcloud auth activate-service-account
bei IAM. Weitere Informationen finden Sie unter Mit Dienstkonto autorisieren.Fordern Sie das Zugriffstoken an und melden Sie sich bei einem Client an.
Ersetzen Sie Folgendes:
- HOSTNAME: Die IP-Adresse der Instanz, entweder die öffentliche oder die private IP-Adresse.
- USERNAME: Bei einem IAM ist der Nutzername die vollständige E-Mail-Adresse des Nutzers. Bei einem Dienstkonto ist dies die E-Mail-Adresse des Dienstkontos ohne das Domain-Suffix
.gserviceaccount.com
. - DATABASE_NAME: Der Name der Datenbank, zu der eine Verbindung hergestellt werden soll.
PGPASSWORD=`gcloud sql generate-login-token` \ psql "sslmode=require \ hostaddr=HOSTNAME \ user=USERNAME \ dbname=DATABASE_NAME" \ --no-password
Wenn
ssl_mode
auf Ihrer Cloud SQL-Instanz alsTRUSTED_CLIENT_CERTIFICATE_REQUIRED
konfiguriert ist, empfehlen wir, dass Sie sich mit der automatischen IAM-Datenbankauthentifizierung anmelden, um die Validierung der Clientidentität zu erzwingen.
Nächste Schritte
- IAM-Datenbankauthentifizierung
- Anmeldedaten in Audit-Logs aktivieren und ansehen
- Nutzer und Dienstkonten erstellen, die die Cloud SQL-IAM-Datenbankauthentifizierung verwenden
- Nutzer und Dienstkonten für die IAM-Datenbankauthentifizierung verwalten