> ## 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.

# Workable

> スコープ付きの Bearer トークンとアカウントのサブドメインを使用して Workable を Iru Compliance に接続し、求人、候補者パイプライン、採用担当者のアクセス権に関するエビデンスを収集します。

### Workable について

Iru は **`Authorization: Bearer`** を使用して **`https://YOUR_SUBDOMAIN.workable.com/spi/v3`** を呼び出します。アクセストークンは**スコープ付き**で、**有効期限の設定が必須**です (**30 日**から **2 年**の間)。最小権限の原則に従い、**`r_jobs`**、**`r_candidates`** などの**読み取り**スコープのみを使用し、**書き込み**スコープは含めないでください。

### 仕組み

```http theme={null}
Authorization: Bearer YOUR_ACCESS_TOKEN
```

| 詳細 | 値 |
| - | - |
| **カテゴリ** | HRIS |
| **認証** | Bearer (スコープ付きアクセストークン) |

公式リファレンス: [Access tokens](https://help.workable.com/hc/en-us/articles/115015785428)、[API](https://help.workable.com/hc/en-us/articles/115013356548)、[REST reference](https://workable.readme.io/reference)。

### 前提条件

* **管理者** ロール (トークンを作成できるのは Admin のみです)。
* `https://YOUR_SUBDOMAIN.workable.com` の**サブドメイン**。

### Workable を Iru に接続する

<Tabs>
  <Tab title="Workable">
    <Note>
      Compliance でソースを接続する前に、このタブの手順を完了してください。
    </Note>

    <Steps>
      <Step title="Workable にサインインする">
        `https://YOUR_SUBDOMAIN.workable.com` を開き、**管理者** でサインインします (アクセストークンを作成できるのは Admin のみです)。
      </Step>

      <Step title="プロフィールメニューを開く">
        Workable のヘッダーで **Profile** (またはアバター) を選択します。
      </Step>

      <Step title="設定を開く">
        メニューから **設定** を選択します。
      </Step>

      <Step title="インテグレーションを開く">
        **Access Tokens** が表示されるまで、**インテグレーション** (Workable のエディションによっては **Developer** / **API**) を選択します。
      </Step>

      <Step title="新しいトークンを生成する">
        **Access Tokens** を開き、**Generate new token** を選択します。**Iru Compliance** などの名前を入力します。
      </Step>

      <Step title="有効期限と読み取りスコープを設定する">
        ローテーションポリシーに従って**有効期限**を設定します。コントロールに必要な**読み取り**スコープのみを有効にします (例: **`r_jobs`**、**`r_candidates`**)。
      </Step>

      <Step title="トークンを生成してコピーする">
        トークンを生成し、Workable に値が表示されたら**一度だけ**コピーします。**Bearer** トークンとして Iru に貼り付けるまで、安全に保管してください。
      </Step>
    </Steps>

    <Note>
      [**Iru Compliance**](#iru-compliance) タブに進みます。
    </Note>
  </Tab>

  <Tab title="Iru Compliance">
    <Note>
      先に [**Workable**](#workable) タブの手順を完了してください。
    </Note>

    <Steps>
      <Step title="ソースを開く">
        Iru Compliance の左側のナビゲーションバーで **コンプライアンス** を展開し、**ソース** を選択します。

        <Frame>
          <img src="https://mintcdn.com/iru/tI0HDLDwHj8r9Ile/assets/media/images/iru-navigation-compliance-sources.png?fit=max&auto=format&n=tI0HDLDwHj8r9Ile&q=85&s=87dcef15fc17d2fb9a6e53f454e41710" alt="左側のナビゲーション: Compliance を展開し、Sources を選択した状態" width="410" height="1024" data-path="assets/media/images/iru-navigation-compliance-sources.png" />
        </Frame>
      </Step>

      <Step title="Workable をオンにする">
        **Workable** を見つけます (**カテゴリ** または **名前または説明で検索** を使用します)。そのカードで**トグル**をオンにします。コネクタウィザード用のブラウザタブまたはウィンドウが開く場合があります。
      </Step>

      <Step title="サブドメインを入力する">
        完全な URL ではなく、**サブドメイン**のみを入力します (例: `mycompany`)。ウィザードにプレビューが表示された場合は、サーバー変数を確認します。
      </Step>

      <Step title="Bearer トークンを貼り付ける">
        プロンプトが表示されたら、**Bearer** トークンを貼り付けます。
      </Step>

      <Step title="接続を完了する">
        **Bearerトークンを送信** を選択します。接続に成功すると、ウィザードに **接続が構成されました** と表示されます。
      </Step>

      <Step title="ソースが有効であることを確認する">
        **Iru が外部サービスへのアクセスをリクエストしています** のブラウザタブを閉じてから **コンプライアンス** → **ソース** に戻り、**Workable** カードが **有効** であることを確認します。
      </Step>
    </Steps>
  </Tab>
</Tabs>

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

<AccordionGroup>
  <Accordion title="ソースをオンにしても何も開かない">
    Iru サイトの**ポップアップブロッカー**設定を確認して、もう一度お試しください。
  </Accordion>

  <Accordion title="401 Unauthorized">
    トークンの有効期限が切れています。ローテーションしてください。
  </Accordion>

  <Accordion title="データが空">
    不足している**読み取り**スコープを追加してください。新しいトークンが必要です。
  </Accordion>
</AccordionGroup>

### 関連記事

<CardGroup cols={2}>
  <Card title="ソース管理" icon="plug" href="/ja/compliance/sources-management">
    すべての Compliance ソースを参照および管理します。
  </Card>

  <Card title="Compliance の使用を開始する" icon="rocket" href="/ja/compliance/getting-started-with-compliance">
    フレームワーク、アクション、**アーティファクト**。
  </Card>

  <Card title="Iru の概要" icon="layer-group" href="/ja/iru/platform-overview/iru-overview">
    Endpoint、Compliance、Identity がどのように連携するか。
  </Card>

  <Card title="アーティファクト管理" icon="folder-open" href="/ja/compliance/artifacts-management">
    ソースとアクションから得たエビデンスをアップロード、確認、整理します。
  </Card>
</CardGroup>