ONTAP-Modus-Pool mit Active Directory verknüpfen

Auf dieser Seite wird beschrieben, wie Sie einen Pool im ONTAP-Modus mit einer Active Directory-Domain verbinden.

Flex Unified-Speicherpools im ONTAP-Modus verwenden keine Active Directory-Richtlinien. Wenn Sie Active Directory mit SMB-Volumes verwenden möchten, verbinden Sie die virtuelle ONTAP-Speichermaschine (SVM) im Pool mit Ihrer Windows-Domain, indem Sie einen CIFS-Server erstellen.

Informationen zu den Voraussetzungen für Active Directory und zu Firewallregeln finden Sie unter Active Directory-Integration von Google Cloud NetApp Volumes.

Hinweis

Erfüllen Sie die folgenden Voraussetzungen:

  1. Prüfen Sie, ob das Netzwerk des Speicherpools eine Verbindung zu den Domaincontrollern und DNS-Servern herstellen kann.

  2. Konfigurieren Sie Cloud DNS so, dass DNS-Anfragen für Ihre Windows-Domain an Ihre Windows-DNS-Server weitergeleitet werden.

  3. Erfüllen Sie die Voraussetzungen unter Hinweis.

  4. Stellen Sie folgende Daten zusammen:

    1. AD_FQDN: der voll qualifizierte Domainname, z. B. corp.example.com.

    2. AD_DNS_SERVERS: ein bis drei kommagetrennte IPv4-Adressen für die Active Directory-DNS-Server.

    3. AD_USERNAME und AD_PASSWORD: ein Domainkonto, mit dem Computerkonten erstellt werden können, mit einem SAM-Kontonamen mit maximal 20 Zeichen.

    4. COMPUTER_NAME: ein eindeutiger NetBIOS-Name für das Computerkonto in der Domain mit maximal 15 Zeichen.

    5. OU: Optional: der Distinguished Name für die Zielorganisationseinheit (OU), z. B. OU=Computers,DC=corp,DC=example,DC=com.

nach dem SVM-Namen.

Übersicht

Führen Sie die folgenden Schritte aus, um einen Pool im ONTAP-Modus mit einer Active Directory-Domain zu verbinden:

  1. ontap_execute einrichten

  2. Poolressourcen suchen

  3. DNS auf der SVM konfigurieren

  4. Domain beitreten

  5. SMB-Zugriff konfigurieren

  6. Domainbeitritt bestätigen

Poolressourcen suchen

Suchen Sie nach den folgenden Ressourcen Ihres Speicherpools:

SVM-Name

So suchen Sie nach dem SVM-Namen:

 ontap_execute "vserver show -fields vserver,operational-state"

Notieren Sie sich den Vserver-Namen, z. B. gcnv-7cf6ee41c1a94f0-svm-01. Verwenden Sie diesen Namen in späteren Schritten als SVM_NAME.

Daten-LIFs

Prüfen Sie vor dem Beitritt zur Domain, ob Ihre Daten-LIFs Ihre DNS-Server und Domaincontroller erreichen können.

 ontap_execute "network interface show -role data"

Verwenden Sie zum Testen der Verbindung zu einem DNS-Server oder Domaincontroller eine SAN-LIF mit dem Flag -lif. Pools im ONTAP-Modus stellen SAN-LIFs mit den Namen SVM_NAME-san-1, SVM_NAME-san-2, und bei Bedarf zusätzliche LIFs bereit:

 ontap_execute "network ping -vserver SVM_NAME -destination DNS_OR_DC_IP -lif SVM_NAME-san-1"

Wenn der Ping fehlschlägt, kann Ihr Speicherpool keine Verbindung zum DNS-Server oder Domaincontroller über das Netzwerk herstellen. VMs in Ihrer VPC können möglicherweise trotzdem eine Verbindung zu diesen Hosts herstellen. Weitere Informationen zur Fehlerbehebung bei Verbindungsproblemen finden Sie unter Warum können meine NetApp Volumes keine Verbindung zu Active Directory und anderen Netzwerken hinter meiner VPC herstellen?.

DNS auf der SVM konfigurieren

So konfigurieren Sie DNS auf der SVM:

 ontap_execute "vserver services name-service dns create -vserver SVM_NAME -domains AD_FQDN -name-servers AD_DNS_SERVERS"

Wenn der Name-Service-Switch der Hosts kein DNS enthält, fügen Sie es hinzu:

 ontap_execute "vserver services name-service ns-switch modify -vserver SVM_NAME -database hosts -sources dns,files"

