Diese Seite wurde von der Cloud Translation API übersetzt.

SSL/TLS-Zertifikate konfigurieren

MySQL | PostgreSQL | SQL Server

Auf dieser Seite wird beschrieben, wie Sie die SSL/TLS-Verschlüsselung für eine Instanz erzwingen, damit alle Verbindungen verschlüsselt sind. Sie können auch mehr dazu erfahren, wie Cloud SQL selbstverwaltete SSL/TLS-Zertifikate verwendet, um eine sichere Verbindung zu Cloud SQL-Instanzen herzustellen

Übersicht

Cloud SQL generiert automatisch ein Serverzertifikat, wenn Sie eine Instanz erstellen. Wir empfehlen, alle Verbindungen zur Verwendung von SSL/TLS zu zwingen.

Erstellen Sie ein Clientzertifikat laden Sie die Zertifikate auf Ihren PostgreSQL-Clienthostcomputer herunter, um die Client-/Serveridentität mithilfe von SSL/TLS-Zertifikaten zu validieren.

Wenn Sie für eine Instanz SSL erzwingen, ist für die Instanz kein Neustart erforderlich. Änderungen an SSL/TLS-Zertifikaten können jedoch zu einem automatischen Neustart der Instanz führen und Ausfallzeiten verursachen.

Eine Änderung der SSL-Modus-Konfiguration gilt nur für neue Verbindungen. Wenn Sie SSL erzwingen und Ihre Instanz vorhandene unverschlüsselte Verbindungen hat, bleiben die Verbindungen verbunden und unverschlüsselt. Sie müssen Ihre Instanz neu starten, um unverschlüsselte Verbindungen zu schließen und SSL auf allen Verbindungen zu erzwingen.

SSL/TLS-Verschlüsselung erzwingen

Sie können die Einstellung SSL-Modus verwenden, um die SSL-Verschlüsselung zu erzwingen:

Sowohl Nicht-SSL als auch Nicht-TLS zulassen und SSL/TLS-Verbindungen herstellen. Das Clientzertifikat wird für SSL/TLS-Verbindungen nicht geprüft. Das ist die Standardeinstellung.
Erlaubt nur Verbindungen, die mit SSL/TLS verschlüsselt wurden. Das Clientzertifikat wird für SSL-Verbindungen nicht geprüft.

Erlaubt nur Verbindungen, die mit SSL/TLS und mit gültigen Client-Zertifikaten verschlüsselt wurden.

Wenn Sie für Ihre Cloud SQL-Instanz Nicht-SSL/Nicht-TLS- und SSL/TLS-Verbindungen zulassen auswählen, werden SSL-/TLS-Verbindungen sowie unverschlüsselte und unsichere Verbindungen akzeptiert. Wenn Sie nicht für alle Verbindungen SSL/TLS benötigen, sind unverschlüsselte Verbindungen weiterhin zulässig. Es wird daher dringend empfohlen, SSL für alle Verbindungen zu erzwingen, wenn über öffentliche IP-Adressen auf Ihre Instanz zugegriffen wird.

Sie können SSL/TLS-Zertifikate verwenden, um eine direkte Verbindung zu Instanzen herzustellen, oder Sie können über den Cloud SQL Auth Proxy oder Cloud SQL-Connectors eine Verbindung herstellen. Wenn Sie eine Verbindung über Cloud SQL Auth Proxy oder Cloud SQL Connectors herstellen, werden die Verbindungen automatisch mit SSL/TLS verschlüsselt. Mit Cloud SQL Auth Proxy und Cloud SQL Connectors werden Client- und Server-Identitäten auch unabhängig von der Einstellung des SSL-Modus automatisch überprüft.

So aktivieren Sie die Erfordernis von SSL/TLS:

Console

Google Cloud Rufen Sie in der Console die Seite Cloud SQL-Instanzen auf.

Cloud SQL-Instanzen aufrufen
Klicken Sie auf den Instanznamen, um die Seite Übersicht einer Instanz zu öffnen.
Klicken Sie im SQL-Navigationsmenü auf Verbindungen.
Wählen Sie den Tab Sicherheit aus.
Folgende Optionen sind verfügbar:
- Unverschlüsselten Netzwerktraffic zulassen (nicht empfohlen)
- Nur SSL-Verbindungen zulassen. Diese Option lässt nur Verbindungen mit SSL/TLS-Verschlüsselung zu. Zertifikate werden nicht validiert.
- Vertrauenswürdige Clientzertifikate erforderlich. Diese Option lässt nur Verbindungen von Clients zu, die ein gültiges Clientzertifikat verwenden und SSL-verschlüsselt sind. Wenn ein Client oder Nutzer über die IAM-Datenbankauthentifizierung eine Verbindung herstellt, müssen sie entweder den Cloud SQL Auth Proxy oder die Cloud SQL-Connectors verwenden, um die Überprüfung der Kundenidentität zu erzwingen.

