> ## 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
> API キーをユーザー名とする HTTP Basic 認証を使用して BambooHR を Iru Compliance に接続し、従業員ディレクトリ、ステータス、オンボーディングのエビデンスを収集します。
### BambooHR について
BambooHR の REST API は **HTTPS** と **HTTP Basic** を使用します。**ユーザー名** = **API キー**、**パスワード** = リテラルの **`x`**（または BambooHR が無視する空でない任意の文字列）です。リクエストの宛先は **`https://YOUR_SUBDOMAIN.bamboohr.com/api/...`** です。Iru は最初に **`subdomain`** を保存し、次に認証情報を保存します。
### 仕組み
BambooHR の REST API は HTTPS 経由の **HTTP Basic** を使用します。**ユーザー名** = お客様の **API キー**、**パスワード** = リテラルの **`x`** です（BambooHR はパスワードフィールドが空でないことを求める以外、その値を無視します）。リクエストの宛先は **`https://{subdomain}.bamboohr.com/api/gateway.php/{subdomain}/v1/`** です。ウィザードでは最初に**サブドメイン**を入力し、次にキーを入力します。
| 項目 | 値 |
| - | - |
| **カテゴリ** | HRIS |
| **認証** | Basic（API キー + `x`） |
公式の参考資料: [はじめに](https://documentation.bamboohr.com/docs/getting-started)、[API リファレンス](https://documentation.bamboohr.com/reference)。
### 前提条件
* お客様の**サブドメイン**（`https://acme.bamboohr.com` の `acme`）。
* BambooHR のプロファイルで **API キー**を作成できること。
### BambooHR を Iru に接続する
Compliance でソースを接続する前に、このタブを完了してください。
API キーを管理できるアカウントで、会社のサブドメイン（例: `https://yourcompany.bamboohr.com`）にサインインします。
右上の**お客様の名前**（またはお客様のアカウントで BambooHR に表示されるプロファイルメニュー）を選択します。
**APIキー** を選択します（BambooHR のレイアウトによっては、**アカウント** または **My settings** の下にある場合があります）。
**Add a New Key**（または **Generate new key**）を選択します。このキーを何が使用しているかを担当者が把握できるように、**Iru Compliance** などのラベルを入力します。
キーを生成し、値を**すぐに**コピーします。BambooHR では、この値を Iru の HTTP Basic の**ユーザー名**として使用します。**パスワード**は、[**Iru Compliance**](#iru-compliance) タブで説明しているとおり、リテラルの **`x`** です。
[**Iru Compliance**](#iru-compliance) タブに進みます。
先に [**BambooHR**](#bamboohr) タブを完了してください。
Iru Compliance の左側のナビゲーションバーで **コンプライアンス** を展開し、**ソース** を選択します。
**BambooHR** を探します（**カテゴリ** または **名前または説明で検索** を使用します）。そのカードの**トグル**をオンにします。コネクタウィザード用のブラウザタブまたはウィンドウが開く場合があります。
**サブドメイン**のみを入力します（例: `acme`）。ウィザードにプレビュー URL が表示された場合は確認します。
**ユーザー名** = API キー、**パスワード** = **`x`**（リテラル）を入力します。
**資格情報を送信** を選択します。接続に成功すると、ウィザードに **接続が構成されました** と表示されます。
**Iru が外部サービスへのアクセスをリクエストしています** のブラウザタブを閉じてから **コンプライアンス** → **ソース** に戻り、**BambooHR** カードが **有効** になっていることを確認します。
### トラブルシューティング
Iru サイトの**ポップアップブロッカー**の設定を確認してから、もう一度お試しください。
API キー全体を入力してください。不明な場合は再生成してください。
**サブドメイン**を修正して再接続してください。
API は**ユーザーの権限**を継承します。必要に応じて、HR の権限を持つアカウントで接続してください。
### 関連記事
すべての Compliance ソースを参照・管理します。
フレームワーク、アクション、**アーティファクト**。
Endpoint、Compliance、Identity がどのように連携するか。
ソースやアクションから得たエビデンスをアップロード、確認、整理します。