> ## 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.

# BambooHR 연결

> BambooHR를 Iru Identity에 연결하여 표준 직원 디렉터리를 읽고 직원이 입사, 변경 또는 퇴사할 때 Iru 디렉터리를 동기화된 상태로 유지합니다.

### BambooHR 정보

**BambooHR**를 연결하면 Iru Identity가 BambooHR에서 직원 레코드를 가져와
[디렉터리](/ko/identity/directory/directory-overview)를 동기화된 상태로 유지할 수
있습니다. 누군가 채용되거나 역할이 변경되거나 퇴사하면 해당 업데이트가 자동으로 Iru에
반영됩니다. 구성할 보고서가 없습니다. Iru는 BambooHR의 표준 직원 디렉터리에서 직접
읽습니다.

<Note>
  BambooHR 관련 단계만 다룹니다. 모든 동기화 연결에 공통되는 개념(고유 식별자, 필수
  필드, IQL 및 각 동기화에서 일어나는 일)은
  [Directory Sync](/ko/identity/directory/directory-sync)를 참조하세요.
</Note>

### BambooHR를 Iru Identity에 연결

BambooHR에서 Iru를 승인한 다음 필드를 매핑합니다. Iru는 로그인하고 액세스를 허용할 수
있도록 BambooHR로 이동시킵니다. BambooHR 자격 증명은 Iru가 아닌 BambooHR로 전송됩니다.

<Steps>
  <Step title="디렉터리로 이동">
    왼쪽 탐색 모음(**Identity** 아래)에서 **디렉터리**로 이동합니다. **동기화** 탭을
    선택합니다.
  </Step>

  <Step title="Connect Source 선택">
    오른쪽 상단에서 **Connect Source**를 선택합니다.
  </Step>

  <Step title="BambooHR 선택">
    **BambooHR** 타일을 선택합니다.
  </Step>

  <Step title="연결 정보 입력">
    연결에 **표시 이름**과 선택 사항인 **설명**을 지정한 다음 BambooHR **회사 도메인**
    (BambooHR URL의 하위 도메인, 예: `acme.bamboohr.com`의 `acme`)을 입력합니다. Iru는
    도메인을 사용하여 승인을 위해 올바른 BambooHR 계정으로 이동시킵니다.

    <Frame>
      <img src="https://mintcdn.com/iru/ROP8FYcxO0yb2ZV8/assets/media/images/iru-identity-bamboo-configure.png?fit=max&auto=format&n=ROP8FYcxO0yb2ZV8&q=85&s=d517d91ccf786510d63054302355e2cf" alt="Display name, Description, Company domain 및 Next가 있는 Configure Bamboo 화면." width="2546" height="1584" data-path="assets/media/images/iru-identity-bamboo-configure.png" />
    </Frame>
  </Step>

  <Step title="다음 선택">
    **다음**을 선택합니다.
  </Step>

  <Step title="Connect 선택">
    **Connect with Bamboo** 화면에서 **Connect**를 선택합니다. Iru가 연결을 승인할 수
    있도록 **BambooHR 창**을 엽니다.

    <Frame>
      <img src="https://mintcdn.com/iru/ROP8FYcxO0yb2ZV8/assets/media/images/iru-identity-bamboo-connect.png?fit=max&auto=format&n=ROP8FYcxO0yb2ZV8&q=85&s=c52284a012dabe39a48fded0a02bbcf1" alt="Back, Cancel 및 Connect가 있는 Connect with Bamboo 화면." width="2544" height="1584" data-path="assets/media/images/iru-identity-bamboo-connect.png" />
    </Frame>
  </Step>

  <Step title="BambooHR에 로그인">
    **Email Address**와 **암호**를 입력한 다음 **Log In**을 선택합니다.
    **Log in with a Passkey**를 사용할 수도 있습니다. 자격 증명은 BambooHR로 전송되며 Iru는
    이를 볼 수 없습니다. 창이 열리지 않으면 브라우저의 팝업 차단기에서 Iru 사이트를
    확인한 다음 다시 시도하세요.

    <Frame>
      <img src="https://mintcdn.com/iru/ROP8FYcxO0yb2ZV8/assets/media/images/iru-identity-bamboo-authenticate.png?fit=max&auto=format&n=ROP8FYcxO0yb2ZV8&q=85&s=1a4a359adb1cad337295fe7c2f607a2a" alt="Email Address, Password, Log In 및 Log in with a Passkey가 있는 BambooHR 로그인 창." width="1344" height="1334" data-path="assets/media/images/iru-identity-bamboo-authenticate.png" />
    </Frame>

    <Tip>
      동기화하려는 모든 직원을 볼 수 있는 전용 관리자 또는 통합 계정으로 승인하여 특정
      사용자의 상태와 관계없이 연결이 계속 작동하도록 하세요.
    </Tip>
  </Step>

  <Step title="액세스 허용">
    **Share access with Iru Identity** 화면에서 BambooHR가 공유하는 데이터를 검토합니다:
    **OpenID Claims**, **Employee**, **Miscellaneous**, **Reports**이며 각각
    **Read only**입니다. **액세스 허용**을 선택하여 연결을 승인하거나 **Deny Access**를
    선택하여 취소합니다.

    BambooHR는 연결이 승인된 상태로 Iru로 돌아갑니다. 연결에는 **구성**,
    **매핑**, **Effective Users**, **동기화** 탭이 있습니다. Iru가 BambooHR에서 발급한
    승인을 보관하므로 생성하거나 저장할 API 키가 없습니다.

    <Note>
      **15분** 이내에 승인을 완료하세요. BambooHR 창이 만료되면 Iru로 돌아가 연결을
      다시 시작하세요.
    </Note>
  </Step>