Konfiguration prüfen:

 ontap_execute "vserver services name-service dns show -vserver SVM_NAME"

Domain beitreten

In diesem Abschnitt werden der ONTAP-CLI-Befehl, die Einschränkungen des CLI-Proxys und das Beitreten der Domain mit Python beschrieben.

ONTAP-CLI-Befehl

Führen Sie auf einem System mit direktem ONTAP-CLI-Zugriff den folgenden Befehl aus:

 vserver cifs create -vserver SVM_NAME -cifs-server COMPUTER_NAME -domain AD_FQDN

Verwenden Sie -ou OU und -default-site SITE, um optionale Parameter einzufügen. ONTAP fordert Sie zur Eingabe des Domainpassworts auf. Der Befehl kann mehrere Minuten dauern.

Einschränkungen des CLI-Proxys

Der ONTAP-CLI-Proxy ist nicht interaktiv. Da der Befehl vserver cifs create zur Eingabe eines Passworts auffordert, können Sie den Beitritt zur Domain nicht über den Proxy abschließen. Verwenden Sie stattdessen die REST API. Der entsprechende API-Befehl ist POST /protocols/cifs/services.

Das Skript wirbt nur für AES-256 für die Kerberos-Kommunikation mit Active Directory. Dies ist die empfohlene Einstellung für moderne Domains. Wenn Sie auch für AES-128 oder DES werben möchten, fügen Sie dem Array advertised_kdc_encryptions im Skript Werte hinzu, bevor Sie es ausführen, oder ändern Sie den CIFS-Server nach dem Beitritt zur Domain mit vserver cifs security modify -advertised-enc-types. DES wird nicht empfohlen, da es eine schwache Verschlüsselung verwendet.

Gültige Werte für den Verschlüsselungstyp sind aes-256, aes-128, rc4 und des. Wenn Sie die beworbenen Verschlüsselungstypen nach dem Beitritt zur Domain ändern, setzt ONTAP das Passwort des Computerkontos zurück und fordert Sie zur Eingabe der Active Directory-Anmeldedaten auf.

Domain mit Python beitreten

Speichern Sie das folgende Skript als join_ad.py und führen Sie es mit Python 3.8 oder höher aus. Das Skript verwendet nur die Python-Standardbibliothek.

 #!/usr/bin/env python3
"""Join an ONTAP-mode SVM to Active Directory by creating a CIFS server."""

import json
import os
import subprocess
import sys
import time
import urllib.error
import urllib.request

# Required environment variables.
REQUIRED = (
    "PROJECT_ID", "LOCATION", "POOL_NAME", "SVM_NAME",
    "AD_FQDN", "COMPUTER_NAME", "AD_USERNAME", "AD_PASSWORD",
)
missing = [name for name in REQUIRED if not os.environ.get(name)]
if missing:
    sys.exit(f"Set required environment variables: {', '.join(missing)}")

PROJECT_ID = os.environ["PROJECT_ID"]
LOCATION = os.environ["LOCATION"]
POOL_NAME = os.environ["POOL_NAME"]
SVM_NAME = os.environ["SVM_NAME"]
AD_FQDN = os.environ["AD_FQDN"]
COMPUTER_NAME = os.environ["COMPUTER_NAME"]
AD_USERNAME = os.environ["AD_USERNAME"]
AD_PASSWORD = os.environ["AD_PASSWORD"]

# Optional environment variables.
OU = os.environ.get("OU", "")
AD_SITE = os.environ.get("AD_SITE", "")
POLL_INTERVAL = int(os.environ.get("POLL_INTERVAL", "10"))

# Kerberos encryption types advertised to Active Directory. AES-256 only by default.
# To add aes-128 or des (not recommended), extend this list before you run the script.
ADVERTISED_KDC_ENCRYPTIONS = ["aes-256"]

API_ROOT = (
    f"https://netapp.googleapis.com/v1/projects/{PROJECT_ID}"
    f"/locations/{LOCATION}/storagePools/{POOL_NAME}/ontap/api"
)

def get_access_token() -> str:
    return subprocess.check_output(
        ["gcloud", "auth", "print-access-token"], text=True
    ).strip()

def api_request(method: str, path: str, body=None) -> dict:
    headers = {
        "Authorization": f"Bearer {get_access_token()}",
        "Content-Type": "application/json",
    }
    data = json.dumps(body).encode() if body is not None else None
    req = urllib.request.Request(f"{API_ROOT}{path}", data=data, headers=headers, method=method)
    try:
        with urllib.request.urlopen(req) as resp:
            return json.loads(resp.read())
    except urllib.error.HTTPError as exc:
        detail = exc.read().decode()
        sys.exit(f"API request failed ({exc.code}): {detail}")