gcloud

   gcloud sql instances patch INSTANCE_NAME \
   --ssl-mode=SSL_ENFORCEMENT_MODE

Ersetzen Sie SSL_ENFORCEMENT_MODE durch eine der folgenden Optionen:

ALLOW_UNENCRYPTED_AND_ENCRYPTED: Lässt Nicht-SSL-/Nicht-TLS- und SSL/TLS-Verbindungen zu. Bei SSL-Verbindungen wird das Clientzertifikat nicht geprüft. Dies ist der Standardwert.
ENCRYPTED_ONLY: Erlaubt nur Verbindungen, die mit SSL/TLS verschlüsselt wurden. Das Clientzertifikat wird für SSL-Verbindungen nicht geprüft.
TRUSTED_CLIENT_CERTIFICATE_REQUIRED: Erlaubt nur Verbindungen, die mit SSL/TLS und mit gültigen Client-Zertifikaten verschlüsselt wurden. Wenn ein Client oder Nutzer über die IAM-Datenbankauthentifizierung eine Verbindung herstellt, müssen sie entweder den Cloud SQL Auth Proxy oder die Cloud SQL-Connectors verwenden, um die Überprüfung der Kundenidentität zu erzwingen.

Einstellungen: Cloud SQL for PostgreSQL

Terraform

Verwenden Sie zum Erzwingen der SSL/TLS-Verschlüsselung eine Terraform-Ressource:

resource "google_sql_database_instance" "postgres_instance" {
  name             = "postgres-instance"
  region           = "asia-northeast1"
  database_version = "POSTGRES_14"
  settings {
    tier = "db-custom-2-7680"
    ip_configuration {
      # The following SSL enforcement options only allow connections encrypted with SSL/TLS and with
      # valid client certificates. Please check the API reference for other SSL enforcement options:
      # https://cloud.google.com/sql/docs/postgres/admin-api/rest/v1beta4/instances#ipconfiguration
      ssl_mode = "TRUSTED_CLIENT_CERTIFICATE_REQUIRED"
    }
  }
  # set `deletion_protection` to true, will ensure that one cannot accidentally delete this instance by
  # use of Terraform whereas `deletion_protection_enabled` flag protects this instance at the GCP level.
  deletion_protection = false
}

Änderungen anwenden

Führen Sie die Schritte in den folgenden Abschnitten aus, um Ihre Terraform-Konfiguration auf ein Google Cloud -Projekt anzuwenden.

Cloud Shell vorbereiten

Rufen Sie Cloud Shell auf.
Legen Sie das Google Cloud Standardprojekt fest, auf das Sie Ihre Terraform-Konfigurationen anwenden möchten.

Sie müssen diesen Befehl nur einmal pro Projekt und in jedem beliebigen Verzeichnis ausführen.
```
export GOOGLE_CLOUD_PROJECT=PROJECT_ID
```
Umgebungsvariablen werden überschrieben, wenn Sie in der Terraform-Konfigurationsdatei explizite Werte festlegen.

Verzeichnis vorbereiten

Jede Terraform-Konfigurationsdatei muss ein eigenes Verzeichnis haben (auch als Stammmodul bezeichnet).

Erstellen Sie in Cloud Shell ein Verzeichnis und eine neue Datei in diesem Verzeichnis. Der Dateiname muss die Erweiterung .tf haben, z. B. main.tf. In dieser Anleitung wird die Datei als main.tf bezeichnet.
```
mkdir DIRECTORY && cd DIRECTORY && touch main.tf
```
Wenn Sie einer Anleitung folgen, können Sie den Beispielcode in jedem Abschnitt oder Schritt kopieren.

Kopieren Sie den Beispielcode in das neu erstellte main.tf.

Kopieren Sie optional den Code aus GitHub. Dies wird empfohlen, wenn das Terraform-Snippet Teil einer End-to-End-Lösung ist.
Prüfen und ändern Sie die Beispielparameter, die auf Ihre Umgebung angewendet werden sollen.
Speichern Sie die Änderungen.
Initialisieren Sie Terraform. Dies ist nur einmal für jedes Verzeichnis erforderlich.
```
terraform init
```
Fügen Sie optional die Option -upgrade ein, um die neueste Google-Anbieterversion zu verwenden:
```
terraform init -upgrade
```

Änderungen anwenden

Prüfen Sie die Konfiguration und prüfen Sie, ob die Ressourcen, die Terraform erstellen oder aktualisieren wird, Ihren Erwartungen entsprechen:
```
terraform plan
```
Korrigieren Sie die Konfiguration nach Bedarf.
Wenden Sie die Terraform-Konfiguration an. Führen Sie dazu den folgenden Befehl aus und geben Sie yes an der Eingabeaufforderung ein:
```
terraform apply
```
Warten Sie, bis Terraform die Meldung „Apply complete“ anzeigt.
Öffnen Sie Ihr Google Cloud Projekt, um die Ergebnisse aufzurufen. Rufen Sie in der Google Cloud Console Ihre Ressourcen in der Benutzeroberfläche auf, um sicherzustellen, dass Terraform sie erstellt oder aktualisiert hat.

Änderungen löschen

So löschen Sie das Projekt:

Um den Löschschutz zu deaktivieren, setzen Sie in der Terraform-Konfigurationsdatei das Argument deletion_protection auf false.
```
deletion_protection =  "false"
```
Wenden Sie die aktualisierte Terraform-Konfiguration an. Führen Sie dazu den folgenden Befehl aus und geben Sie yes an der Eingabeaufforderung ein:
```
terraform apply
```

Entfernen Sie Ressourcen, die zuvor mit Ihrer Terraform-Konfiguration angewendet wurden, indem Sie den folgenden Befehl ausführen und yes an der Eingabeaufforderung eingeben:
```
terraform destroy
```

REST Version 1

Ersetzen Sie diese Werte in den folgenden Anfragedaten:
- PROJECT_ID: die Projekt-ID
- SSL_ENFORCEMENT_MODE: Verwenden Sie eine der folgenden Optionen:
  - ALLOW_UNENCRYPTED_AND_ENCRYPTED: Lässt Nicht-SSL-/Nicht-TLS- und SSL/TLS-Verbindungen zu. Bei SSL-Verbindungen wird das Clientzertifikat nicht geprüft. Dies ist der Standardwert.
  - ENCRYPTED_ONLY: Erlaubt nur Verbindungen, die mit SSL/TLS verschlüsselt wurden.
  - TRUSTED_CLIENT_CERTIFICATE_REQUIRED: Erlaubt nur Verbindungen, die mit SSL/TLS und mit gültigen Client-Zertifikaten verschlüsselt wurden. Wenn ein Client oder Nutzer über die IAM-Datenbankauthentifizierung eine Verbindung herstellt, müssen sie entweder den Cloud SQL Auth Proxy oder die Cloud SQL-Connectors verwenden, um die Überprüfung der Kundenidentität zu erzwingen.
- INSTANCE_ID: die Instanz-ID
HTTP-Methode und URL:
```
PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID
```
JSON-Text anfordern:
```
{
  "settings": {
    "ipConfiguration": {"sslMode": "SSL_ENFORCEMENT_MODE"}
  }
}
```
Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:
curl (Linux, macOS oder Cloud Shell)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud-Befehlszeile angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch bei der gcloud-Befehlszeile anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:
```
curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID"
```
PowerShell (Windows)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud-Befehlszeile angemeldet haben. Dazu führen Sie gcloud init oder gcloud auth login aus. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:
```
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID" | Select-Object -Expand Content
```
Sie sollten in etwa folgende JSON-Antwort erhalten:
Antwort
```
{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-20T21:30:35.667Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}
```

REST v1beta4

Ersetzen Sie diese Werte in den folgenden Anfragedaten:
- PROJECT_ID: die Projekt-ID
- SSL_ENFORCEMENT_MODE: Verwenden Sie eine der folgenden Optionen:
  - ALLOW_UNENCRYPTED_AND_ENCRYPTED: Lässt Nicht-SSL-/Nicht-TLS- und SSL/TLS-Verbindungen zu. Bei SSL-Verbindungen wird das Clientzertifikat nicht geprüft. Dies ist der Standardwert.
  - ENCRYPTED_ONLY: Erlaubt nur Verbindungen, die mit SSL/TLS verschlüsselt wurden.
  - TRUSTED_CLIENT_CERTIFICATE_REQUIRED: Erlaubt nur Verbindungen, die mit SSL/TLS und mit gültigen Client-Zertifikaten verschlüsselt wurden. Wenn ein Client oder Nutzer über die IAM-Datenbankauthentifizierung eine Verbindung herstellt, müssen sie entweder den Cloud SQL Auth Proxy oder die Cloud SQL-Connectors verwenden, um die Überprüfung der Kundenidentität zu erzwingen.
- INSTANCE_ID: die Instanz-ID
HTTP-Methode und URL:
```
PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID
```
JSON-Text anfordern:
```
{
  "settings": {
    "ipConfiguration": {"sslMode": "SSL_ENFORCEMENT_MODE"}
  }
}
```
Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:
curl (Linux, macOS oder Cloud Shell)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud-Befehlszeile angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch bei der gcloud-Befehlszeile anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:
```
curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID"
```
PowerShell (Windows)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud-Befehlszeile angemeldet haben. Dazu führen Sie gcloud init oder gcloud auth login aus. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:
```
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID" | Select-Object -Expand Content
```
Sie sollten in etwa folgende JSON-Antwort erhalten:
Antwort
```
{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-20T21:30:35.667Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}
```

Serverzertifikate

