ONTAP 모드 풀을 Active Directory에 조인

이 페이지에서는 ONTAP 모드 풀을 Active Directory 도메인에 조인하는 방법을 설명합니다.

ONTAP 모드의 Flex Unified 스토리지 풀은 Active Directory 정책을 사용하지 않습니다. SMB 볼륨과 함께 Active Directory를 사용하려면 CIFS 서버를 만들어 풀의 ONTAP 스토리지 가상 머신(SVM)을 Windows 도메인에 조인합니다.

Active Directory 필수 요건 및 방화벽 규칙은 Google Cloud NetApp Volumes Active Directory 통합을 참고하세요.

시작하기 전에

다음 기본 요건을 완료합니다.

  1. 스토리지 풀 네트워크가 도메인 컨트롤러 및 DNS 서버에 연결할 수 있는지 확인합니다.

  2. Windows 도메인의 DNS 요청을 Windows DNS 서버로 전달하도록 Cloud DNS를 구성합니다.

  3. 시작하기 전에의 기본 요건을 완료합니다.

  4. 다음 정보를 수집합니다.

    1. AD_FQDN: 정규화된 도메인 이름입니다(예: corp.example.com).

    2. AD_DNS_SERVERS: Active Directory DNS 서버의 쉼표로 구분된 IPv4 주소(1~3개)입니다.

    3. AD_USERNAME 및 AD_PASSWORD: 컴퓨터 계정을 만들 수 있는 도메인 계정으로, SAM 계정 이름이 20자 이하입니다.

    4. COMPUTER_NAME: 도메인 내 컴퓨터 계정의 고유한 NetBIOS 이름으로, 최대 15자입니다.

    5. OU: 선택사항: 대상 조직 단위(OU)의 고유 이름입니다(예: OU=Computers,DC=corp,DC=example,DC=com).

개요

ONTAP 모드 풀을 Active Directory 도메인에 가입시키려면 다음 단계를 완료하세요.

  1. ontap_execute 설정

  2. 풀 리소스 조회

  3. SVM에서 DNS 구성

  4. 도메인 가입

  5. SMB 액세스 구성

  6. 도메인 가입 확인하기

풀 리소스 조회

스토리지 풀의 다음 리소스를 조회합니다.

SVM 이름

SVM 이름을 조회하려면 다음 단계를 따르세요.

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

Vserver 이름(예: gcnv-7cf6ee41c1a94f0-svm-01)을 기록합니다. 이 이름을 이후 단계에서 SVM_NAME로 사용합니다.

데이터 LIF

도메인에 가입하기 전에 데이터 LIF가 DNS 서버와 도메인 컨트롤러에 도달할 수 있는지 확인합니다.

 ontap_execute "network interface show -role data"

DNS 서버 또는 도메인 컨트롤러에 대한 연결을 테스트하려면 -lif 플래그가 있는 SAN LIF를 사용합니다. ONTAP 모드 풀은 SVM_NAME-san-1, SVM_NAME-san-2 및 필요에 따라 추가 LIF를 노출합니다.

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

핑이 실패하면 스토리지 풀이 네트워크를 통해 DNS 서버 또는 도메인 컨트롤러에 연결할 수 없습니다. VPC의 가상 머신 (VM)은 여전히 이러한 호스트에 연결할 수 있습니다. 연결 문제 해결에 대한 자세한 내용은 NetApp Volumes가 VPC 뒤에 있는 Active Directory 및 기타 네트워크에 연결할 수 없는 이유를 참고하세요.

SVM에서 DNS 구성

SVM에서 DNS를 구성하려면 다음 단계를 따르세요.

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

호스트 이름 서비스 스위치에 DNS가 포함되지 않은 경우 다음을 추가합니다.

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

구성 확인

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

도메인 가입

이 섹션에서는 ONTAP CLI 명령어, CLI 프록시의 제한사항, Python을 사용하여 도메인에 가입하는 방법을 설명합니다.

