HRIS 또는 디렉터리 솔루션을 연결하여 자동으로 동기화하거나 파일에서 사용자를 가져와 디렉터리를 최신 상태로 유지합니다.
조직 구성원에 대한 신뢰할 수 있는 정보 소스인 시스템에서
디렉터리를 채우고 최신 상태로 유지하세요.
두 가지 방법이 있습니다.
소스 시스템 연결
라이브 소스(Workday 또는 BambooHR와 같은 HRIS 또는 다른
디렉터리 솔루션)를 연결하면 Iru가 해당 소스에서 사용자를 가져와 일정에 따라
동기화하며, 사용자를 자동으로 생성, 업데이트 및 제거합니다. 더 많은 공급자가
추가될 예정입니다.
파일 가져오기(수동)
시스템용 직접 커넥터가 없습니까? 레거시 HR 시스템, 학생 정보 시스템(SIS) 또는
파일을 생성할 수 있는 모든 시스템에서 사용자를 CSV로 내보내고 업로드하세요.
목록이 변경될 때마다 업데이트된 내보내기 파일을 다시 업로드하여 사용자를 최신 상태로
유지합니다.
라이브 소스를 연결하면 업데이트가 자동으로 Iru에 반영되므로, 누군가 채용되거나 역할이
변경되거나 퇴사할 때 수동 작업 없이 디렉터리가 이를 따라갑니다. 이 가이드의 나머지
부분에서는 소스 시스템 연결을 다룹니다. 수동 방법은
CSV 가져오기를 참조하세요.현재 HR 시스템 Workday 및 BambooHR를 연결할 수 있으며, 다른 디렉터리 솔루션을
포함한 더 많은 공급자가 추가될 예정입니다. 설정은 각 공급자에 대해 동일한 안내 흐름이며
공급자별로 몇 단계만 다릅니다.
소스 시스템을 연결하려면 Iru 테넌트에 대한 관리자 액세스 권한과 해당 시스템의 관리자
계정이 필요합니다. 공급자에 따라 Iru에 통합 자격 증명을 입력하거나 공급자 자체 동의
창에서 Iru를 승인합니다. 연결은 소스에서 사용자를 읽기만 하며 소스에 다시 쓰지
않습니다.
연결에 표시 이름(및 선택 사항인 설명)을 지정한 다음 Iru에 공급자에 대한 읽기
액세스 권한을 부여합니다. 방법은 공급자에 따라 다릅니다.
Workday: Iru에 인스턴스 호스트, Workday 테넌트, Integration System User 및
비밀번호를 입력합니다.
BambooHR: Iru에 회사 도메인을 입력한 다음 BambooHR 창에서 승인합니다.
BambooHR에 로그인하고 Share access with Iru Identity 화면에서 액세스 허용을
선택합니다. BambooHR 자격 증명은 Iru가 아닌 BambooHR로 전송되며 입력할 API 키가
없습니다. 15분 이내에 승인을 완료하거나, Iru로 돌아가 연결을 다시 시작하세요.
Workday 연결: Iru에 입력된 Integration System User 자격 증명.
가능하면 전용 관리자/통합 계정을 사용하여 특정 사용자의 상태와 관계없이 연결이
계속 작동하도록 하세요.
3
데이터 위치 구성(일부 공급자)
일부 공급자는 Iru가 올바른 데이터 소스를 가리키도록 해야 합니다. Workday는
원하는 작업자 필드를 노출하는 보고서 이름을 요청하며, 이전 단계의 Integration
System User가 해당 보고서를 실행합니다. BambooHR는 표준 직원 디렉터리를 읽으므로
이 단계를 건너뜁니다. 아래 공급자 가이드를 참조하세요.
4
데이터를 Iru에 매핑
Iru는 공급자가 제공하는 필드를 읽고 매칭할 수 있도록 배치합니다. 아래
데이터 매핑을 참조하세요.
5
완료 및 활성화
매핑을 저장하여 설정을 완료합니다. 새 연결은 비활성화 상태로 시작되므로 검토하기
전까지는 아무것도 동기화되지 않습니다. 그런 다음 사용하여 첫 번째 가져오기를
실행합니다. 연결의 Configuration 탭에서 동기화 간격을 설정하거나, Manual only로
두고 업데이트가 필요할 때 지금 동기화를 사용하세요.
대부분의 필드는 간단히 선택하면 됩니다. 원하는 값을 그대로 복사하지 않고 필드에서
구성해야 하는 경우 짧은 IQL 표현식을 작성하세요. 입력하는 동안 Iru는 사용 가능한
필드를 제안하고 표현식을 검사하므로, 동기화 중이 아니라 저장하기 전에 오타나 누락된
필드를 찾을 수 있습니다. 전체 구문은
속성 매핑 및
IQL 표현식을 참조하세요.
IQL은 필드 이름을 코드로 읽습니다. 그대로 쓴 이름은 유효한 IQL 식별자일 때 작동합니다.
유효한 식별자는 ASCII 문자 또는 밑줄로 시작하고 이후의 모든 문자는 ASCII 문자, 숫자 또는
밑줄입니다. first_name은 이에 해당하므로 그대로 작성합니다. 점은 name.givenName처럼
유효한 이름을 연결하여 중첩된 값에 접근합니다. 이름 자체에 점이 포함된 필드는 하나의
키이므로 __source["name.givenName"]으로 조회합니다.일부 소스 시스템은 이 규칙을 벗어나는 이름을 보냅니다.
Email - Work 또는
urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:department처럼 공백, 하이픈,
콜론 또는 기타 기호가 포함된 이름
in, null, true, if처럼 IQL 키워드이기도 한 이름
그대로 쓰면 Email - Work는 Email 빼기 Work로 읽히고, in은 멤버십 연산자로
읽힙니다. 필드를 읽으려면 소스의 모든 필드에 대한 맵인 __source에서 정확한 이름으로
조회하세요.
__source["Email - Work"]
매핑 편집기에서 이러한 필드 중 하나를 선택하거나 입력하면 Iru가 이를
__source["…"]로 다시 작성합니다. 이 형식은 모든 필드에 사용할 수 있으며, 다른 값과
마찬가지로 더 긴 표현식 안에서도 작동합니다.
__source["Email - Work"].lowerAscii()
필드 이름에 큰따옴표(") 또는 백슬래시(\)가 포함된 경우 괄호 안에서 각 문자 앞에
백슬래시를 넣으세요. Title "Legal"이라는 필드는 __source["Title \"Legal\""]로
작성합니다. 편집기는 필드를 다시 작성할 때 이러한 백슬래시를 추가합니다.일반적인 예(공급자 자체의 필드 이름을 사용하세요):
이메일에서 사용자 이름 생성(@ 앞의 모든 문자):
email.split("@")[0]
두 필드를 하나의 값으로 결합:
firstName + " " + lastName
첫 번째 필드가 비어 있을 때 한 필드를 우선 사용하고 다른 필드로 대체:
optional.ofNonZeroValue(workEmail).orValue(homeEmail)
비어 있을 수 있는 텍스트 필드를 변환할 때는 표현식이 계속 실행되도록 값을 보호하세요. 변환하기 전에 optional.ofNonZeroValue(...).orValue("")로 감쌉니다. 예를 들어 이메일이 있는 경우에만 사용자 이름을 도출합니다:
optional.ofNonZeroValue(email).orValue("").split("@")[0]Boolean, Date, Integer 또는 Decimal 사용자 지정 속성에 대해 비어 있거나 null인 매핑 값은 동기화를 실패시키지 않습니다. 기존 값을 지웁니다. 비어 있는 매핑 값을 참조하세요.
연결의 구성 탭에서 Interval 컨트롤로 Sync frequency를 설정합니다.
Iru가 최신 디렉터리를 가져오는 빈도를 선택하거나, Manual only로 설정하여 요청 시
동기화합니다.사용 가능한 간격:
Manual only(자동 동기화 없음)
30분마다
1시간마다
2시간마다
4시간마다
8시간마다
12시간마다
매일
2일마다
매주
Iru가 연결을 동기화하는 빈도 선택.
동기화 탭에서 지금 동기화를 사용하여 즉시 실행을 시작하고, Refresh를 사용하여
동기화 실행 목록을 다시 불러옵니다. 각 실행은 디렉터리 소스에서 모든 사용자를 읽고
Iru에 추가하거나 업데이트합니다. 실행을 선택하면 수행된 작업과 동기화할 수 없었던
항목을 확인할 수 있습니다. 실패한 실행은 다음 예약된 동기화에서 다시 시도됩니다.
재인증: 연결이 만료되거나 거부된 경우 매핑을 변경하지 않고 새 자격 증명을
제출하거나 공급자에서 다시 액세스를 승인합니다.
구성 또는 매핑 편집: 요구 사항이 변화함에 따라 가져오는 항목을 조정합니다.
동기화 간격 설정 또는 지금 동기화 실행.
속성 강제 동기화(Workday): 기다리지 않고 보고서에서 사용 가능한 최신 필드를 다시
읽습니다.
활동, 유효 사용자 및 동기화 오류 검토: 유입되는 내용을 확인하고 주의가 필요한
항목을 찾습니다.
연결을 활성화 또는 비활성화하거나 제거합니다.
연결의 세부 정보 페이지: 상태, 연결 상태 및 다시 인증.
연결 상태 및 재인증
Directory → Sync 목록에서 각 연결은 Enabled 또는 Disabled 여부와 연결
상태 값을 표시합니다.
상태
의미
연결됨
Iru가 소스에서 읽을 수 있도록 승인되었습니다.
Needs re-authentication
자격 증명 또는 공급자 승인이 누락, 만료, 취소 또는 거부되었습니다. 동기화가 성공하려면 먼저 재인증하세요.
Not connected
연결이 인증할 준비가 되지 않았습니다(예: 설정이 완료되지 않음).
연결의 구성 탭에서 Connection details는 해당 공급자에 대한 동일한
상태를 표시합니다. 다시 인증을 사용하여 현재 자격 증명을 입력하거나
공급자에서 다시 액세스를 승인하세요. 속성 매핑은 영향을 받지 않습니다.
BambooHR: Iru가 여는 창에서 BambooHR에 다시 로그인한 다음
액세스 허용을 선택합니다.
Workday: Integration user와 비밀번호를 다시 입력합니다.
현재 Integration System User 자격 증명으로 Workday 재인증.
동기화 오류
동기화 문제는 두 단계에서 나타납니다. 어느 단계가 실패했는지 알면 먼저 확인할
곳을 알 수 있습니다.
가져오기 단계 오류는 Iru가 소스에서 읽을 수 없을 때 발생합니다. 잘못되었거나
만료된 자격 증명, 만료되거나 취소된 공급자 승인, 연결할 수 없는 인스턴스, 누락된
보고서 또는 거부된 API 호출 등이 원인입니다. 연결을 수정한 다음(주로
다시 인증을 사용하거나 보고서 또는 도메인 설정을 수정) 동기화를 다시
실행하세요.
적용 단계(동기화) 오류는 Iru가 레코드를 가져온 후 디렉터리에서 특정 사용자를
생성하거나 업데이트할 수 없을 때 발생합니다. Iru는 검토할 수 있는 동기화
오류를 기록합니다. 발생 시간, 영향을 받은 사용자, Iru가 시도한 작업, 오류 코드
및 메시지가 포함됩니다. 많은 레코드가 동일한 오류로 실패하는 경우 원인은 보통
매핑입니다. 필수 속성이 매핑되지 않았거나 고유 식별자가 실제로 고유하지 않은
경우입니다. 매핑을 수정한 다음 다음 동기화가 실행되도록 하세요.
Activity 탭의 실패한 동기화와 전체 오류 세부 정보. 여기서는 필수 속성이 누락되어 레코드가 거부되었습니다.