Cloud SQL generiert automatisch ein Serverzertifikat, wenn Sie eine Instanz erstellen. Solange das Serverzertifikat gültig ist, müssen Sie keine Schritte zum Verwalten Ihres Serverzertifikats ausführen. In Cloud SQL können Sie zwischen drei verschiedenen Zertifizierungsstellenhierarchien wählen. Die von Ihnen ausgewählte CA-Hierarchie wird zum Server-CA-Modus der Instanz. Wenn Sie die Zertifizierungsstelle pro Instanz als Server-CA-Modus für Ihre Instanz verwenden, haben die Serverzertifikate ein Ablaufdatum von 10 Jahren. Wenn Sie eine freigegebene Zertifizierungsstelle oder eine vom Kunden verwaltete Zertifizierungsstelle als Server-CA-Modus Ihrer Instanz verwenden, hat das Serverzertifikat ein Ablaufdatum von einem Jahr^*. Nach dem Ablaufdatum ist das Serverzertifikat ungültig und Clients können mit diesem Zertifikat keine sichere Verbindung mehr zu Ihrer Instanz herstellen. Wenn ein Client so konfiguriert ist, dass die Zertifizierungsstelle oder der Hostname im Serverzertifikat überprüft wird, schlägt die Verbindung dieses Clients zu Cloud SQL-Instanzen mit abgelaufenen Serverzertifikaten fehl. Um Unterbrechungen bei Clientverbindungen zu vermeiden, sollten Sie das Serverzertifikat vor Ablauf rotieren. Sie werden benachrichtigt, wenn das Serverzertifikat bald abläuft. Die Benachrichtigungen werden an den folgenden Tagen vor dem Ablaufdatum gesendet: 90, 30, 10, 2 und 1.

^* Bei einer vom Kunden verwalteten Zertifizierungsstelle kann das Ablaufdatum Ihres Serverzertifikats kürzer als ein Jahr sein, wenn Sie ein kürzeres Ablaufdatum für die Gültigkeitsdauer Ihrer Zertifizierungsstelle ausgewählt haben.

Serverzertifikate auflisten und erstellen

Wenn Sie sich die Details Ihrer Serverzertifikate in der Google Cloud Console ansehen möchten, rufen Sie die Seite Verbindungen auf und klicken Sie auf den Tab Sicherheit.

In der Tabelle mit den Zertifikaten sehen Sie die folgenden Details:

Zertifikatstatus: „Anstehend“, „Aktiv“ oder „Vorherig“

Demnächst: Das Zertifikat kann verwendet werden, ist aber nicht aktiv. Verwenden Sie die Rotationsprozedur, um das Zertifikat zu aktivieren.
Aktiv: Das Zertifikat wird verwendet.
Vorher: Das Zertifikat wird nicht mehr verwendet. Verwenden Sie das Rollback-Verfahren, um das Zertifikat zu aktivieren.

Created (Erstellt): Datum und Uhrzeit der Erstellung des Zertifikats
Abläuft: Datum und Uhrzeit, an dem das Zertifikat abläuft

Bevor das aktive Zertifikat abläuft, können Sie manuell ein neues Zertifikat erstellen.

Console

Für Instanzen, die selbst signierte Serverzertifikate verwenden (CA pro Instanz):

Google Cloud Rufen Sie in der Console die Seite Cloud SQL-Instanzen auf.

Cloud SQL-Instanzen aufrufen
Klicken Sie auf den Instanznamen, um die Seite Übersicht einer Instanz zu öffnen.
Klicken Sie im SQL-Navigationsmenü auf Verbindungen.
Wählen Sie den Tab Sicherheit aus.
Gehen Sie zum Abschnitt Server-CA-Zertifikate verwalten.
Maximieren Sie Zertifikate verwalten.
Klicken Sie auf Neues CA-Zertifikat erstellen.

Das neue Server-CA-Zertifikat wird im Feld Voraussichtlich angezeigt. Wenn Sie sofort zum neuen Server-CA-Zertifikat wechseln möchten, fahren Sie mit der Rotation des Server-CA-Zertifikats fort, indem Sie Ihre Clients aktualisieren und die Rotation abschließen.

Für Instanzen, die Serverzertifikate verwenden, die von einer freigegebenen Zertifizierungsstelle ausgestellt wurden:

Google Cloud Rufen Sie in der Console die Seite Cloud SQL-Instanzen auf.

Cloud SQL-Instanzen aufrufen
Klicken Sie auf den Instanznamen, um die Seite Übersicht einer Instanz zu öffnen.
Klicken Sie im SQL-Navigationsmenü auf Verbindungen.
Wählen Sie den Tab Sicherheit aus.
Gehen Sie zum Abschnitt Serverzertifikate verwalten.
Maximieren Sie Zertifikate verwalten.
Klicken Sie auf Serverzertifikat erstellen.

Das neue Serverzertifikat wird im Feld Voraussichtlich angezeigt. Wenn Sie das neue Serverzertifikat sofort verwenden möchten, fahren Sie mit der Rotation des Serverzertifikats fort, indem Sie Ihre Clients aktualisieren und die Rotation abschließen.

gcloud

Für Instanzen, die selbst signierte Serverzertifikate verwenden (CA pro Instanz):

