> ## 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.
# Deel
> スコープ付きの組織 API トークンを使用して Deel を Iru Compliance に接続し、オンボーディングとオフボーディングのエビデンスとして、ワーカーの名簿、組織構造、休暇の記録を収集します。
### Deel について
Iru は Deel API から**ワーカー**、**組織と法人の構造**、**休暇の記録**を読み取ります。認証には、Deel ダッシュボードの **Developer Center** で作成した**組織 API トークン**を使用します。トークンは作成時に**スコープが固定**されます。コントロールに必要な**読み取り**スコープのみを付与してください。
### 仕組み
```http theme={null}
Authorization: Bearer YOUR_API_TOKEN
```
Deel は `https://api.letsdeel.com/rest` に対して **Bearer** トークンで認証します。設定するサブドメインはありません。
Deel には**組織**トークンと**個人**トークンがあります。**個人トークン**は作成した人に紐付いており、**その人が退職すると期限切れになります**。そのため、オフボーディング中も含め、予告なくエビデンスの収集が停止する可能性があります。**組織トークン**は個人に紐付いておらず、期限切れになりません。組織トークンを使用してください。
| 項目 | 値 |
| - | - |
| **カテゴリ** | HRIS |
| **認証** | Bearer（組織 API トークン） |
公式の参考資料: [認証](https://developer.deel.com/api/authentication)、[Deel API の使用方法](https://help.letsdeel.com/hc/en-gb/articles/8801712601233-How-To-Use-Deel-API)。
### 前提条件
* Deel の **組織管理者** または **IT Developer Admin** ロール。API トークンを生成できるのはこれらのロールのみです。
* 付与するスコープを決めておきます。Deel のスコープは読み取り対象ごとに分かれているため、報酬データを公開することなく、名簿とオフボーディングのエビデンスを収集できます。
### Deel を Iru に接続する
Compliance でソースを接続する前に、このタブを完了してください。
**組織管理者** または **IT Developer Admin** として Deel にサインインします。
**Apps & Integrations** → **Developer Center** に移動します。
**Create API Token** を選択し、トークンの種類として **組織** を選択します。**Personal** は選択しないでください。個人トークンは所有者が退職すると期限切れになります。
**Iru Compliance** などのトークン名を入力して続行します。
必要なエビデンスをカバーする**読み取り専用**スコープを選択します。ワーカーの名簿には `people:read`、法人と組織構造には `organizations:read`、コントロールが休暇の記録に依存する場合は `time-off:read` を選択します。`payslips:read` は、コントロールで給与データが必要な場合にのみ付与してください。
**生成** を選択し、Deel に表示されている間にトークンの値を**一度だけ**コピーします。
[**Iru Compliance**](#iru-compliance) タブに進みます。
先に [**Deel**](#deel) タブを完了してください。
Iru Compliance の左側のナビゲーションバーで **コンプライアンス** を展開し、**ソース** を選択します。
**Deel** を探します（**カテゴリ** または **名前または説明で検索** を使用します）。そのカードの**トグル**をオンにします。コネクタウィザード用のブラウザタブまたはウィンドウが開く場合があります。
トークンを **Bearer** フィールドに貼り付けます。
**Bearerトークンを送信** を選択します。接続に成功すると、ウィザードに **接続が構成されました** と表示されます。
**Iru が外部サービスへのアクセスをリクエストしています** のブラウザタブを閉じてから **コンプライアンス** → **ソース** に戻り、**Deel** カードが **有効** になっていることを確認します。
### トラブルシューティング
Iru サイトの**ポップアップブロッカー**の設定を確認してから、もう一度お試しください。
お客様の Deel のロールが **組織管理者** または **IT Developer Admin** ではありません。これらのロールのいずれかを持つユーザーにトークンの生成を依頼してください。
トークンが完全で取り消されていないことを確認し、コピー時に値が途中で切れていないことを確認してください。
トークンに対応する読み取りスコープがありません。Deel のスコープは作成時に固定されます。必要なスコープを指定して新しいトークンを生成してください。
**個人**トークンが使用されており、所有者の退職とともに期限切れになっています。**組織**トークンに置き換えてください。
### 考慮事項
**個人**トークンではなく、**組織**トークンを使用してください。個人トークンは所有者が退職すると期限切れになり、オフボーディング中にエビデンスの収集が停止する可能性があります。
### 関連記事
すべての Compliance ソースを参照・管理します。
フレームワーク、アクション、**アーティファクト**。
Endpoint、Compliance、Identity がどのように連携するか。
ソースやアクションから得たエビデンスをアップロード、確認、整理します。