> ## 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 認証を使用して 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 が処理します。2 つの値は別々に貼り付けます。リクエストの送信先は `https://api.hibob.com/v1` で、構成するサブドメインはありません。
サービスユーザーの権限は **細分化されており、加算的** です。各データカテゴリは権限グループを通じて個別に付与され、カテゴリが付与されるまでエンドポイントは何も返しません。HiBob は **2024 年 10 月 31 日に API Access Token を廃止** しました。顧客が構築する連携でサポートされている方法は、サービスユーザーのみです。
| 項目 | 値 |
| - | - |
| **カテゴリ** | HRIS |
| **認証** | Basic（サービスユーザー ID + トークン） |
公式リファレンス: [API サービスユーザー](https://apidocs.hibob.com/docs/api-service-users)、[認可ヘッダーの作成](https://apidocs.hibob.com/reference/authorization)、[権限](https://apidocs.hibob.com/reference/permissions)。
### 前提条件
* **Bob 管理者** アカウント、または代わりに認証情報を生成できる管理者。サービスユーザーを作成できるのは管理者のみです。
* **権限グループ** を作成し、サービスユーザーを割り当てられること。サービスユーザーを作成するだけでは不十分です。権限グループがない場合、認証は成功してもデータは返されません。
### HiBob を Iru に接続する
Compliance でソースを接続する前に、このタブの手順を完了してください。
**管理者** として Bob にサインインします。
**設定** → **インテグレーション** → **Service Users** に移動します。
**新しいサービスユーザー** を作成し、後で識別できるよう **Iru Compliance** などの名前を付けます。
**サービスユーザー ID** と **トークン** をすぐにコピーします。トークンは **一度だけ** 表示されます。紛失した場合は、サービスユーザーのトークンを更新して再接続してください。
**権限グループ** を作成（または既存のグループを編集）し、新しいサービスユーザーを追加します。
コンプライアンスプログラムに必要なカテゴリの **読み取り** 権限をグループに付与します。名簿とオフボーディングのエビデンスには、最低限 **People - Read** が必要です。書き込みや削除の権限は付与しないでください。**Payroll - Read** は、コントロールで報酬データが必要な場合にのみ付与してください。
[**Iru Compliance**](#iru-compliance) タブに進んでください。
先に [**HiBob**](#hibob) タブの手順を完了してください。
Iru Compliance の左側のナビゲーションバーで **コンプライアンス** を展開し、**ソース** を選択します。
**HiBob** を探します（**カテゴリ** または **名前または説明で検索** を使用します）。そのカードで **トグル** をオンにします。コネクタウィザード用のブラウザタブまたはウィンドウが開く場合があります。
**ユーザー名** に **サービスユーザー ID** を、**パスワード** に **サービスユーザーのトークン** を入力します。
**資格情報を送信** を選択します。接続に成功すると、ウィザードに **接続が構成されました** と表示されます。
**Iru が外部サービスへのアクセスをリクエストしています** のブラウザタブを閉じてから **コンプライアンス** → **ソース** に戻り、**HiBob** カードが **有効** になっていることを確認します。
### トラブルシューティング
Iru サイトの **ポップアップブロッカー** の設定を確認して、もう一度お試しください。
ID とトークンが一致していないか、トークンが更新されています。HiBob で新しいトークンを生成して再接続してください。2 つのフィールドを入れ違えていないことを確認してください。**ID** がユーザー名です。
サービスユーザーが **権限グループ** に所属していないか、グループに **People - Read** がありません。どちらの場合も認証は問題なく通過するため、これは HiBob のセットアップで最もよくある問題です。
これらは **2024 年 10 月 31 日** に機能しなくなりました。サービスユーザーに移行してください。
収集対象に非アクティブなレコードが含まれていることを確認してください。HiBob は一部のエンドポイントでデフォルトでそれらを除外します。
### 考慮事項
サービスユーザーを作成するだけでは不十分です。**People - Read** を含む **権限グループ** がない場合、認証は成功しても従業員は返されません。
### 関連記事
すべての Compliance ソースを参照、管理します。
フレームワーク、アクション、**アーティファクト**。
Endpoint、Compliance、Identity がどのように連携するか。
ソースやアクションから得たエビデンスをアップロード、確認、整理します。