Diese Seite enthält Informationen, die vor Beginn der Einbindung zu prüfen sind. Nachdem Sie die folgenden Informationen, einschließlich der Einschränkungen, gelesen haben, lesen Sie die Informationen unter Kundenverwaltetes Active Directory verwenden.
Sie können Cloud SQL for SQL Server in ein vom Kunden verwaltetes Microsoft Active Directory (auch als vom Kunden verwaltetes AD (CMAD) bezeichnet) einbinden.
Authentifizierung, Autorisierung und mehr sind über CMAD verfügbar. Wenn Sie beispielsweise eine Instanz mit einer CMAD-Domain verknüpfen, können Sie sich über die Windows-Authentifizierung mit einer AD-basierten Identität anmelden. Die Einbindung von Cloud SQL for SQL Server in eine AD-Domain hat den zusätzlichen Vorteil der Einbindung von Google Cloud in Ihre lokalen AD-Domains.
Hinweis
Sie können die Einbindung in CMAD vornehmen und dabei einer Instanz Unterstützung für die Windows-Authentifizierung hinzufügen. Vor der Integration sind jedoch die folgenden Voraussetzungen für IhrGoogle Cloud -Projekt erforderlich:
- Damit die Authentifizierung funktioniert, müssen Ihre Cloud SQL-Instanzen eine Netzwerkverbindung zu allen relevanten Active Directory-Domains haben. Dazu gehören die primäre Domain, der die Instanz beitritt, sowie alle vertrauenswürdigen oder untergeordneten Domains mit Nutzern, die auf Cloud SQL for SQL Server zugreifen müssen. Damit dies möglich ist, müssen die folgenden Ports (sowohl TCP als auch UDP) zwischen Ihren Cloud SQL-Instanzen und allen Ihren Domaincontrollern geöffnet sein:
53,88,135,389,445,464,3268,3269und49152bis65535. - Sie müssen eine Organisationseinheit (OE) erstellen, um alle zugehörigen Integrationsobjekte zu speichern.
- Innerhalb dieser OE müssen Sie außerdem die folgenden Berechtigungen an das Administratorkonto delegieren:
- In der OE: Computerobjekte erstellen, Computerobjekte löschen, Nutzerobjekte erstellen und Nutzerobjekte löschen
- Für die Nutzerobjekte in der OE: Alle Eigenschaften schreiben und Passwort zurücksetzen
Wenn Sie diese Berechtigungen delegieren möchten, verwenden Sie den Active Directory-Assistenten zum Zuweisen der Objektverwaltung, um zwei benutzerdefinierte Aufgaben für die OE zu erstellen:
- Delegieren Sie die OE-Berechtigungen:
- Klicken Sie in „Active Directory-Benutzer und -Computer“ mit der rechten Maustaste auf die OE und wählen Sie Objektverwaltung zuweisen aus.
- Fügen Sie das Administratorkonto hinzu und wählen Sie dann Benutzerdefinierte Aufgabe zum Delegieren erstellen aus.
- Wählen Sie auf der Seite Active Directory-Objekttyp die Option Dieser Ordner, vorhandene Objekte in diesem Ordner und Erstellung neuer Objekte in diesem Ordner aus.
- Wählen Sie auf der Seite Berechtigungen die Option Erstellung/Löschung bestimmter untergeordneter Objekte und dann Computerobjekte erstellen, Computerobjekte löschen, Nutzerobjekte erstellen und Nutzerobjekte löschen aus.
- Schließen Sie den Assistenten ab.
Der folgende Screenshot zeigt ein Beispiel für die Berechtigungsübersicht für diesen Schritt (unter Windows Server 2025):
- Delegieren Sie die Berechtigungen für das Nutzerobjekt:
- Klicken Sie noch einmal mit der rechten Maustaste auf die OE und wählen Sie Objektverwaltung zuweisen aus.
- Fügen Sie das Administratorkonto hinzu und wählen Sie dann Benutzerdefinierte Aufgabe zum Delegieren erstellen aus.
- Wählen Sie auf der Seite Active Directory-Objekttyp die Option Nur die folgenden Objekte im Ordner und dann Nutzerobjekte als einzigen Objekttyp aus.
- Wählen Sie auf der Seite Berechtigungen die Option Allgemein und dann Alle Attribute schreiben und Passwort zurücksetzen aus. Wenn Passwort zurücksetzen nicht aufgeführt ist, prüfen Sie, ob Nutzerobjekte der einzige ausgewählte Objekttyp ist.
- Schließen Sie den Assistenten ab.
Der folgende Screenshot zeigt ein Beispiel für die Berechtigungsübersicht für diesen Schritt (unter Windows Server 2025):
- Wir empfehlen außerdem, diesem Administratorkonto Berechtigungen zum Verwalten von DNS-Einträgen zu gewähren, z. B. durch Hinzufügen zur Gruppe „DnsAdmins“.
Wenn Sie diese Berechtigungen nicht gewähren, wird die Integration trotzdem erfolgreich sein. Wenn Sie eine Verbindung zu Ihrer Instanz herstellen möchten, müssen Sie die erforderlichen DNS-Einträge manuell erstellen, wie unter Verbindung zu einer Instanz mit einem Nutzer herstellen beschrieben.
Die Alternative besteht darin, eine Verbindung über die IP-Adresse der Instanz herzustellen. Dies hat jedoch Einschränkungen und funktioniert nicht für Verbindungen von vertrauenswürdigen Domains.
- Innerhalb dieser OE müssen Sie außerdem die folgenden Berechtigungen an das Administratorkonto delegieren:
- Sie müssen Ihre Administrator-Anmeldedaten in einem Secret Manager-Secret im folgenden JSON-Format speichern:
{ "credentials": [ { "validAfterUTC": "VALID_AFTER_UTC_VALUE", "administratorLogin": "ADMINISTRATOR_LOGIN_VALUE_1", "administratorPassword": "ADMINISTRATOR_PASSWORD_VALUE_1" }, { "validAfterUTC": "VALID_AFTER_UTC_VALUE_2", "administratorLogin": "ADMINISTRATOR_LOGIN_VALUE_2", "administratorPassword": "ADMINISTRATOR_PASSWORD_VALUE_2" } ] }
Ersetzen Sie Folgendes:
- VALID_AFTER_UTC_VALUE_1: der erste UTC-Wert, den Sie verwenden möchten, im Format
YYYY-MM-DDThh:mm:ssZ. Ein Beispiel könnte2099-07-01T10:30:00Zsein. - ADMINISTRATOR_LOGIN_VALUE_1: der erste Administrator-Anmeldename, den Sie verwenden möchten, z. B.
myadmin. Geben Sie den Domainnamen nicht im Wert an. Einträge, diemyadmin@my-domain-name.comähneln, werden nicht unterstützt. - ADMINISTRATOR_PASSWORD_VALUE_1: das Administratorpasswort.
- VALID_AFTER_UTC_VALUE_2: der zweite UTC-Wert, den Sie verwenden möchten, im Format
YYYY-MM-DDThh:mm:ssZ. Ein Beispiel könnte2099-07-01T10:30:00Zsein. - ADMINISTRATOR_LOGIN_VALUE_2: die Anmeldung des zweiten Administrators, die Sie verwenden möchten, z. B.
myadmin2. Geben Sie auch nicht den Domainnamen im Wert an. Einträge, diemyadmin2@my-domain-name.comähneln, werden nicht unterstützt. - ADMINISTRATOR_PASSWORD_VALUE_2: das Passwort des zweiten Administrators.
Diese Datei kann mehrere Anmeldedateneinträge enthalten, um Probleme mit langsamer Weitergabe zu beheben oder geplante, vorzeitige Rotationen zu ermöglichen.
Das Feld
validAfterUTCist optional. Wenn es nicht angegeben ist, wird davon ausgegangen, dass die Anmeldedaten immer gültig sind. Wir empfehlen, diese Anmeldedaten dauerhaft in Secret Manager verfügbar zu halten und das Passwort automatisch zu aktualisieren, wenn Sie die Anmeldedaten rotieren.Sie können das Secret nach dem Erstellen der Instanz löschen. Beachten Sie jedoch, dass zukünftige Vorgänge wie das Klonen oder Hinzufügen eines Lesereplikats dazu führen, dass die neue Instanz nicht der Domain hinzugefügt wird.
Außerdem bleiben beim Löschen der ursprünglichen Instanz verwaiste Objekte wie das Computerkonto in Ihrem CMAD zurück.
- VALID_AFTER_UTC_VALUE_1: der erste UTC-Wert, den Sie verwenden möchten, im Format
- Sie benötigen eine Liste der DNS-Server-IP-Adressen für Ihr vom Kunden verwaltetes Active Directory. Dies sind in der Regel Ihre Domaincontroller. Wir empfehlen, für diese Server statische IP-Adressen zu verwenden.
- Produkt- und projektspezifische Dienstkonten zuweisen.
Dienstkonto erstellen und konfigurieren
Prüfen Sie Folgendes, um ein Dienstkonto mit den erforderlichen Berechtigungen zu erstellen:
- Sie müssen die Cloud SQL Admin API aktivieren.
- Sie benötigen die folgenden Berechtigungen:
- resourcemanager.projects.setIamPolicy
- secretmanager.secrets.getIamPolicy
- secretmanager.secrets.setIamPolicy
Sie benötigen für jedes Projekt, das Sie in CMAD einbinden möchten, ein produkt- und projektspezifisches Dienstkonto. Verwenden Sie die gcloud CLI, um das Konto auf Projektebene zu erstellen. Dem produkt- und projektspezifischen Dienstkonto sollten die Berechtigungen
secretmanager.secrets.getIamPolicyundsecretmanager.secrets.setIamPolicyfür das im vorherigen Schritt erstellte Secret gewährt werden. Weitere Informationen finden Sie unter Secret Manager-Berechtigungen.Wir empfehlen, eine benutzerdefinierte Rolle mit den erforderlichen Berechtigungen zu erstellen.
Führen Sie den folgenden Befehl aus, um ein Dienstkonto mit der gcloud CLI zu erstellen:
gcloud beta services identity create --service=sqladmin.googleapis.com
--project=PROJECT_ID
Dieser Befehl gibt den Namen eines Dienstkontos im folgenden Format zurück:
service-PROJECT_ID@gcp-sa-cloud-sql.iam.gserviceaccount.com
Hier ist ein Beispiel für einen Dienstkontonamen:
service-333445@gcp-sa-cloud-sql.iam.gserviceaccount.com
Führen Sie den folgenden Befehl aus, um die erforderliche Berechtigung für die Einbindung zu erteilen:
gcloud iam roles create secretIamPolicyManager --project=PROJECT_ID
--permissions="secretmanager.secrets.getIamPolicy,secretmanager.secrets.setIamPolicy"
Führen Sie dann den folgenden Befehl aus:
gcloud secrets add-iam-policy-binding ADCredentials --project="722300452883"
--member="serviceAccount:service-SQL_PROJECT_NUMBER@gcp-sa-cloud-sql.iam.gserviceaccount.com"
--role="projects/PROJECT-ID/roles/secretIamPolicyManager"
Weitere Informationen finden Sie unter gcloud beta services identity create.
Best Practices für die Einbindung in CMAD
Bei der Integration in CMAD empfehlen wir, die folgenden Schritte auszuführen.
Voraussetzungen für die Einbindung
Verwenden Sie das vom Kunden verwaltete Active Directory-Diagnosetool, um Probleme bei der Active Directory-Einrichtung mit Ihrer Domain zu beheben, bevor Sie sie in Cloud SQL einbinden.
Topologien für die Einbindung in CMAD
Cloud SQL for SQL Server unterstützt keine lokalen Domaingruppen. Es sind jedoch die folgenden Alternativen verfügbar:
- Fügen Sie globale Gruppen oder einzelne Nutzeranmeldungen direkt in SQL Server hinzu.
- Verwenden Sie universelle Gruppen, wenn alle Gruppen und Nutzer derselben Gesamtstruktur angehören.
Cloud SQL for SQL Server unterstützt keine lokalen Domaingruppen als Anmeldungen. Wenn Sie Domainnutzern Berechtigungen gewähren möchten, müssen Sie stattdessen globale oder universelle Gruppen verwenden, wie in diesem Abschnitt beschrieben.
Option 1: Nutzerkonten und -gruppen als Anmeldungen zu SQL Server hinzufügen
Wenn Sie mehrere Domains in mehreren Gesamtstrukturen und mehrere globale Gruppen haben, können Sie alle einzelnen Nutzerkonten sowie die globalen und universellen Gruppen direkt als Anmeldungen zu SQL Server hinzufügen. Das folgende Diagramm zeigt ein Beispiel für Option 1:

