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

# Sage HR

> X-Auth-Token ヘッダーの API キーとアカウントのサブドメインを使用して Sage HR を Iru Compliance に接続し、従業員、休暇、チームディレクトリのエビデンスを収集します。

### Sage HR について

Iru は次の内容で **`https://YOUR_SUBDOMAIN.sage.hr/api`** を呼び出します:

```http theme={null}
X-Auth-Token: YOUR_API_KEY
```

キーは**管理者ごと**に発行され、そのユーザーの権限を継承します。API アクセスを無効にしてから再度有効にすると、キーが**ローテーション**されます。

### 仕組み

Sage HR の REST API は、**`X-Auth-Token`** ヘッダーで **API キー**を受け付けます。コネクタウィザードでは、まず**サブドメイン** (**`https://{subdomain}.sage.hr/api`** の構築に使用) を入力し、次のステップで **API キー**を入力します。

| 詳細 | 値 |
| - | - |
| **カテゴリ** | HRIS |
| **認証** | API キー (`X-Auth-Token`) |

公式リファレンス: [How the API works](https://support.sage.hr/en/articles/3246469-how-does-sage-hr-api-work)、[Sage developer HR](https://developer.sage.com/hr/reference/)。

### 前提条件

* **管理者** アクセス権。
* **サブドメイン** (`https://acme.sage.hr` の場合は `acme`)。

### Sage HR を Iru に接続する

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

    <Steps>
      <Step title="Sage HR にサインインする">
        Sage HR サイト (`https://YOUR_SUBDOMAIN.sage.hr`) を開き、**インテグレーション** の設定を変更できる **管理者** でサインインします。
      </Step>

      <Step title="プロフィールメニューを開く">
        Sage HR のヘッダーで **名前** (自分のプロフィール) を選択して、アカウントメニューを開きます。
      </Step>

      <Step title="設定を開く">
        **設定** (Sage HR のエディションによっては **Company settings**) を選択します。
      </Step>

      <Step title="インテグレーションと API を開く">
        **インテグレーション** に移動し、**API** を開きます (表記は **インテグレーション** → **API access** の場合もあります)。
      </Step>

      <Step title="API アクセスを有効にする">
        **Enable API Access** を切り替えるか選択し、データアクセスに関して Sage HR に表示されるプロンプトを確認します。
      </Step>

      <Step title="API キーをコピーする">
        Sage HR に表示される **API キー**をコピーし、安全に保管します。このキーは Iru で **`X-Auth-Token`** の値として使用します。
      </Step>
    </Steps>

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

  <Tab title="Iru Compliance">
    <Note>
      先に [**Sage HR**](#sage-hr) タブの手順を完了してください。
    </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="Sage HR をオンにする">
        **Sage HR** を見つけます (**カテゴリ** または **名前または説明で検索** を使用します)。そのカードで**トグル**をオンにします。コネクタウィザード用のブラウザタブまたはウィンドウが開く場合があります。
      </Step>

      <Step title="サブドメインを入力する">
        ウィザードで求められたら、**サブドメイン**を入力します。
      </Step>

      <Step title="API キーのヘッダー値を貼り付ける">
        プロンプトが表示されたら、**`X-Auth-Token`** の値を貼り付けます。
      </Step>

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

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