ONTAP CLI 명령어

ONTAP CLI에 직접 액세스할 수 있는 시스템에서 다음 명령어를 실행합니다.

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

선택적 매개변수를 포함하려면 -ou OU 및 -default-site SITE을 사용하세요. ONTAP에서 도메인 비밀번호를 묻는 메시지가 표시되며 명령어를 실행하는 데 몇 분 정도 걸릴 수 있습니다.

CLI 프록시의 제한사항

ONTAP CLI 프록시는 대화형이 아닙니다. vserver cifs create 명령어는 비밀번호를 묻는 메시지를 표시하므로 프록시를 통해 도메인 가입을 완료할 수 없습니다. 대신 REST API를 사용하세요. API에 해당하는 값은 POST /protocols/cifs/services입니다.

스크립트는 Active Directory와의 Kerberos 통신에만 AES-256을 광고합니다. 최신 도메인에 권장되는 설정입니다. AES-128 또는 DES도 광고하려면 스크립트를 실행하기 전에 스크립트의 advertised_kdc_encryptions 배열에 값을 추가하거나 도메인 가입 후 vserver cifs security modify -advertised-enc-types를 사용하여 CIFS 서버를 수정합니다. DES는 약한 암호화를 사용하므로 권장되지 않습니다.

유효한 암호화 유형 값은 aes-256, aes-128, rc4, des입니다. 도메인 가입 후 광고된 암호화 유형을 변경하면 ONTAP에서 머신 계정 비밀번호를 재설정하고 Active Directory 사용자 인증 정보를 묻는 메시지를 표시합니다.

Python을 사용하여 도메인 가입

다음 스크립트를 join_ad.py로 저장하고 Python 3.8 이상으로 실행합니다. 스크립트는 Python 표준 라이브러리만 사용합니다.

 #!/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 액세스 구성

도메인 사용자 또는 그룹에 로컬 관리자 권한을 부여합니다.

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

NETBIOS_DOMAIN을 DNS 이름이 아닌 NetBIOS 도메인 이름으로 바꿉니다.

Active Directory 통합 DNS를 사용하는 경우 보안 동적 DNS 업데이트를 사용 설정합니다. -vserver-fqdn 플래그를 CIFS 서버 FQDN으로 설정해야 합니다(예: 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"

도메인 가입 확인

도메인 가입을 확인하려면 다음 단계를 따르세요.

 ontap_execute "vserver cifs show -vserver SVM_NAME"

CIFS 서버가 온라인 상태이고 예상 도메인에 조인되어 있는지 확인합니다.

CIFS 서버 삭제

CIFS 서버를 삭제하고 도메인에 다시 가입하려면 다음 단계를 완료하세요.

  1. 보안 동적 DNS 업데이트를 사용 중지합니다.

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

    보안 DDNS가 사용 설정된 동안 ONTAP에서 CIFS 삭제를 차단합니다.

  2. Active Directory에서 컴퓨터 계정을 삭제하거나 대상 OU에서 컴퓨터 계정을 삭제할 수 있는 권한이 있는 도메인 계정을 사용합니다.

  3. ONTAP에서 CIFS 서버를 삭제합니다.

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

    컴퓨터 계정이 이미 Active Directory에서 삭제되었거나 삭제에 사용된 계정에 컴퓨터 객체를 삭제할 권한이 없는 경우 -skip-ad-account-delete true를 사용합니다. 이 경우 ONTAP는 로컬 CIFS 구성만 삭제하고 Active Directory 객체를 삭제하려고 시도하지 않습니다.

    기본적으로 vserver cifs delete는 Active Directory에서 컴퓨터 계정도 삭제하고 도메인 관리자 사용자 인증 정보를 묻는 메시지를 표시합니다. 이 프롬프트는 ONTAP CLI 프록시를 통해 작동하지 않습니다.

다음 단계