Vom Kunden verwaltetes Active Directory (Customer-Managed Active Directory, CMAD) – Übersicht

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, 3269 und 49152 bis 65535.
  • 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:

      1. Delegieren Sie die OE-Berechtigungen:
        1. Klicken Sie in „Active Directory-Benutzer und -Computer“ mit der rechten Maustaste auf die OE und wählen Sie Objektverwaltung zuweisen aus.
        2. Fügen Sie das Administratorkonto hinzu und wählen Sie dann Benutzerdefinierte Aufgabe zum Delegieren erstellen aus.
        3. 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.
        4. 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.
        5. 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):

        Zusammenfassung der Berechtigungen des Assistenten für die Delegierung von Steuerelementen, in der die Optionen „Computerobjekte erstellen“, „Computerobjekte löschen“, „Nutzerobjekte erstellen“ und „Nutzerobjekte löschen“ aufgeführt sind.
      2. Delegieren Sie die Berechtigungen für das Nutzerobjekt:
        1. Klicken Sie noch einmal mit der rechten Maustaste auf die OE und wählen Sie Objektverwaltung zuweisen aus.
        2. Fügen Sie das Administratorkonto hinzu und wählen Sie dann Benutzerdefinierte Aufgabe zum Delegieren erstellen aus.
        3. Wählen Sie auf der Seite Active Directory-Objekttyp die Option Nur die folgenden Objekte im Ordner und dann Nutzerobjekte als einzigen Objekttyp aus.
        4. 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.
        5. 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):

        Zusammenfassung der Berechtigungen des Assistenten für die Delegierung von Steuerelementen, in der „Alle Eigenschaften schreiben“ und „Passwort für Nutzerobjekte zurücksetzen“ aufgeführt sind.
    • 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.

  • 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önnte 2099-07-01T10:30:00Z sein.
    • 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, die myadmin@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önnte 2099-07-01T10:30:00Z sein.
    • 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, die myadmin2@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 validAfterUTC ist 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.

  • 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:

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:

CMAD-Topologie, 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:

CMAD-Topologie, 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 CustomerDbRootRole zugewiesen, 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.com lautet, erstellen Sie SQL Server-Anmeldungen für ad\user und nicht für ad.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.com verwenden. 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:
      "The target principal name is incorrect. Cannot generate SSPI context."
      
    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

Nächste Schritte