Verwenden Sie den Befehl sql ssl server-ca-certs list, um Informationen zum Serverzertifikat abzurufen:
```
gcloud sql ssl server-ca-certs list \
--instance=INSTANCE_NAME
```
Verwenden Sie den Befehl sql ssl server-ca-certs create, um ein Serverzertifikat zu erstellen:
```
gcloud sql ssl server-ca-certs create \
--instance=INSTANCE_NAME
```

Laden Sie die Zertifikatsinformationen in eine lokale PEM-Datei herunter:

gcloud sql ssl server-ca-certs list \
--format="value(cert)" \
--instance=INSTANCE_NAME > \
FILE_PATH/FILE_NAME.pem

Aktualisieren Sie alle Ihre Clients so, dass die neuen Informationen verwendet werden. Kopieren Sie hierzu die heruntergeladene Datei auf Ihre Client-Hostcomputer und ersetzen Sie die vorhandenen server-ca.pem-Dateien.

Für Instanzen, die Serverzertifikate verwenden, die von einer freigegebenen Zertifizierungsstelle ausgestellt wurden:

Informationen zum Serverzertifikat erhalten Sie mit dem Befehl sql ssl server-certs list:
```
gcloud sql ssl server-certs list \
   --instance=INSTANCE_NAME
```
Verwenden Sie den Befehl sql ssl server-certs create, um ein Serverzertifikat zu erstellen:
```
gcloud sql ssl server-certs create \
   --instance=INSTANCE_NAME
```

Laden Sie die Zertifikatsinformationen in eine lokale PEM-Datei herunter:

gcloud sql ssl server-certs list \
   --format="value(ca_cert.cert)" \
   --instance=INSTANCE_NAME > \
   FILE_PATH/FILE_NAME.pem

Aktualisieren Sie alle Ihre Clients so, dass die neuen Informationen verwendet werden. Kopieren Sie hierzu die heruntergeladene Datei auf Ihre Client-Hostcomputer und ersetzen Sie die vorhandenen server-ca.pem-Dateien.

Terraform

Verwenden Sie zum Bereitstellen von Informationen zum Serverzertifikat als Ausgabe eine Terraform-Datenquelle:

Fügen Sie Ihrer Terraform-Konfigurationsdatei Folgendes hinzu:

   data "google_sql_ca_certs" "ca_certs" {
     instance = google_sql_database_instance.default.name
   }

   locals {
     furthest_expiration_time = reverse(sort([for k, v in data.google_sql_ca_certs.ca_certs.certs : v.expiration_time]))[0]
     latest_ca_cert           = [for v in data.google_sql_ca_certs.ca_certs.certs : v.cert if v.expiration_time == local.furthest_expiration_time]
   }

   output "db_latest_ca_cert" {
     description = "Latest CA certificate used by the primary database server"
     value       = local.latest_ca_cert
     sensitive   = true
   }

Führen Sie den folgenden Befehl aus, um die Datei server-ca.pem zu erstellen:
```
   terraform output db_latest_ca_cert > server-ca.pem
   
```

Clientzertifikate

Neues Clientzertifikat erstellen

Sie können für jede Instanz bis zu zehn Clientzertifikate erstellen. Zum Erstellen von Clientzertifikaten benötigen Sie die IAM-Rolle Cloud SQL Admin.

Beachten Sie bei Clientzertifikaten Folgendes:

Wenn Sie den privaten Schlüssel für ein Zertifikat verlieren, müssen Sie einen neuen Schlüssel erstellen. Der private Schlüssel kann nicht wiederhergestellt werden.
Das Clientzertifikat hat standardmäßig ein Ablaufdatum von 10 Jahren.
Sie werden nicht benachrichtigt, wenn die Clientzertifikate bald ablaufen.
Die Cloud SQL-Instanz muss ausgeführt werden, um ein SSL-Zertifikat erstellen zu können.

Console

Google Cloud Rufen Sie in der Console die Seite Cloud SQL-Instanzen auf.

Cloud SQL-Instanzen aufrufen
Klicken Sie auf den Instanznamen, um die Seite Übersicht einer Instanz zu öffnen.
Klicken Sie im SQL-Navigationsmenü auf Verbindungen.
Wählen Sie den Tab Sicherheit aus.
Klicken Sie auf Clientzertifikat erstellen.
Geben Sie im Dialogfeld Clientzertifikat erstellen einen eindeutigen Namen ein.
Klicken Sie auf Erstellen.
Klicken Sie im ersten Abschnitt des Dialogfelds Neues SSL-Zertifikat erstellt auf client-key.pem herunterladen, um den privaten Schlüssel in eine Datei mit dem Namen client-key.pem herunterzuladen.
Wichtig: Bewahren Sie diesen privaten Schlüssel sicher auf. Wenn Sie den Schlüssel verlieren, müssen Sie ein neues Clientzertifikat erstellen.
Klicken Sie im zweiten Abschnitt auf client-cert.pem herunterladen, um das Clientzertifikat in eine Datei mit dem Namen client-cert.pem herunterzuladen.
Klicken Sie im dritten Abschnitt auf server-ca.pem herunterladen, um das Serverzertifikat in eine Datei mit dem Namen server-ca.pem herunterzuladen.
Klicken Sie auf Schließen.

