Skip to main content

​
HiBob 정보

Iru는 HiBob의 공개 API에서 직원 명단(상태, 시작일 및 종료일 포함), 수명 주기 이벤트, 부서 및 보고 체계, 메타데이터 필드를 읽습니다. 인증에는 설정 → 통합 → Service Users에서 생성한 API 서비스 사용자를 사용합니다. 서비스 사용자는 직원이 아니며 Bob에 로그인할 수 없습니다. API 요청 인증용으로만 존재합니다.

​
작동 방식

HiBob은 HTTPS를 통한 HTTP Basic을 사용하며, 사용자 이름은 서비스 사용자의 ID, 비밀번호는 해당 토큰입니다. 인코딩은 Iru가 처리하며, 두 값을 각각 붙여넣으면 됩니다. 요청 대상은 https://api.hibob.com/v1이며, 구성할 하위 도메인은 없습니다. 서비스 사용자 권한은 세분화되어 있고 누적됩니다. 각 데이터 범주는 권한 그룹을 통해 개별적으로 부여되며, 해당 범주가 부여되기 전까지 엔드포인트는 아무것도 반환하지 않습니다. HiBob은 2024년 10월 31일에 API Access Token을 중단했습니다. 고객이 구축하는 통합에서는 서비스 사용자만 지원됩니다. 공식 참고 자료: API service users, Building the authorization header, Permissions.

​
사전 요구 사항

  • Bob 관리자 계정 또는 자격 증명을 대신 생성해 줄 수 있는 관리자. 서비스 사용자는 관리자만 생성할 수 있습니다.
  • 권한 그룹을 생성하고 서비스 사용자를 할당할 수 있는 권한. 서비스 사용자를 생성하는 것만으로는 충분하지 않습니다. 권한 그룹이 없으면 인증은 성공하지만 데이터가 반환되지 않습니다.

​
HiBob을 Iru에 연결

Compliance에서 소스를 연결하기 전에 이 탭을 완료하세요.
1

Bob에 로그인

관리자로 Bob에 로그인합니다.
2

Service Users 열기

설정 → 통합 → Service Users로 이동합니다.
3

서비스 사용자 생성

새 서비스 사용자를 생성하고 나중에 식별할 수 있도록 Iru Compliance와 같은 이름을 지정합니다.
4

ID 및 토큰 복사

서비스 사용자 ID와 토큰을 즉시 복사합니다. 토큰은 한 번만 표시됩니다. 분실한 경우 서비스 사용자의 토큰을 새로 고치고 다시 연결하세요.
5

권한 그룹 할당

권한 그룹을 생성하거나 기존 그룹을 편집하여 새 서비스 사용자를 추가합니다.
6

읽기 권한 부여

컴플라이언스 프로그램에 필요한 범주에 대해 그룹에 읽기 권한을 부여합니다. 명단 및 퇴사 처리 증거에는 최소한 People - Read가 필요합니다. 쓰기 또는 삭제 권한은 부여하지 마세요. Payroll - Read는 컨트롤에 보상 데이터가 필요한 경우에만 부여하세요.
Iru Compliance 탭에서 계속 진행하세요.

​
문제 해결

Iru 사이트에 대한 팝업 차단 설정을 확인한 후 다시 시도하세요.
ID와 토큰이 일치하지 않거나 토큰이 새로 고쳐졌습니다. HiBob에서 새 토큰을 생성하고 다시 연결하세요. 두 필드를 바꿔 입력하지 않았는지 확인하세요. ID가 사용자 이름입니다.
서비스 사용자가 권한 그룹에 속해 있지 않거나 그룹에 People - Read가 없습니다. 어느 경우든 인증은 정상적으로 통과하므로 가장 흔한 HiBob 설정 문제입니다.
이 토큰은 2024년 10월 31일부터 작동하지 않습니다. 서비스 사용자로 마이그레이션하세요.
수집 대상에 비활성 레코드가 포함되어 있는지 확인하세요. 일부 엔드포인트에서 HiBob은 기본적으로 비활성 레코드를 제외합니다.

​
고려 사항

권한 그룹이 필요합니다

서비스 사용자를 생성하는 것만으로는 충분하지 않습니다. People - Read가 포함된 권한 그룹이 없으면 인증은 성공하지만 직원이 반환되지 않습니다.

​
관련 문서

Sources 관리

모든 Compliance 소스를 찾아보고 관리합니다.

Compliance 시작하기

프레임워크, 작업 및 아티팩트.

Iru 개요

Endpoint, Compliance 및 Identity가 함께 작동하는 방식.

Artifacts 관리

소스 및 작업에서 수집한 증거를 업로드, 검토 및 정리합니다.