사용자 동기화
사내 인사 DB나 API에 있는 사용자 정보를 aisight 계정에 정기적으로 반영하는 설정입니다. 소스를 고르고, 외부 컬럼과 aisight 내부 필드를 짝지은 뒤, 스케줄을 정해 실행합니다.
이 페이지 목차
위치: 사용자 화면 오른쪽 위의 동기화 버튼 (/admin/user-sync). 사이드바 메뉴에는 따로 없습니다.
화면 설명 문구는 이 기능을 이렇게 안내합니다. "외부 DB 테이블·REST API·Tableau 서버에서 사용자 정보를 정기 동기화. DB/REST 는 갱신 + 사라진 사용자 비활성화, Tableau 는 없는 사용자만 추가합니다."
DB 테이블과 REST API는 기존 사용자 정보를 갱신하고, 소스에서 사라진 사용자를 비활성화합니다. Tableau 서버는 aisight에 없는 사용자만 추가합니다.
화면 구성
- 1미리보기 · 저장 · 즉시 실행 설정을 미리 보고, 저장하고, 바로 실행합니다. 순서는 아래 '설정하고 실행하기'를 참고하세요.
- 2유형 DB 테이블 / REST API / Tableau 서버 중에서 고릅니다.
- 3데이터소스 가져올 데이터 소스를 선택합니다. 목록에는 등록된 모든 데이터 소스가 "이름 (종류)"로 나오며, 유형이 DB 테이블이어도 DB가 아닌 종류가 함께 보일 수 있으니 종류를 확인하고 고릅니다.
- 4활성화 스케줄대로 실행하려면 체크합니다.
- 5외부 컬럼/키 DB 테이블 유형에서는 외부 테이블의 컬럼 목록이 드롭다운으로 나옵니다.
- 6
- 7최근 실행 로그 실행이 잘 됐는지 확인할 때 봅니다. 열 구성은 아래 '최근 실행 로그'를 참고하세요.
식별 열은 라디오 버튼입니다. 기본으로 email → email 한 행이 식별자로 들어 있습니다. + 매핑 추가로 행을 늘리고 제거로 지웁니다. 예를 들어 이름 컬럼은 displayName에, 직책·부서 코드 컬럼은 해당 사용자 속성 key에 짝지을 수 있습니다.
내부 필드 orgCode는 소속과 관련된 필드이며, orgCode를 매핑하지 않고 쓰는 환경도 있습니다.
- 1트리거 무엇이 실행을 일으켰는지 구분합니다.
manual은 수동 실행입니다. - 2상태 실행이 성공했는지 확인합니다.
- 3총 / UPSERT 처리한 전체 건수와 upsert한 건수입니다.
- 4비활성 / 비활성 대기 / 비활성 무시 사라진 사용자를 비활성 처리한 건수와 관련 건수입니다.
- 5에러 / 메시지 실행이 실패했거나 일부 건이 반영되지 않았을 때 원인을 확인합니다.
쪽당 10건 / 20건 / 50건 / 100건 중에서 표시 건수를 고릅니다.
설정하고 실행하기
1. 소스를 고릅니다
유형을 고르고 데이터소스와 테이블을 지정합니다.
2. 매핑을 구성합니다
식별 행(기본 email → email)을 확인하고, 필요한 외부 컬럼을 내부 필드(displayName, disabled, orgCode)와 짝짓습니다.
3. 미리보기를 누릅니다
상단의 미리보기 버튼을 누릅니다.
4. 저장하고 실행합니다
저장으로 설정을 저장합니다. 스케줄을 비워 두었거나 바로 반영하려면 즉시 실행을 누릅니다. 스케줄을 쓰려면 활성화를 체크합니다.
실행 후 확인
- 화면 아래 최근 실행 로그에서 실행 결과를 확인합니다. 실행 기록이 없으면 "아직 실행 기록이 없습니다. "즉시 실행" 또는 cron 매칭 시 자동 실행됩니다."라고 표시됩니다.
관리자 > 운영 > 사용자목록에서 사용자 수와 상태가 기대와 맞는지 확인합니다.
DB 테이블·REST API 유형은 소스에서 사라진 사용자를 비활성화합니다. 실행 전에 소스와 매핑 설정을 다시 확인하세요.
마지막 수정: