Microsoft Intune 노드정보 동기화

Microsoft Intune에 등록된 장치의 준수 상태와 자산 정보를 수집하여 Genian ZTNA의 기존 노드에 반영할 수 있습니다. 제품에 포함된 Microsoft Intune - 노드정보 동기화 Workflow를 설정한 뒤, 정보 동기화의 소스로 선택합니다.

이 예제는 장치의 MAC 주소로 기존 노드를 찾고, Intune의 준수 상태를 노드 추가필드에 저장합니다. 저장한 정보를 노드 그룹 조건으로 활용할 수 있습니다.

사전 준비

  • 유효한 Microsoft Intune 라이선스가 있는 테넌트와 Intune에 등록된 테스트 장치가 필요합니다.

  • 관리콘솔에서 DB타입 > Workflow 와 Intune 기본 Workflow를 사용할 수 있어야 합니다.

  • 테스트 장치가 Genian ZTNA의 노드로 존재해야 하며, Intune이 제공하는 MAC 주소와 해당 노드의 MAC 주소가 일치해야 합니다.

  • 정책서버에서 login.microsoftonline.com 과 graph.microsoft.com 으로 HTTPS(TCP/443) 통신이 가능해야 합니다.

Entra 앱 준비하기

  1. Microsoft Entra 관리 센터에서 Intune 조회에 사용할 앱을 등록합니다.

  2. 앱의 Directory (tenant) ID 와 Application (client) ID 를 확인합니다.

  3. Microsoft Graph의 Application permissions 에 DeviceManagementManagedDevices.Read.All 을 추가하고 관리자 동의를 부여합니다.

  4. 클라이언트 암호를 생성하고 Value 를 안전하게 보관합니다. Workflow에는 Secret ID 대신 이 값을 입력합니다.

앱 등록과 권한 설정의 상세 내용은 Microsoft Graph 앱 전용 인증 및 앱 자격증명 추가 를 참고하시기 바랍니다.

Intune 기본 Workflow 설정하기

  1. Workflow 페이지로 이동합니다.

  2. Microsoft Intune - 노드정보 동기화 를 엽니다.

  3. 왼쪽 >> 아이콘을 클릭하여 연동 정보 를 엽니다.

  4. 다음 값을 입력합니다.

    항목

    입력값

    타입

    tenantId

    Directory (tenant) ID

    Plaintext

    clientId

    Application (client) ID

    Plaintext

    clientSecret

    클라이언트 암호의 Value

    Secret

  5. 연동 정보를 저장하고, Workflow의 테스트 기능으로 장치 조회 결과를 확인합니다.

기본 Workflow는 Microsoft Graph v1.0을 사용합니다. 인증 토큰을 발급받은 뒤 장치 목록과 장치별 정보를 조회하고, 장치 정보를 배열로 반환합니다. Workflow 설정과 테스트 방법은 Workflow 를 참고하시기 바랍니다.

참고

기본 Workflow 이름은 설치 시 사용한 언어에 따라 다를 수 있습니다. 영문 이름은 Microsoft Intune - Node Data Synchronization 입니다. 클라이언트 암호가 만료되거나 교체된 경우 연동 정보도 갱신해야 합니다. 저장된 Secret 타입 값을 교체하려면 해당 항목을 삭제한 뒤 같은 키 이름과 Secret 타입으로 다시 추가합니다.

노드 추가필드 준비하기

  1. 설정 > 속성관리 > 추가필드관리 > 노드 로 이동합니다.

  2. 작업선택 > 생성 을 선택합니다.

  3. 사용하지 않는 Key 를 선택하여 준수 상태를 저장할 문자열 추가필드를 생성합니다. 선택한 Key를 확인해 둡니다. 이 예제에서는 필드 이름을 Intune 준수 상태 로 사용합니다.

추가필드 설정과 값 확인 방법은 추가 필드를 사용하여 노드에 추가정보 입력하기 를 참고하시기 바랍니다.

