> ## Documentation Index
> Fetch the complete documentation index at: https://docs.iru.com/llms.txt
> Use this file to discover all available pages before exploring further.

# HiBob

> 서비스 사용자 ID와 토큰을 사용한 HTTP Basic Auth로 HiBob을 Iru Compliance에 연결하여 직원 명단, 수명 주기 이벤트 및 조직 구조 증거를 수집합니다.

### HiBob 정보

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

### 작동 방식

```http theme={null}
Authorization: Basic BASE64("SERVICE-USER-ID:TOKEN")
```

HiBob은 HTTPS를 통한 **HTTP Basic**을 사용하며, **사용자 이름**은 서비스 사용자의 **ID**, **비밀번호**는 해당 **토큰**입니다. 인코딩은 Iru가 처리하며, 두 값을 각각 붙여넣으면 됩니다. 요청 대상은 `https://api.hibob.com/v1`이며, 구성할 하위 도메인은 없습니다.

서비스 사용자 권한은 **세분화되어 있고 누적됩니다**. 각 데이터 범주는 권한 그룹을 통해 개별적으로 부여되며, 해당 범주가 부여되기 전까지 엔드포인트는 아무것도 반환하지 않습니다. HiBob은 **2024년 10월 31일에 API Access Token을 중단**했습니다. 고객이 구축하는 통합에서는 서비스 사용자만 지원됩니다.

| 항목 | 값 |
| - | - |
| **범주** | HRIS |
| **인증** | Basic(서비스 사용자 ID + 토큰) |

