Skip to main content

​
Deel について

Iru は Deel API からワーカー、組織と法人の構造、休暇の記録を読み取ります。認証には、Deel ダッシュボードの Developer Center で作成した組織 API トークンを使用します。トークンは作成時にスコープが固定されます。コントロールに必要な読み取りスコープのみを付与してください。

​
仕組み

Deel は https://api.letsdeel.com/rest に対して Bearer トークンで認証します。設定するサブドメインはありません。 Deel には組織トークンと個人トークンがあります。個人トークンは作成した人に紐付いており、その人が退職すると期限切れになります。そのため、オフボーディング中も含め、予告なくエビデンスの収集が停止する可能性があります。組織トークンは個人に紐付いておらず、期限切れになりません。組織トークンを使用してください。 公式の参考資料: 認証、Deel API の使用方法。

​
前提条件

  • Deel の 組織管理者 または IT Developer Admin ロール。API トークンを生成できるのはこれらのロールのみです。
  • 付与するスコープを決めておきます。Deel のスコープは読み取り対象ごとに分かれているため、報酬データを公開することなく、名簿とオフボーディングのエビデンスを収集できます。

​
Deel を Iru に接続する

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

Deel にサインインする

組織管理者 または IT Developer Admin として Deel にサインインします。
2

Developer Center を開く

Apps & Integrations → Developer Center に移動します。
3

組織 API トークンを作成する

Create API Token を選択し、トークンの種類として 組織 を選択します。Personal は選択しないでください。個人トークンは所有者が退職すると期限切れになります。
4

トークンに名前を付ける

Iru Compliance などのトークン名を入力して続行します。
5

読み取り専用スコープを選択する

必要なエビデンスをカバーする読み取り専用スコープを選択します。ワーカーの名簿には people:read、法人と組織構造には organizations:read、コントロールが休暇の記録に依存する場合は time-off:read を選択します。payslips:read は、コントロールで給与データが必要な場合にのみ付与してください。
6

トークンを生成してコピーする

生成 を選択し、Deel に表示されている間にトークンの値を一度だけコピーします。
Iru Compliance タブに進みます。

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

Iru サイトのポップアップブロッカーの設定を確認してから、もう一度お試しください。
お客様の Deel のロールが 組織管理者 または IT Developer Admin ではありません。これらのロールのいずれかを持つユーザーにトークンの生成を依頼してください。
トークンが完全で取り消されていないことを確認し、コピー時に値が途中で切れていないことを確認してください。
トークンに対応する読み取りスコープがありません。Deel のスコープは作成時に固定されます。必要なスコープを指定して新しいトークンを生成してください。
個人トークンが使用されており、所有者の退職とともに期限切れになっています。組織トークンに置き換えてください。

​
考慮事項

組織トークンを使用する

個人トークンではなく、組織トークンを使用してください。個人トークンは所有者が退職すると期限切れになり、オフボーディング中にエビデンスの収集が停止する可能性があります。

​
関連記事

Sources の管理

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

Compliance の利用を開始する

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

Iru の概要

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

Artifacts の管理

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