gcloud

Erstellen Sie mit dem Befehl ssl client-certs create ein Clientzertifikat:
```
gcloud sql ssl client-certs create CERT_NAME client-key.pem \
--instance=INSTANCE_NAME
```
Wichtig: Bewahren Sie diesen privaten Schlüssel sicher auf. Wenn Sie den Schlüssel verlieren, müssen Sie ein neues Clientzertifikat erstellen.
Rufen Sie den öffentlichen Schlüssel für das gerade erstellte Zertifikat ab und kopieren Sie ihn mit dem Befehl ssl client-certs describe in die Datei client-cert.pem:
```
gcloud sql ssl client-certs describe CERT_NAME \
--instance=INSTANCE_NAME \
--format="value(cert)" > client-cert.pem
```

Kopieren Sie das Serverzertifikat mit dem Befehl instances describe in die Datei server-ca.pem:

gcloud sql instances describe INSTANCE_NAME \
--format="value(serverCaCert.cert)" > server-ca.pem

Terraform

Verwenden Sie zum Erstellen eines Clientzertifikats eine Terraform-Ressource:

resource "google_sql_ssl_cert" "postgres_client_cert" {
  common_name = "postgres_common_name"
  instance    = google_sql_database_instance.postgres_instance.name
}

REST Version 1

Erstellen Sie ein SSL/TLS-Zertifikat. Sein Name darf für diese Instanz nur einmal vorkommen:

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

project-id: die Projekt-ID
instance-id: die Instanz-ID
client-cert-name: der Name des Clientzertifikats

HTTP-Methode und URL:

POST https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/sslCerts

JSON-Text anfordern:

{
  "commonName" : "client-cert-name"
}

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

curl (Linux, macOS oder Cloud Shell)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud-Befehlszeile angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch bei der gcloud-Befehlszeile anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/sslCerts"

PowerShell (Windows)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud-Befehlszeile angemeldet haben. Dazu führen Sie gcloud init oder gcloud auth login aus. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/sslCerts" | Select-Object -Expand Content

Sie sollten in etwa folgende JSON-Antwort erhalten:

Antwort

{
  "kind": "sql#sslCertsInsert",
  "operation": {
    "kind": "sql#operation",
    "targetLink": "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id",
    "status": "PENDING",
    "user": "user@example.com",
    "operationType": "UPDATE",
    "name": "operation-id",
    "targetId": "instance-id",
    "selfLink": "https://sqladmin.googleapis.com/v1/projects/project-id/operations/operation-id",
    "targetProject": "doc-test-01",
    "insertTime": "2020-02-13T00:11:20.677Z"
  },
  "serverCaCert": {
    "kind": "sql#sslCert",
    "certSerialNumber": "server-cert-serial-number",
    "cert": "server-cert-value",
    "commonName": "server-cert-name,
    "sha1Fingerprint": "server-cert-sha1Fingerprint",
    "instance": "instance-id",
    "selfLink": "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/sslCerts/operation-id",
    "createTime": "2019-11-25T20:12:06.764Z",
    "expirationTime": "2029-11-22T20:13:06.764Z"
  },
  "clientCert": {
    "certInfo": {
      "kind": "sql#sslCert",
      "certSerialNumber": "client-cert-serial-number-2",
      "cert": "client-cert-value",
      "commonName": "client-cert-name",
      "sha1Fingerprint": "client-cert-sha1Fingerprint-2",
      "instance": "instance-id",
      "selfLink": "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/sslCerts/operation-id",
      "createTime": "2020-02-13T00:10:20.595Z",
      "expirationTime": "2030-02-10T00:11:20.595Z"
    },
    "certPrivateKey": "private-key-value"
  }
}

Gehen Sie so vor, um den gesamten Zertifikatsinhalt innerhalb der Anführungszeichen (jedoch ohne die Anführungszeichen selbst) aus der Antwort in lokale Dateien zu kopieren:
1. Kopieren Sie serverCaCert.cert in server-ca.pem.
2. Kopieren Sie clientCert.cert in client-cert.pem.
3. Kopieren Sie certPrivateKey in client-key.pem.
Wichtig: Bewahren Sie diesen privaten Schlüssel sicher auf. Wenn Sie den Schlüssel verlieren, müssen Sie ein neues Clientzertifikat erstellen.

REST v1beta4

Erstellen Sie ein SSL/TLS-Zertifikat. Sein Name darf für diese Instanz nur einmal vorkommen:

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

project-id: die Projekt-ID
instance-id: die Instanz-ID
client-cert-name: der Name des Clientzertifikats

HTTP-Methode und URL:

POST https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/sslCerts