공식 참고 자료: [API service users](https://apidocs.hibob.com/docs/api-service-users), [Building the authorization header](https://apidocs.hibob.com/reference/authorization), [Permissions](https://apidocs.hibob.com/reference/permissions).

### 사전 요구 사항

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

### HiBob을 Iru에 연결

<Tabs>
  <Tab title="HiBob">
    <Note>
      Compliance에서 소스를 연결하기 전에 이 탭을 완료하세요.
    </Note>

    <Steps>
      <Step title="Bob에 로그인">
        **관리자**로 Bob에 로그인합니다.
      </Step>

      <Step title="Service Users 열기">
        **설정** → **통합** → **Service Users**로 이동합니다.
      </Step>

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

      <Step title="ID 및 토큰 복사">
        **서비스 사용자 ID**와 **토큰**을 즉시 복사합니다. 토큰은 **한 번만** 표시됩니다. 분실한 경우 서비스 사용자의 토큰을 새로 고치고 다시 연결하세요.
      </Step>

      <Step title="권한 그룹 할당">
        **권한 그룹**을 생성하거나 기존 그룹을 편집하여 새 서비스 사용자를 추가합니다.
      </Step>

      <Step title="읽기 권한 부여">
        컴플라이언스 프로그램에 필요한 범주에 대해 그룹에 **읽기** 권한을 부여합니다. 명단 및 퇴사 처리 증거에는 최소한 **People - Read**가 필요합니다. 쓰기 또는 삭제 권한은 부여하지 마세요. **Payroll - Read**는 컨트롤에 보상 데이터가 필요한 경우에만 부여하세요.
      </Step>
    </Steps>

    <Note>
      [**Iru Compliance**](#iru-compliance) 탭에서 계속 진행하세요.
    </Note>
  </Tab>

  <Tab title="Iru Compliance">
    <Note>
      먼저 [**HiBob**](#hibob) 탭을 완료하세요.
    </Note>

    <Steps>
      <Step title="소스 열기">
        Iru Compliance의 왼쪽 탐색 모음에서 **컴플라이언스**를 펼치고 **소스**를 선택합니다.

        <Frame>
          <img src="https://mintcdn.com/iru/tI0HDLDwHj8r9Ile/assets/media/images/iru-navigation-compliance-sources.png?fit=max&auto=format&n=tI0HDLDwHj8r9Ile&q=85&s=87dcef15fc17d2fb9a6e53f454e41710" alt="왼쪽 탐색: Compliance가 펼쳐지고 Sources가 선택됨" width="410" height="1024" data-path="assets/media/images/iru-navigation-compliance-sources.png" />
        </Frame>
      </Step>

      <Step title="HiBob 켜기">
        **HiBob**을 찾습니다(**범주** 또는 **이름 또는 설명으로 검색** 사용). 해당 카드에서 **토글**을 켭니다. 커넥터 마법사를 위한 브라우저 탭 또는 창이 열릴 수 있습니다.
      </Step>

      <Step title="Basic 인증 정보 입력">
        **사용자 이름**에는 **서비스 사용자 ID**를, **암호**에는 **서비스 사용자 토큰**을 입력합니다.
      </Step>

      <Step title="연결 완료">
        **자격 증명 제출**을 선택합니다. 연결에 성공하면 마법사에 **연결 구성됨**이 표시됩니다.
      </Step>

      <Step title="소스가 활성인지 확인">
        **Iru가 외부 서비스에 대한 액세스를 요청하고 있습니다** 브라우저 탭을 닫은 다음 **컴플라이언스** → **소스**로 돌아가 **HiBob** 카드가 **활성**인지 확인합니다.
      </Step>
    </Steps>
  </Tab>
</Tabs>

### 문제 해결

<AccordionGroup>
  <Accordion title="소스를 켜도 아무것도 열리지 않음">
    Iru 사이트에 대한 **팝업 차단** 설정을 확인한 후 다시 시도하세요.
  </Accordion>

  <Accordion title="tokenNotMatch로 인증 실패">
    ID와 토큰이 일치하지 않거나 토큰이 새로 고쳐졌습니다. HiBob에서 새 토큰을 생성하고 다시 연결하세요. 두 필드를 바꿔 입력하지 않았는지 확인하세요. **ID**가 사용자 이름입니다.
  </Accordion>

  <Accordion title="연결은 성공했지만 직원이 반환되지 않음">
    서비스 사용자가 **권한 그룹**에 속해 있지 않거나 그룹에 **People - Read**가 없습니다. 어느 경우든 인증은 정상적으로 통과하므로 가장 흔한 HiBob 설정 문제입니다.
  </Accordion>

  <Accordion title="이전 API Access Token을 사용하고 있음">
    이 토큰은 **2024년 10월 31일**부터 작동하지 않습니다. 서비스 사용자로 마이그레이션하세요.
  </Accordion>

  <Accordion title="퇴사한 직원이 누락됨">
    수집 대상에 비활성 레코드가 포함되어 있는지 확인하세요. 일부 엔드포인트에서 HiBob은 기본적으로 비활성 레코드를 제외합니다.
  </Accordion>
</AccordionGroup>

### 고려 사항

<CardGroup cols={2}>
  <Card title="권한 그룹이 필요합니다" icon="circle-info">
    서비스 사용자를 생성하는 것만으로는 충분하지 않습니다. **People - Read**가 포함된 **권한 그룹**이 없으면 인증은 성공하지만 직원이 반환되지 않습니다.
  </Card>
</CardGroup>

### 관련 문서

<CardGroup cols={2}>
  <Card title="Sources 관리" icon="plug" href="/ko/compliance/sources-management">
    모든 Compliance 소스를 찾아보고 관리합니다.
  </Card>

  <Card title="Compliance 시작하기" icon="rocket" href="/ko/compliance/getting-started-with-compliance">
    프레임워크, 작업 및 **아티팩트**.
  </Card>

  <Card title="Iru 개요" icon="layer-group" href="/ko/iru/platform-overview/iru-overview">
    Endpoint, Compliance 및 Identity가 함께 작동하는 방식.
  </Card>

  <Card title="Artifacts 관리" icon="folder-open" href="/ko/compliance/artifacts-management">
    소스 및 작업에서 수집한 증거를 업로드, 검토 및 정리합니다.
  </Card>
</CardGroup>