</Steps>

### 데이터를 Iru에 매핑

BambooHR에는 **표준 직원 필드 집합**(이름과 성, 회사 및 개인 이메일, 전화번호, 직함,
부서, 상급자, 입사일, 주소 및 직원 ID)이 있으므로 Iru는 사용 가능한 항목을 이미 알고
매칭할 수 있도록 배치합니다. BambooHR 측에서 먼저 만들어야 할 것은 없습니다.

<Steps>
  <Step title="디렉터리로 이동">
    왼쪽 탐색 모음(**Identity** 아래)에서 **디렉터리**로 이동합니다. **동기화** 탭을
    선택합니다.
  </Step>

  <Step title="BambooHR 소스 선택">
    BambooHR 소스를 선택합니다.
  </Step>

  <Step title="Mapping 탭 선택">
    **매핑** 탭을 선택합니다.
  </Step>

  <Step title="고유 식별자 설정">
    고유 식별자를 선택합니다. 일반적으로 BambooHR **직원 ID**입니다. 연결을 저장한
    후에는 변경할 수 없습니다.
  </Step>

  <Step title="필수 속성 매핑">
    **email**, **first name**, **last name**, **username**을 매핑합니다. 나머지는 모두
    선택 사항입니다.
  </Step>

  <Step title="필요한 경우 IQL로 변환">
    필드를 선택하거나 짧은 IQL 표현식을 작성합니다. Iru는 사용 가능한 BambooHR 필드를
    제안하고 입력하는 동안 표현식을 검사합니다.

    BambooHR 필드를 사용한 예:

    * 회사 이메일에서 사용자 이름 생성: `workEmail.split("@")[0]`
    * 이름과 성 결합: `firstName + " " + lastName`
    * 회사 이메일을 우선 사용하고 개인 이메일로 대체: `optional.ofNonZeroValue(workEmail).orValue(homeEmail)`
  </Step>
</Steps>

