--- title: "File Saferの概要" slug: "security-filesafer" updated: 2026-10-08T07:20:12Z published: 2026-10-08T07:20:12Z canonical: "api.ncloud-docs.com/security-filesafer" --- > ## Documentation Index > Fetch the complete documentation index at: https://api.ncloud-docs.com/llms.txt > Use this file to discover all available pages before exploring further. # File Saferの概要 Classic/VPC環境で利用できます。 File Saferは、ウェブを介して提供されるファイルとアウトリンクにマルウェアが含まれていないか検査する NAVERクラウドプラットフォームのサービスです。Fail Saferサービスでは、Hash Filter、File Filter機能に関する APIを RESTful形式で提供します。 ## File Safer共通設定 File Safer APIで共通して使用されるリクエスト形式とレスポンス形式を説明します。 ### リクエスト 共通リクエスト形式を説明します。 #### API URL リクエスト API URLは次の通りです。 ``` https://filesafer.apigw.ntruss.com ``` #### リクエストヘッダ リクエストヘッダの説明は次の通りです。 | フィールド | 必須の有無 | 説明 | | --- | --- | --- | | `x-ncp-apigw-timestamp` | Required | 1970年1月1日00:00:00協定世界時(UTC)からの経過時間(ミリ秒) - API Gatewayサーバとの時間差が5分以上の場合は無効なリクエストとみなす - Unix Timestamp形式 | | `x-ncp-iam-access-key` | Required | NAVERクラウドプラットフォームから発行された Access Key - Access Keyの発行と確認: [認証キーの作成](/docs/ja/common-ncpapi#1%EC%9D%B8%EC%A6%9D%ED%82%A4%EC%83%9D%EC%84%B1)を参照 - サブアカウントの Access Key発行と確認: [サブアカウントの作成](https://guide.ncloud-docs.com/docs/ja/subaccount-use#%EC%84%9C%EB%B8%8C-%EA%B3%84%EC%A0%95-%EC%83%9D%EC%84%B1)を参照 | | `x-ncp-apigw-signature-v2` | Required | NAVERクラウドプラットフォームから発行された Access Keyとマッピングする Secret Keyと HMAC暗号化アルゴリズム(HmacSHA256)でリクエスト情報を暗号化した後、Base64でエンコードした署名 - Secret Keyの発行と確認: [認証キーの作成](/docs/ja/common-ncpapi#1%EC%9D%B8%EC%A6%9D%ED%82%A4%EC%83%9D%EC%84%B1)を参照 - 署名の作成: [シグネチャーの作成](/docs/ja/common-ncpapi#%EC%8B%9C%EA%B7%B8%EB%8B%88%EC%B2%98%EC%83%9D%EC%84%B1)を参照 | | `Accept` | Required | レスポンスデータの形式`application/json` | ### レスポンス 共通レスポンス形式を説明します。 ### レスポンスステータスコード レスポンスステータスコードは次の通りです。 | HTTPステータスコード | コード | メッセージ | | --- | --- | --- | | 200 | 0 | success | | 200 | 140000 | Unknown Error | | 200 | 140001 | Parameter is invalid | | 200 | 140002 | Not existent user | | 200 | 140003 | Already in use | | 200 | 140004 | Not allowed user | | 200 | 140005 | Not existing the required parameter | | 200 | 140006 | invalid request | | 200 | 140007 | file size exceeds the limit | | 200 | 140009 | Input file has a problem | | 200 | 140010 | Unzip failed | | 400 | 100 | Bad Request Exception | | 401 | 200 | Authentication Failed | | 401 | 210 | Permission Denied | | 404 | 300 | Not Found Exception | | 429 | 400 | Quota Exceeded | | 429 | 410 | Throttle Limited | | 429 | 420 | Rate Limited | | 413 | 430 | Request Entity Too Large | | 503 | 500 | Endpoint Error | | 504 | 510 | Endpoint Timeout | | 500 | 900 | Unexpected Error | 参考 NAVERクラウドプラットフォームで共通して使用されるレスポンスステータスコードの詳細は、[Ncloud APIのレスポンスステータスコード](/docs/ja/common-ncpapi#3%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C)をご参照ください。 ## File Safer API File Saferサービスで提供する APIの説明は次の通りです。 ### Hash Filter Hash Filter関連の APIは次の通りです。 | API | 説明 | | --- | --- | | [checkHash](/docs/ja/security-filesafer-checkhash) | ファイルまたは URLストリングが悪性かどうかを確認 | | [getNotiConfig](/docs/ja/security-filesafer-getnoticonfig) | 分析結果の通知設定を照会 | | [getThresholdNotiConfig](/docs/ja/security-filesafer-getthresholdnoticonfig) | 分析結果通知の高度な設定を照会 | | [removeThresholdNotiConfig](/docs/ja/security-filesafer-removethresholdnoticonfig) | 分析結果通知の高度な設定を削除 | | [setNotiConfig](/docs/ja/security-filesafer-setnoticonfig) | 分析結果の通知設定 | | [setThresholdNotiConfig](/docs/ja/security-filesafer-setthresholdnoticonfig) | 分析結果通知の高度な設定 | ### File Filter File Filter関連の APIは次の通りです。 | API | 説明 | | --- | --- | | [getInputFileLog](/docs/ja/security-filesafer-getinputfilelog) | InputFile APIで転送したファイルの分析結果を照会 | | [getInputFileLogByParentHash](/docs/ja/getinputfilelogbyparenthash) | InputFile APIで転送した圧縮ファイル内ファイルの分析結果を照会 | | [getNotiConfig](/docs/ja/security-filesafer-getnoticonfig-2) | 分析結果の通知設定を照会 | | [getThresholdNotiConfig](/docs/ja/security-filesafer-getthresholdnoticonfig-2) | 分析結果通知の高度な設定を照会 | | [InputFile](/docs/ja/security-filesafer-inputfile) | File Filterで分析するのファイルを転送 | | [removeThresholdNotiConfig](/docs/ja/security-filesafer-removethresholdnoticonfig-2) | 分析結果通知の高度な設定を削除 | | [setNotiConfig](/docs/ja/security-filesafer-setnoticonfig-2) | 分析結果の通知設定 | | [setThresholdNotiConfig](/docs/ja/security-filesafer-setthresholdnoticonfig-2) | 分析結果通知の高度な設定 | ## File Safer関連リソース File Safer APIについてユーザーの理解に役立つよう、さまざまな関連リソースを提供しています。 - File Safer APIの使用方法 - [APIの概要](/docs/ja/common-ncpapi): NAVERクラウドプラットフォームから発行された Access Key、Secret Keyの発行と確認、リクエストヘッダに必要な署名の作成方法 - [Sub Accountご利用ガイド](https://guide.ncloud-docs.com/docs/ja/subaccount-overview): NAVERクラウドプラットフォームコンソールから発行されたサブアカウントの Access Key発行と確認方法 - [Ncloudの共通レスポンスステータスコード](/docs/ja/common-ncpapi#3%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C): File Saferで使用される NAVERクラウドプラットフォームの共通レスポンスステータスコード情報 - File Saferサービスの使用方法 - [File Saferご利用ガイド](https://guide.ncloud-docs.com/docs/ja/filesafer-overview): NAVERクラウドプラットフォームコンソールで File Saferサービスを使用する方法 - [Ncloud利用環境ガイド](https://guide.ncloud-docs.com/docs/ja/environment-environment-1-1): VPC、Classic環境およびサポートに関する利用ガイド - [料金の紹介、特長、詳細機能](https://www.ncloud.com/product/security/fileSafer): File Saferサービスの料金体系、特長、詳細機能のサマリー - [サービスの最新情報](https://www.ncloud.com/intro/news): File Saferサービスに関する最新情報 - [よくある質問](https://www.ncloud.com/support/faq/all): File Saferユーザーからよく寄せられる質問とその回答 - [お問い合わせ](https://www.ncloud.com/support/question/general): APIガイドだけでは不明な点が解消されない場合、直接問い合わせ