Workflow를 통한 정보 동기화

Workflow에서 외부 시스템의 인증, 데이터 조회, 응답 변환을 구성하고 그 결과를 정보 동기화의 소스로 사용할 수 있습니다. 사용자정보, 부서정보, 직급정보, 노드정보, 장비수명주기정보별로 사용할 Workflow를 선택합니다.

Workflow 구성 방법은 Workflow 를 참고하시기 바랍니다. 제품 기본 Workflow를 사용하는 예제는 Microsoft Intune 노드정보 동기화 에서 확인할 수 있습니다.

Workflow 준비하기

동기화할 정보를 JSON 배열로 반환하는 Workflow를 준비합니다. 배열의 각 항목은 한 건의 사용자, 부서, 직급, 노드 또는 장비 정보를 나타내야 합니다. 다음은 노드정보를 반환하는 예제입니다.

[
  {
    "deviceMac": "02:00:00:00:00:01",
    "deviceName": "Example Device"
  }
]

이 예제의 MAC주소컬럼명 은 deviceMac 입니다. 컬럼명은 Workflow의 최종 결과에서 각 레코드의 필드명을 기준으로 입력합니다.

정보 동기화 설정하기

상단 패널의 설정 으로 이동합니다.
왼쪽 사용자인증 > 정보 동기화 를 선택합니다.
작업선택 > 생성 을 클릭합니다.
동기화 설정을 구분할 ID 를 입력합니다.
동기화 수행주기 를 설정합니다. 처음에는 수동으로 실행하여 결과를 확인한 뒤 필요한 주기를 설정합니다.
동기화 후 정책에 변경사항을 반영하려면 정책적용여부 를 적용함 으로 설정합니다.
상세설정 > DB타입 에서 Workflow 를 선택합니다.

동기화할 정보 종류에 해당하는 Workflow를 선택합니다.

설정 항목	설명
사용자정보 워크플로우	사용자정보를 반환하는 Workflow를 선택합니다.
부서정보 워크플로우	부서정보를 반환하는 Workflow를 선택합니다.
직급정보 워크플로우	직급정보를 반환하는 Workflow를 선택합니다.
노드정보 워크플로우	노드정보를 반환하는 Workflow를 선택합니다.
장비수명주기정보 워크플로우	장비수명주기정보를 반환하는 Workflow를 선택합니다.

사용자정보, 부서정보, 직급정보, 노드정보, 장비수명주기정보 에서 동기화할 항목만 On 으로 설정하고, 사용하지 않는 항목은 Off 로 설정합니다.
사용할 정보 종류의 컬럼명에 Workflow가 반환하는 레코드의 필드명을 입력합니다.
추가정보 에서 반영할 항목을 선택하고 해당 필드명을 입력합니다.
생성 을 클릭합니다.

참고

노드정보와 장비수명주기정보의 MAC주소컬럼명 은 필수이며, IPv4주소컬럼명 은 선택 항목입니다. IPv4 컬럼을 비우면 MAC 주소로 대상을 식별합니다. 노드정보 동기화에서 두 컬럼을 모두 설정하면 MAC 주소와 IPv4 주소가 모두 일치하는 노드를 찾습니다.

페이지가 나뉘는 결과 설정하기

외부 시스템의 결과가 여러 페이지로 나뉘는 경우, Workflow가 한 페이지의 배열과 다음 페이지를 요청할 커서를 함께 반환하도록 구성할 수 있습니다. 다음은 마지막 페이지의 최종 결과 예제입니다.

{
  "result": [
    {
      "deviceMac": "02:00:00:00:00:01",
      "deviceName": "Example Device"
    }
  ],
  "nextLink": ""
}

설정 항목	설명
Workflow 결과 배열 필드명	최종 결과 객체에서 배열을 담은 필드명입니다. 비우면 result를 사용합니다.
Workflow 다음페이지 필드명	최종 결과 객체에서 다음 페이지 커서를 담은 필드명입니다. 비우면 nextLink를 사용합니다.

다음 페이지 커서가 있으면 정보 동기화가 그 값을 같은 필드명의 입력값으로 전달하여 Workflow를 다시 실행합니다. Workflow는 전달받은 커서로 다음 페이지를 조회하고, 마지막 페이지에서는 커서를 비워 반환해야 합니다. 컬럼명에는 결과 배열 안에 있는 각 레코드의 필드명을 입력합니다.

참고

위 두 필드명을 설정하는 것만으로 외부 시스템의 페이지를 자동 조회하지는 않습니다. 선택한 Workflow가 커서를 받아 다음 페이지를 조회하고, 결과에 다음 커서를 반환하도록 구성되어 있어야 합니다. 최종 결과가 배열인 Workflow에는 이 두 필드명을 별도로 설정할 필요가 없습니다.

동기화 실행 및 결과 확인하기

정보 동기화 목록에서 생성한 설정을 선택합니다.
작업선택 > 즉시수행 을 클릭합니다.
목록의 최근 동기화 수행 시각, 최근 동기화 수행 결과 를 확인합니다. 수행 내역은 로그 에서 확인할 수 있습니다.
동기화 대상의 상세 화면에서 매핑한 정보가 반영되었는지 확인합니다.

노드정보 동기화는 일치하는 기존 노드의 매핑된 정보만 갱신합니다. 새 노드를 생성하거나 기존 노드의 MAC 주소와 IPv4 주소를 변경하지 않습니다. MAC 주소만으로 식별할 때 같은 MAC 주소의 노드가 여러 개이면 함께 갱신될 수 있습니다.

주의

매핑한 원본 필드가 빈 값이면 기존 정보도 비워질 수 있습니다. 먼저 테스트 대상에서 결과를 확인한 뒤 정기 동기화를 사용하시기 바랍니다.