APIリクエストログ

[ログ] > [API リクエスト ログ]

⚠️ この機能はパッチを通じて**[ポリシー] > [連携システムポリシー]メニューに統合されました。
連動システムの登録、APIキーの発行、ポリシー設定を一箇所で管理できます。
APIリクエストログは[ログ] > [API リクエスト ログ]**で確認できます。

SHIELDEX FileのAPIアクセス制御機能は、連携システム単位で管理者ごとのアクセス権限を設定し、API呼び出し履歴を確認および管理できるようにサポートします。
管理者は連携システムを基準にAPIアクセス権限を細分化し、各権限別にAPIキーを発行したり、リクエストログを照会することができます。

⚠️ 'APIアクセス制御'設定権限は[管理者タイプ - 最上級管理者]にあります、
管理者権限の設定は [管理者] > [管理者リスト] で可能です。

---

▷ 連携システム登録

APIアクセス制御の基盤となる連携システムを登録します。

連動システム追加

+ 연동 시스템 추가ボタンをクリックすると、次の項目を入力します。

項目	説明
連動システム名	固有識別名 (例: FRD, OPS など)
ラベル	連動システムに関する説明または名称

連動システムを削除すると、関連するアクセス設定およびログがすべて削除され、復元できません。

削除案内

• 関連するアクセス制御設定が存在する場合、削除できません。
• 削除が確定すると、関連するすべてのデータが一緒に削除され、復元できません。

▷ アクセス制御設定

登録された連携システムに対してAPIアクセス権限を付与する管理者を指定し、APIキーを発行および管理します。

アクセス制御登録

+ 접근 제어 등록ボタンをクリックすると、次の項目が設定されます。

項目	説明
連動システム	選択可能な登録された連携システム
担当連携システム管理者	APIアクセス権が付与される管理者アカウント

• 登録が完了すると、API Keyが自動的に生成され、リストに表示されます。

表示項目

項目	説明
登録時間	アクセス権限が設定された日時
連動システム	アクセス制御対象連携システム
管理者 ID	アクセス権を持つ管理者アカウント
API Key	認証時に使用されるキー（外部露出注意）
措置	アクセス制御を解除できるボタンを提供

管理者の変更

• 담당 관리자 변경ボタンをクリックしてアクセス権を持つ管理者を変更できます。

アクセス制御解除

• 해제ボタンをクリックすると、該当するAPIキーおよびアクセスポリシーが削除されます。

▷ アクセス制御ログ

APIを通じて行われたリクエストの履歴を照会できます。各リクエストの記録は詳細な情報とともに提供され、フィルターおよびエクスポート機能をサポートしています。

ログ項目

項目	説明
API	リクエストタイプ (照会、ダウンロードなど)
顧客番号 / ユーザー管理番号	リクエスト主体識別子
連携システム名 / ラベル	リクエスト区分情報
リクエスト作業 ID	リクエストを追跡できるユニークID
ファイル相対パス	結果ファイル保存パス
ファイル名	処理されたファイル名
リクエスト時間 / IP	リクエスト発生時間およびクライアントIP
応答メッセージ	JSON形式の処理結果
応答コード	HTTP ステータスコード (例: 200, 403 など)

フィルター機能

• 日付範囲を指定して特定の期間のログを照会できます。
• リクエストタイプフィルター（全体、申請、照会、ダウンロード、許可、ブロックなど）を通じて区分されたログの確認が可能です。
• 顧客番号、ユーザー番号、連携システム名、ラベル、ファイル名など、さまざまな条件でフィルタリングできます。

エクスポート機能

• 左上내보내기ボタンをクリックすると、現在の照会条件に該当するログをCSVファイルとしてダウンロードできます。

CSVファイルは、監査ログの保管、レポート作成、システム連携エラーの追跡などの目的で活用できます。

参考事項

• 連動システムを活用して組織内のAPIアクセス権限を体系的に分離します。
• APIキーは外部に露出しないように管理し、必要に応じて即座に解除して再登録します。
• APIアクセスログは定期的にバックアップするか、エクスポート機能を通じて保管します。