정보 동기화 설정하기

  1. 설정 > 사용자인증 > 정보 동기화 로 이동합니다.

  2. 작업선택 > 생성 을 클릭하고 ID 를 입력합니다.

  3. 상세설정 > DB타입 을 Workflow 로 선택합니다.

  4. 노드정보 워크플로우 에서 Intune 기본 Workflow를 선택합니다.

  5. Workflow 결과 배열 필드명 과 Workflow 다음페이지 필드명 은 비워 둡니다. 기본 Workflow의 최종 결과는 배열입니다.

  6. 노드정보 동기화 를 On 으로, 사용자정보·부서정보·직급정보·장비수명주기정보 동기화는 Off 로 설정합니다.

  7. 노드정보 에서 다음과 같이 매핑합니다.

    설정 항목

    설정값

    설명

    MAC주소컬럼명

    deviceMac

    장치를 식별할 MAC 주소입니다.

    IPv4주소컬럼명

    비움

    MAC 주소만으로 기존 노드를 찾습니다.

    추가정보 > 준수 상태용 추가필드

    complianceState

    앞에서 만든 노드 추가필드에 준수 상태를 저장합니다.

  8. 추가정보 에서 추가필드 생성 시 선택한 Key 에 해당하는 항목을 선택하고 컬럼명 에 complianceState 를 입력합니다.

  9. 동기화 수행주기 와 정책적용여부 를 설정하고 생성 을 클릭합니다. 처음에는 수동으로 수행하여 매핑 결과를 확인합니다.

컬럼명에는 deviceMac 과 complianceState 를 그대로 입력합니다. result. 또는 value. 와 같은 접두사를 붙이지 않습니다. 공통 설정은 Workflow를 통한 정보 동기화 를 참고하시기 바랍니다.

필요한 경우 추가정보 에 다음 항목을 선택하여 매핑할 수 있습니다. 각 값의 용도에 맞는 노드 추가필드를 먼저 준비합니다.

수집할 정보

반환 필드명

참고

장치 이름

deviceName

노드이름컬럼명에 매핑하면 기존 노드 이름을 변경할 수 있습니다.

시리얼 번호

serialNumber

자산 식별용 추가필드에 저장할 수 있습니다.

운영체제

operatingSystem

운영체제 확인용 추가필드에 저장할 수 있습니다.

운영체제 버전

osVersion

버전 확인용 추가필드에 저장할 수 있습니다.

마지막 Intune 동기화 시각

lastSyncDateTime

Genian ZTNA의 정보 동기화 수행 시각과 다릅니다.

동기화 결과 확인하기

  1. 정보 동기화 목록에서 생성한 설정을 선택합니다.

  2. 작업선택 > 즉시수행 을 클릭합니다.

  3. 목록의 최근 동기화 수행 시각, 최근 동기화 수행 결과 를 확인합니다. 오류가 있으면 로그 에서 수행 내역을 확인합니다.

  4. 관리 > 노드 에서 테스트 장치의 노드를 엽니다.

  5. 노드정보 탭의 부가정보 에서 Intune 준수 상태 값을 확인하고, 노드의 MAC 주소와 함께 Intune 장치정보와 비교합니다.

준수 상태가 compliant 인 노드를 구분하려면 저장한 추가필드 값을 노드 그룹 조건으로 사용할 수 있습니다. 노드 그룹 설정은 노드 그룹 관리 를 참고하시기 바랍니다. 허용·제한 정책을 구성할 때는 unknown, noncompliant, conflict, error, inGracePeriod, configManager 등 다른 상태도 함께 검토합니다.

동작 범위와 주의사항

  • MAC 선택: Wi-Fi MAC을 먼저 사용하고, 없으면 Ethernet MAC을 사용합니다. 두 주소가 모두 있어도 한 장치에서 한 개의 MAC만 사용합니다. 두 주소가 모두 없으면 해당 장치의 노드를 갱신할 수 없습니다.

  • 기존 노드 갱신: MAC 주소가 일치하는 기존 노드의 매핑된 정보만 갱신합니다. 신규 노드를 생성하거나 노드를 삭제하지 않습니다. 같은 MAC 주소의 노드가 여러 개이면 함께 갱신될 수 있습니다.

  • 빈 값 반영: 매핑한 필드의 원본 값이 비어 있으면 기존 정보도 비워질 수 있습니다. 필요한 항목만 매핑하시기 바랍니다.

  • 반영 시점: 장치의 Intune 체크인, Microsoft Graph 반영, Genian ZTNA의 동기화 주기에 따라 상태가 반영됩니다. 장치 상태 변경 직후 바로 갱신되는 것은 아닙니다.

주의

기본 Intune Workflow는 장치 목록의 첫 페이지를 처리하며 다음 페이지를 이어서 조회하지 않습니다. 장치 목록이 여러 페이지로 반환되면 일부 장치가 동기화되지 않을 수 있으므로, 동기화 결과와 Intune의 전체 장치 목록을 비교하시기 바랍니다. 페이지를 반복 수집하려면 다음 페이지 커서를 처리하는 Workflow 구성이 필요합니다. Workflow를 통한 정보 동기화 를 참고하시기 바랍니다.