> ## 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.
# Freshservice
> API キーをユーザー名とする HTTP Basic 認証を使用して Freshservice を Iru Compliance に接続し、変更承認、インシデント解決時間、チケット記録、CMDB の資産インベントリを収集します。
### Freshservice について
Iru は Freshservice API v2 から、**チケット**、**変更**（承認ステータスと実施日を含む）、**インシデント**、**問題**、**CMDB の資産**、**エージェントとそのロール** を読み取ります。認証には **Profile Settings** にある **API キー** を使用します。リクエストの送信先はアカウントのドメイン `https://YOUR_DOMAIN.freshservice.com/api/v2` です。コネクタウィザードでは、最初に **Basic 認証情報**、次に **ドメイン** を入力します。
### 仕組み
```http theme={null}
Authorization: Basic BASE64("YOUR_API_KEY:X")
```
Freshservice は HTTPS 上で **HTTP Basic** を使用します。**ユーザー名** は **API キー**、**パスワード** は空でない任意の文字列で、慣例として `X` という文字をそのまま使用します。エンコードは Iru が処理します。ユーザー名とパスワードによる Basic 認証は **2023 年 5 月 31 日に廃止** され、現在は失敗するため、API キーが唯一サポートされている方法です。
API キーは **キーを生成したエージェントの権限をそのまま** 持ち、エンドポイントごとのスコープはありません。権限が制限されたエージェントのキーでは、チケットや変更の一部しか取得できません。エビデンスを完全に保つため、管理者レベルの専用サービスアカウントを使用してください。
| 項目 | 値 |
| - | - |
| **カテゴリ** | サポート |
| **認証** | Basic（API キー + `X`） |
公式リファレンス: [API v2 リファレンス](https://api.freshservice.com/v2/)、[API キーの確認場所](https://support.freshservice.com/support/solutions/articles/50000000306-where-do-i-find-my-api-key-)。
### 前提条件
* **ドメイン**（`https://acme.freshservice.com` の `acme`）。
* キーを生成するための **管理者レベルのエージェントアカウント**。個人のエージェントアカウントを使用すると、エビデンスの収集が 1 人の権限に依存し、その人がオフボーディングされると機能しなくなります。
* 対象範囲を決定します。Freshservice では、チケットの種類を除外したり、資産インベントリをスキップしたり、部門でフィルタリングしたりできます。基となるデータが除外されている場合、Iru は影響を受けるコントロールを検証不可としてマークします。
### Freshservice を Iru に接続する
Compliance でソースを接続する前に、このタブの手順を完了してください。
連携に継承させる権限を持つ **管理者レベルのエージェント** として、`https://YOUR_DOMAIN.freshservice.com` にサインインします。
右上の **プロフィールアバター** を選択し、**Profile Settings** を選択します。
そのページで **Your API Key** を見つけてコピーします。Freshservice は毎回新しいキーを生成するのではなく、プロフィールページにキーを表示するため、後で再度確認することもできます。
Basic 認証の **パスワード** は `X` という文字そのものです。これは Freshservice ではなく Iru で入力します。
[**Iru Compliance**](#iru-compliance) タブに進んでください。
先に [**Freshservice**](#freshservice) タブの手順を完了してください。
Iru Compliance の左側のナビゲーションバーで **コンプライアンス** を展開し、**ソース** を選択します。
**Freshservice** を探します（**カテゴリ** または **名前または説明で検索** を使用します）。そのカードで **トグル** をオンにします。コネクタウィザード用のブラウザタブまたはウィンドウが開く場合があります。
ウィザードの最初のステップは **Enter Basic Authentication** です。**ユーザー名** に **API キー** を、**パスワード** に `X`（文字そのもの）を入力します。Freshservice はパスワードフィールドを検証しません。空でない任意のプレースホルダー値で機能します。
**資格情報を送信** を選択します。
**ドメイン** のみを入力します（例: `acme`。完全な URL ではありません）。ウィザードにプレビュー URL が表示された場合は確認します。接続に成功すると、ウィザードに **接続が構成されました** と表示されます。
**Iru が外部サービスへのアクセスをリクエストしています** のブラウザタブを閉じてから **コンプライアンス** → **ソース** に戻り、**Freshservice** カードが **有効** になっていることを確認します。
### トラブルシューティング
Iru サイトの **ポップアップブロッカー** の設定を確認して、もう一度お試しください。
API キーではなく、メールアドレスとパスワードが使用されています。この方法は 2023 年 5 月 31 日に削除されました。キーを **ユーザー名** として使用してください。
API キー全体を貼り付け、**パスワード** フィールドに `X` などの空でない値が入力されていることを確認してください。パスワードが空の場合は失敗します。
キーを生成したエージェントに、変更、資産、または問題に対する権限がありません。管理者レベルのエージェントでキーを再生成してください。
CMDB がこの接続の対象範囲外であるか、エージェントが資産を読み取れません。Iru はこれらのケースを区別できません。
**ドメイン** を修正して再接続してください。ドメインはサブドメインのみで、完全な URL ではありません。
### 関連記事
すべての Compliance ソースを参照、管理します。
CRM のエビデンスを得るために Freshsales を接続します。
フレームワーク、アクション、**アーティファクト**。
ソースやアクションから得たエビデンスをアップロード、確認、整理します。