JSON-Text anfordern:

{
  "commonName" : "client-cert-name"
}

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

curl (Linux, macOS oder Cloud Shell)

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/sslCerts"

PowerShell (Windows)

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/sslCerts" | Select-Object -Expand Content

Sie sollten in etwa folgende JSON-Antwort erhalten:

Antwort

{
  "kind": "sql#sslCertsInsert",
  "operation": {
    "kind": "sql#operation",
    "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id",
    "status": "PENDING",
    "user": "user@example.com",
    "operationType": "UPDATE",
    "name": "operation-id",
    "targetId": "instance-id",
    "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/operations/operation-id",
    "targetProject": "doc-test-01",
    "insertTime": "2020-02-13T00:11:20.677Z"
  },
  "serverCaCert": {
    "kind": "sql#sslCert",
    "certSerialNumber": "server-cert-serial-number",
    "cert": "server-cert-value",
    "commonName": "server-cert-name,
    "sha1Fingerprint": "server-cert-sha1Fingerprint",
    "instance": "instance-id",
    "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/sslCerts/operation-id",
    "createTime": "2019-11-25T20:12:06.764Z",
    "expirationTime": "2029-11-22T20:13:06.764Z"
  },
  "clientCert": {
    "certInfo": {
      "kind": "sql#sslCert",
      "certSerialNumber": "client-cert-serial-number-2",
      "cert": "client-cert-value",
      "commonName": "client-cert-name",
      "sha1Fingerprint": "client-cert-sha1Fingerprint-2",
      "instance": "instance-id",
      "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/sslCerts/operation-id",
      "createTime": "2020-02-13T00:10:20.595Z",
      "expirationTime": "2030-02-10T00:11:20.595Z"
    },
    "certPrivateKey": "private-key-value"
  }
}

Gehen Sie so vor, um den gesamten Zertifikatsinhalt innerhalb der Anführungszeichen (jedoch ohne die Anführungszeichen selbst) aus der Antwort in lokale Dateien zu kopieren:
1. Kopieren Sie serverCaCert.cert in server-ca.pem.
2. Kopieren Sie clientCert.cert in client-cert.pem.
3. Kopieren Sie certPrivateKey in client-key.pem.
Wichtig: Bewahren Sie diesen privaten Schlüssel sicher auf. Wenn Sie den Schlüssel verlieren, müssen Sie ein neues Clientzertifikat erstellen.

Sie verfügen nun über die folgenden Elemente:

Ein Serverzertifikat, das als server-ca.pem gespeichert ist.
Ein Public-Key-Zertifikat des Clients, das als client-cert.pem gespeichert ist.
Einen privaten Schlüssel für den Client, der als client-key.pem gespeichert ist.

Je nachdem, welches Tool beim Verbindungsaufbau verwendet wird, werden diese drei Elemente auf unterschiedliche Weise angegeben. Wenn Sie zum Beispiel für den Verbindungsaufbau den psql-Befehlszeilenclient nutzen, sind diese drei Dateien die Werte für die Parameter sslrootcert, sslcert und sslkey im psql-Verbindungsstring. Ein Beispiel für den Verbindungsaufbau mit dem psql-Client und SSL/TLS finden Sie unter Mit dem psql-Client verbinden.

Überprüfung der Serveridentität

Die Überprüfung der Serveridentität hängt von der Konfiguration der Zertifizierungsstellenhierarchie des Servers Ihrer Cloud SQL-Instanz ab.

Bei Instanzen, die eine pro Instanz verwendete Zertifizierungsstelle verwenden, wird durch die Überprüfung der Zertifizierungsstelle auch die Serveridentität überprüft, da jede Instanz eine eindeutige Zertifizierungsstelle hat. Bei Instanzen, die eine gemeinsame Zertifizierungsstelle verwenden, ist für die Überprüfung der Serveridentität die Überprüfung des Hostnamens und der Zertifizierungsstelle erforderlich, da Server-Zertifizierungsstellen für alle Instanzen gemeinsam genutzt werden.

Wenn Sie eine CA pro Instanz haben, können Sie die DNS-namenbasierte Serveridentitätsbestätigung nur für Instanzen durchführen, die mit Private Service Connect konfiguriert sind. Wenn Sie eine gemeinsame Zertifizierungsstelle haben, können Sie die DNS-Namenbasierte Serveridentitätsbestätigung für alle Arten von Instanzen ausführen, nämlich Private Service Connect, privater Dienstzugriff und Instanzen mit öffentlicher IP-Adresse.

Wenn Sie eine vom Kunden verwaltete Zertifizierungsstelle verwenden, können Sie die Zertifizierungsstellen-Vertrauenskette überprüfen und die DNS-Namen-basierte Serveridentität für jede Art von Instanz überprüfen, die für ihre serverCAmode eine vom Kunden verwaltete Zertifizierungsstelle verwendet.

