Skip to main content

​
HiBob について

Iru は HiBob のパブリック API から、従業員名簿（ステータス、入社日、退職日を含む）、ライフサイクルイベント、部門とレポートライン、メタデータフィールド を読み取ります。認証には、設定 → インテグレーション → Service Users で作成した API サービスユーザー を使用します。サービスユーザーは従業員ではなく、Bob にサインインすることはできません。API リクエストの認証のためだけに存在します。

​
仕組み

HiBob は HTTPS 上で HTTP Basic を使用します。ユーザー名 はサービスユーザーの ID、パスワード はその トークン です。エンコードは Iru が処理します。2 つの値は別々に貼り付けます。リクエストの送信先は https://api.hibob.com/v1 で、構成するサブドメインはありません。 サービスユーザーの権限は 細分化されており、加算的 です。各データカテゴリは権限グループを通じて個別に付与され、カテゴリが付与されるまでエンドポイントは何も返しません。HiBob は 2024 年 10 月 31 日に API Access Token を廃止 しました。顧客が構築する連携でサポートされている方法は、サービスユーザーのみです。 公式リファレンス: API サービスユーザー、認可ヘッダーの作成、権限。

​
前提条件

  • Bob 管理者 アカウント、または代わりに認証情報を生成できる管理者。サービスユーザーを作成できるのは管理者のみです。
  • 権限グループ を作成し、サービスユーザーを割り当てられること。サービスユーザーを作成するだけでは不十分です。権限グループがない場合、認証は成功してもデータは返されません。

​
HiBob を Iru に接続する

Compliance でソースを接続する前に、このタブの手順を完了してください。
1

Bob にサインインする

管理者 として Bob にサインインします。
2

Service Users を開く

設定 → インテグレーション → Service Users に移動します。
3

サービスユーザーを作成する

新しいサービスユーザー を作成し、後で識別できるよう Iru Compliance などの名前を付けます。
4

ID とトークンをコピーする

サービスユーザー ID と トークン をすぐにコピーします。トークンは 一度だけ 表示されます。紛失した場合は、サービスユーザーのトークンを更新して再接続してください。
5

権限グループを割り当てる

権限グループ を作成（または既存のグループを編集）し、新しいサービスユーザーを追加します。
6

読み取り権限を付与する

コンプライアンスプログラムに必要なカテゴリの 読み取り 権限をグループに付与します。名簿とオフボーディングのエビデンスには、最低限 People - Read が必要です。書き込みや削除の権限は付与しないでください。Payroll - Read は、コントロールで報酬データが必要な場合にのみ付与してください。
Iru Compliance タブに進んでください。

​
トラブルシューティング

Iru サイトの ポップアップブロッカー の設定を確認して、もう一度お試しください。
ID とトークンが一致していないか、トークンが更新されています。HiBob で新しいトークンを生成して再接続してください。2 つのフィールドを入れ違えていないことを確認してください。ID がユーザー名です。
サービスユーザーが 権限グループ に所属していないか、グループに People - Read がありません。どちらの場合も認証は問題なく通過するため、これは HiBob のセットアップで最もよくある問題です。
これらは 2024 年 10 月 31 日 に機能しなくなりました。サービスユーザーに移行してください。
収集対象に非アクティブなレコードが含まれていることを確認してください。HiBob は一部のエンドポイントでデフォルトでそれらを除外します。

​
考慮事項

権限グループが必要

サービスユーザーを作成するだけでは不十分です。People - Read を含む 権限グループ がない場合、認証は成功しても従業員は返されません。

​
関連記事

Sources の管理

すべての Compliance ソースを参照、管理します。

Compliance を使い始める

フレームワーク、アクション、アーティファクト。

Iru の概要

Endpoint、Compliance、Identity がどのように連携するか。

Artifacts の管理

ソースやアクションから得たエビデンスをアップロード、確認、整理します。