Option 2: Universelle Gruppe in einer Ihrer Domains definieren
Wenn sich Ihre Domains in derselben Gesamtstruktur befinden, können Sie eine universelle Gruppe in einer Ihrer Domains definieren. Anschließend können Sie alle einzelnen Nutzerkonten sowie die globalen und universellen Gruppen als untergeordnete Elemente dieser definierten universellen Gruppe hinzufügen und die definierte universelle Gruppe als SQL Server-Anmeldung hinzufügen. Das folgende Diagramm zeigt ein Beispiel für Option 2:

Einschränkungen und Alternativen
Bei der Integration in CMAD gelten die folgenden Einschränkungen:
- Cloud SQL for SQL Server-Instanzen, die Private Service Connect (PSC) für private Konnektivität verwenden, werden nicht unterstützt. Verwenden Sie stattdessen den Zugriff auf private Dienste.
- Lokale Domaingruppen werden nicht unterstützt. Sie können jedoch globale Gruppen oder einzelne Nutzeranmeldungen direkt in SQL Server hinzufügen. Alternativ können Sie universelle Gruppen verwenden, wenn alle Gruppen und Nutzer derselben Gesamtstruktur angehören.
- Wenn es zusätzliche vertrauenswürdige Domains gibt und Sie mit Nutzernamen von dort auf SQL Server-Instanzen zugreifen möchten, müssen diese über eine bidirektionale Vertrauensstellung verbunden sein. Unidirektionale und externe Vertrauensstellungen werden nicht unterstützt.
- Im Allgemeinen wird neuen Nutzern, die über die Google Cloud Console erstellt werden, die Rolle
CustomerDbRootRolezugewiesen, die diese feste Datenbankrolle des SQL Server-Agent hat:SQLAgentUserRole. Nutzer, die direkt über SQL Server erstellt wurden, z. B. CMAD-Nutzer, können diese Rolle jedoch nicht erhalten oder den SQL Server-Agent verwenden, da die MSDB-Datenbank, für die diese Rolle gewährt werden muss, geschützt ist. - Voll qualifizierte Domainnamen (FQDNs) werden von SQL Server nicht unterstützt.
Verwenden Sie daher beim Erstellen von SQL Server-Anmeldungen Domainnamen (Kurznamen) anstelle von FQDNs. Wenn Ihr Domainname beispielsweise
ad.mydomain.comlautet, erstellen Sie SQL Server-Anmeldungen fürad\userund nicht fürad.mydomain.com\user. - Verwenden Sie zum Zugriff auf SQL Server-Instanzen immer die FQDNs. Sie können beispielsweise einen FQDN wie
private.myinstance.us-central1.myproject.cloudsql.mydomain.comverwenden. NetBIOS-Namen werden nicht unterstützt, ebenso wenig wie Kurznamen, wenn DNS-Suffixe weggelassen werden. - SQL Server-Anmeldungen, die auf Active Directory-Nutzern und -Gruppen basieren, können nicht über die Google Cloud Console verwaltet werden.
- Die Windows-Authentifizierung funktioniert nicht mit einer externen Vertrauensstellung. Der zurückgegebene Fehler könnte folgender sein:
Verwenden Sie außerdem laut Microsoft-Empfehlungen eine Gesamtstruktur-Vertrauensstellung statt einer externen Vertrauensstellung für die Kerberos-Authentifizierung. - Es wird immer die aktuelle Version des Secrets verwendet. Das Secret muss aktiv sein und darf nicht gelöscht werden.
Active Directory-Endpunkte und TLS-Verbindungen
Wenn Sie die Windows-Authentifizierung verwenden und eine TLS-Verbindung herstellen möchten, ohne dem Serverzertifikat zu vertrauen, müssen Sie die Zertifikate rotieren, nachdem die Windows-Authentifizierung auf der Instanz aktiviert wurde.
Wenn die Verbindung fehlschlägt und eines Ihrer Zertifikate vor dem 15. März 2025 erstellt wurde, müssen Sie das Serverzertifikat noch einmal rotieren und die Verbindung noch einmal herstellen.
Einbindung nicht unterstützt
Die folgenden Features werden bei einer Einbindung in CMAD nicht unterstützt:
- Lokale Domaingruppen.
- NTLM-Authentifizierung
- Anmeldung mit einer IP-Adresse aus Domains, die über eine Vertrauensstellung verbunden sind.
- Instanzen mit langen Namen (mehr als 63 Zeichen).
Monitoring
Sie können den folgenden Messwert verwenden, um den Status und Zustand von CMAD zu überwachen:
cloudsql.googleapis.com/database/active_directory/domain_reachable
Dieser Messwert gibt an, ob der CMAD von der Cloud SQL-Instanz aus erreichbar ist. Es ist ein nützliches Tool zur Behebung von Netzwerkproblemen:
cloudsql.googleapis.com/database/active_directory/instance_available