가끔 비어 있는 필드에 대한 안전한 패턴을 포함하여 매핑에 대한 자세한 내용은
[데이터 매핑](/ko/identity/directory/directory-sync#map-your-data)을 참조하세요.

### 완료 및 활성화

<Steps>
  <Step title="매핑 저장">
    매핑을 저장합니다. 연결의 세부 정보 페이지로 이동합니다.
  </Step>

  <Step title="연결 활성화">
    모든 항목을 검토한 다음 오른쪽 상단의 **줄임표**를 선택하고 **사용**을
    선택합니다. 연결은 **비활성화** 상태로 시작되므로, 활성화하면 첫 번째 가져오기가
    시작되고 Iru가 동기화된 상태로 유지됩니다.
  </Step>
</Steps>

나중에 연결을 변경하거나 검토하려면 왼쪽 탐색 모음(**Identity** 아래)에서
**디렉터리**로 이동하여 **동기화** 탭을 선택한 다음 BambooHR 소스를 선택합니다.
**구성** 탭에서 Iru의 동기화 빈도를 설정하고, **매핑** 탭에서 매핑을
편집하고, **Effective Users** 탭에서 동기화된 사용자를 검토하거나, **동기화** 탭에서
**지금 동기화**를 실행하고 활동을 검토합니다. 승인이 만료되거나 취소된 경우
**구성** 탭에서 [재인증](#re-authenticate)하세요.

### 재인증

승인이 만료되거나 취소되면 연결에 **Needs re-authentication**이 표시됩니다.
**Connection details**에서 **다시 인증**을 사용한 다음 BambooHR에 로그인하고
다시 **액세스 허용**을 선택합니다. 매핑은 영향을 받지 않습니다.

<Frame>
  <img src="https://mintcdn.com/iru/60YZAZS1iNMrBv2w/assets/media/images/iru-identity-start-reauthentication-bamboo.png?fit=max&auto=format&n=60YZAZS1iNMrBv2w&q=85&s=a3415b8304ce762d249f68120a108691" alt="Needs re-authentication 및 다시 인증 작업이 표시된 Bamboo 연결의 Configuration 탭." width="2048" height="527" data-path="assets/media/images/iru-identity-start-reauthentication-bamboo.png" />
</Frame>

<Steps>
  <Step title="디렉터리로 이동">
    왼쪽 탐색 모음(**Identity** 아래)에서 **디렉터리**로 이동합니다. **동기화** 탭을
    선택합니다.
  </Step>

  <Step title="BambooHR 소스 선택">
    BambooHR 소스를 선택합니다.
  </Step>

  <Step title="구성 탭 선택">
    **구성** 탭을 선택한 다음 **다시 인증**을 선택합니다. Iru가
    **BambooHR 창**을 엽니다.
  </Step>

  <Step title="BambooHR에 로그인">
    **Email Address**와 **암호**를 입력한 다음 **Log In**을 선택합니다.
    **Log in with a Passkey**를 사용할 수도 있습니다.
  </Step>

  <Step title="액세스 허용">
    **Share access with Iru Identity** 화면에서 **액세스 허용**을 선택합니다.
    BambooHR는 연결이 승인된 상태로 Iru로 돌아갑니다.

    <Note>
      **15분** 이내에 승인을 완료하세요. BambooHR 창이 만료되면 Iru로 돌아가
      **다시 인증**을 다시 선택하세요.
    </Note>
  </Step>
</Steps>

### 고려 사항

<AccordionGroup>
  <Accordion title="Workday에서 전환하는 경우" icon="briefcase">
    두 가지가 다릅니다. Workday는 Iru 양식에서 Integration System User 자격 증명을
    받는 반면, BambooHR는 BambooHR로 이동하여 로그인하고 액세스를 허용하도록 합니다.
    또한 Workday에는 Iru가 사용자 지정 보고서를 가리키도록 하는 추가 단계가 있지만,
    BambooHR는 표준 직원 디렉터리를 읽으므로 승인에서 바로 매핑으로 넘어갑니다. 나머지
    (고유 식별자, 필수 필드 및 IQL)는 모두 동일하게 작동합니다.
    [Workday 연결](/ko/identity/directory/hris-workday)을 참조하세요.
  </Accordion>
</AccordionGroup>

### 관련 문서

<CardGroup cols={2}>
  <Card title="디렉터리 동기화" icon="building-user" href="/ko/identity/directory/directory-sync">
    모든 Directory Sync 공급자에 공통되는 개념입니다.
  </Card>

  <Card title="Workday 연결" icon="briefcase" href="/ko/identity/directory/hris-workday">
    지원되는 다른 HR 시스템입니다. 보고서 단계가 포함됩니다.
  </Card>
</CardGroup>