Wenn Sie die Option „Kundenverwaltete Zertifizierungsstelle“ für Ihre Instanz auswählen, können Sie benutzerdefinierte DNS-Namen in das SAN-Feld des Serverzertifikats einfügen. Weitere Informationen finden Sie unter Benutzerdefiniertes SAN-Feld bearbeiten.

Welche CA-Hierarchie für eine Cloud SQL-Instanz konfiguriert ist, sehen Sie in den Instanzdetails. Weitere Informationen finden Sie unter Instanzinformationen aufrufen.

Bestätigung der Serveridentität aktivieren

Wenn Sie „Gemeinsam genutzte Zertifizierungsstelle“ als Server-CA-Modus Ihrer Cloud SQL-Instanz auswählen oder benutzerdefinierte DNS-Namen mit benutzerdefinierten SAN-Werten einrichten, sollten Sie auch die Serveridentitätsbestätigung aktivieren.

Instanzen, bei denen die gemeinsame Zertifizierungsstelle als Server-CA-Modus verwendet wird, enthalten den DNS-Namen der Instanz im Feld „Subject Alternative Name“ (SAN) des Serverzertifikats. Sie können diesen DNS-Namen mithilfe der Instanz-Lookup API abrufen und die Antwort als Hostnamen für die Überprüfung der Serveridentität verwenden. Sie müssen die DNS-Auflösung für den DNS-Namen einrichten.

So aktivieren Sie die Serveridentitätsbestätigung für eine Instanz, die eine freigegebene Zertifizierungsstelle verwendet:

Rufen Sie den DNS-Namen ab.

Verwenden Sie den Befehl gcloud sql instances describe, um zusammenfassende Informationen zu einer Cloud SQL-Instanz einschließlich des DNS-Namens der Instanz aufzurufen:
```
gcloud sql instances describe INSTANCE_NAME \
  --project=PROJECT_ID
```
Ersetzen Sie die folgenden Werte:
- INSTANCE_NAME: Der Name der Cloud SQL-Instanz.
- PROJECT_ID: die ID oder Projektnummer des Google Cloud Projekts, das die Instanz enthält

Suchen Sie in der Antwort nach dem Feld dnsNames:. Dieses Feld kann mehrere DNS-Namen im folgenden Format zurückgeben:

Netzwerkkonfiguration	Format des DNS-Namens	Namensebene
Private Service Connect oder öffentliche IP-Adresse	`INSTANCE_UID`.`PROJECT_DNS_LABEL`.`REGION_NAME`.sql.goog. Beispiel: `1a23b4cd5e67.1a2b345c6d27.us-central1.sql.goog.`	Instanz
Zugriff auf private Dienste	`INSTANCE_UID`.`PROJECT_DNS_LABEL`.`REGION_NAME`.sql-psa.goog. Beispiel: `1a23b4cd5e67.1a2b345c6d27.us-central1.sql-psa.goog.`	Instanz

Erstellen Sie den DNS-Eintrag in einer DNS-Zone. Wenn Sie eine private Verbindung herstellen, erstellen Sie den DNS-Eintrag in einer privaten DNS-Zone im entsprechenden VPC-Netzwerk (Virtual Private Cloud).
Konfigurieren Sie den DNS-Namen als Hostnamen, wenn Sie eine Verbindung zur Cloud SQL for PostgreSQL-Instanz herstellen. Aktivieren Sie dann die Bestätigung der Serveridentität in Ihrem Client.

Geben Sie beispielsweise beim Verwenden des psql-Clients das Flag sslmode=verify-full an. Andere PostgreSQL-Client-Treiber haben ähnliche Konfigurations-Flags.

Nächste Schritte

SSL/TLS auf Ihrer Cloud SQL-Instanz verwalten
Weitere Informationen zur Verschlüsselung in Google Cloud.
SSL/TLS-Zertifikate zur Verbindung mit Ihrer Cloud SQL-Instanz
SSL/TLS mit PostgreSQL verwenden

SSL/TLS-Zertifikate konfigurieren Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Übersicht

SSL/TLS-Verschlüsselung erzwingen

Console

gcloud

Terraform

Änderungen anwenden

Cloud Shell vorbereiten

Verzeichnis vorbereiten

Änderungen anwenden

Änderungen löschen

REST Version 1

curl (Linux, macOS oder Cloud Shell)

PowerShell (Windows)

Antwort

REST v1beta4

curl (Linux, macOS oder Cloud Shell)

PowerShell (Windows)

Antwort

Serverzertifikate

Serverzertifikate auflisten und erstellen

Console

gcloud

Terraform

Clientzertifikate

Neues Clientzertifikat erstellen

Console

gcloud

Terraform

REST Version 1

curl (Linux, macOS oder Cloud Shell)

PowerShell (Windows)

Antwort

REST v1beta4

curl (Linux, macOS oder Cloud Shell)

PowerShell (Windows)

Antwort

Überprüfung der Serveridentität

Bestätigung der Serveridentität aktivieren

Nächste Schritte

SSL/TLS-Zertifikate konfigurieren