接続情報 - Freshservice

本ページでは、Freshserviceに接続するための設定（接続情報）について説明します。
転送に関する設定については、転送元 - Freshserviceを参照ください。

認証方式

• API Key

利用上の注意・制約

設定項目

Freshservice側で必要な作業

APIキーの取得

1. Freshserviceの管理画面にログインする。
2. 右側のメニューから「Profile Settings」をクリックする。
3. Profile画面の右側から「APIキー」を発行する。
4. 生成されたAPIキーをコピーして、TROCCOの接続情報設定で使用する。

権限の付与

転送元に利用する場合

Freshserviceからデータを取得するには、APIキーが以下のリソースにアクセスできる権限を持っている必要があります。

• Agents（エージェント）
• Requesters（リクエスター）
• Tickets（チケット）

APIキーは、生成したユーザーの権限に基づいてアクセス可能なリソースが決まる。必要に応じて、Freshservice上でユーザーに適切な権限を付与する。

困ったときには・トラブルシューティング

「認証に失敗しました」というエラーが表示される

考えられる原因

• APIキーが正しく入力されていない
• APIキーが無効化されている
• ホストURLが正しく入力されていない

対処方法

1. 接続情報の編集画面を開く。
2. APIキーが正しく入力されているか確認する。
3. ホストURLが正しい形式で入力されているか確認する（例：https://<domain>.freshservice.com）。
4. Freshservice管理画面でAPIキーが有効か確認する。
5. 必要に応じて、新しいAPIキーを生成し直す。

「403 Forbidden」エラーが発生する

考えられる原因

• APIキーに必要な権限が付与されていない
• アクセスしようとするリソースに対する権限がない
• API Rate Limitに達している

対処方法

1. Freshservice管理画面で、APIキーを生成したユーザーの権限を確認する。
2. 必要に応じて、ユーザーに適切な権限を付与する。
3. 権限の変更後、再度データ転送を試みる。
4. API Rate Limitが原因の場合は、レスポンスヘッダーのRetry-Afterに指定された秒数待ってから再試行してください。