> ## 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 から従業員レコードを取得し、[ディレクトリ](/ja/identity/directory/directory-overview)を同期し続けます。誰かが採用されたり、ロールが変わったり、退職したりすると、それらの更新は自動的に Iru に流れ込みます。構成するレポートはありません。Iru は BambooHR の標準従業員ディレクトリから直接読み取ります。

<Note>
  BambooHR 固有の手順のみを説明します。すべての同期接続に共通する概念 (一意の識別子、必須フィールド、IQL、各同期で行われること) については、[Directory Sync](/ja/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>

空になることがあるフィールドの安全なパターンを含むマッピングの詳細については、[データをマッピングする](/ja/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">
    2 つの点が異なります。Workday では Iru のフォームに Integration System User の資格情報を入力しますが、BambooHR では BambooHR にリダイレクトされてサインインし、アクセスを許可します。また、Workday にはカスタムレポートを Iru に指定する追加のステップがありますが、BambooHR は標準の従業員ディレクトリを読み取るため、承認からマッピングに直接進みます。それ以外 (一意の識別子、必須フィールド、IQL) はすべて同じように機能します。[Workday を接続する](/ja/identity/directory/hris-workday)を参照してください。
  </Accordion>
</AccordionGroup>

### 関連記事

<CardGroup cols={2}>
  <Card title="ディレクトリ同期" icon="building-user" href="/ja/identity/directory/directory-sync">
    すべての Directory Sync プロバイダーに共通する概念。
  </Card>

  <Card title="Workday を接続する" icon="briefcase" href="/ja/identity/directory/hris-workday">
    サポートされているもう 1 つの HR システム。レポートのステップが含まれます。
  </Card>
</CardGroup>