def job_record(response: dict) -> dict:
    return response.get("rawResponse") or response.get("body") or response

def job_state(response: dict) -> str:
    return job_record(response).get("state", "")

def format_job_error(response: dict) -> str:
    record = job_record(response)
    message = record.get("message") or record.get("error", {}).get("message")
    if message:
        return message
    return json.dumps(response, indent=2)

def wait_for_job(job_uuid: str) -> None:
    print(f"ONTAP job UUID: {job_uuid}")
    while True:
        response = api_request("GET", f"/cluster/jobs/{job_uuid}")
        state = job_state(response)
        print(f"  Job state: {state}")
        if state == "success":
            print("Domain join completed.")
            return
        if state in ("failure", "error"):
            sys.exit(f"Job failed: {format_job_error(response)}")
        time.sleep(POLL_INTERVAL)

def main() -> None:
    ad_domain = {
        "fqdn": AD_FQDN,
        "user": AD_USERNAME,
        "password": AD_PASSWORD,
    }
    if OU:
        ad_domain["organizational_unit"] = OU
    if AD_SITE:
        ad_domain["default_site"] = AD_SITE

    body = {
        "body": {
            "svm": {"name": SVM_NAME},
            "name": COMPUTER_NAME,
            "ad_domain": ad_domain,
            "security": {
                "advertised_kdc_encryptions": ADVERTISED_KDC_ENCRYPTIONS,
            },
        }
    }

    print(f"Creating CIFS server and joining {AD_FQDN}...")
    response = api_request("POST", "/protocols/cifs/services?return_records=true", body)

    job = (response.get("body") or {}).get("job") or response.get("job")
    if not job or not job.get("uuid"):
        print(json.dumps(response, indent=2))
        return
    wait_for_job(job["uuid"])

if __name__ == "__main__":
    main()

SMB-Zugriff konfigurieren

Gewähren Sie einem Domainnutzer oder einer Domaingruppe lokale Administratorrechte:

 ontap_execute "vserver cifs users-and-groups local-group add-members -vserver SVM_NAME -group-name BUILTIN\\Administrators -member-names NETBIOS_DOMAIN\\username"

Ersetzen Sie NETBIOS_DOMAIN durch den NetBIOS-Domainnamen, nicht durch den DNS-Namen.

Wenn Sie Active Directory-integriertes DNS verwenden, aktivieren Sie sichere dynamische DNS-Updates. Sie müssen das Flag -vserver-fqdn auf den FQDN des CIFS-Servers setzen, z. B. COMPUTER_NAME.AD_FQDN:

 ontap_execute "vserver services name-service dns dynamic-update modify -vserver SVM_NAME -is-enabled true -use-secure true -vserver-fqdn COMPUTER_NAME.AD_FQDN"

Domainbeitritt bestätigen

So bestätigen Sie den Domainbeitritt:

 ontap_execute "vserver cifs show -vserver SVM_NAME"

Prüfen Sie, ob der CIFS-Server online ist und der erwarteten Domain beigetreten ist.

CIFS-Server entfernen

So löschen Sie den CIFS-Server und treten der Domain noch einmal bei:

  1. Deaktivieren Sie sichere dynamische DNS-Updates:

     ontap_execute "vserver services name-service dns dynamic-update modify -vserver SVM_NAME -is-enabled false -use-secure false"
    

    ONTAP blockiert das Löschen von CIFS, solange sicheres DDNS aktiviert ist.

  2. Entfernen Sie das Computerkonto aus Active Directory oder verwenden Sie ein Domainkonto, das berechtigt ist, Computerkonten in der Zielorganisationseinheit zu löschen.

  3. Löschen Sie den CIFS-Server in ONTAP:

     ontap_execute "vserver cifs delete -vserver SVM_NAME -skip-ad-account-delete true"
    

    Verwenden Sie -skip-ad-account-delete true, wenn das Computerkonto bereits aus Active Directory entfernt wurde oder wenn das zum Löschen verwendete Konto nicht berechtigt ist, Computerobjekte zu entfernen. In diesem Fall entfernt ONTAP nur die lokale CIFS-Konfiguration und versucht nicht, ein Active Directory-Objekt zu löschen.

    Standardmäßig entfernt vserver cifs delete auch das Computerkonto aus Active Directory und fordert Sie zur Eingabe der Anmeldedaten des Domainadministrators auf. Diese Aufforderung funktioniert nicht über den ONTAP-CLI-Proxy.

Nächste Schritte