--- title: "File Safer overview" slug: "security-filesafer" tags: ["File Safer"] updated: 2026-10-08T04:19:32Z published: 2026-10-08T04:19:32Z 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 overview Available in Classic and VPC File Safer is a NAVER Cloud Platform service that helps you scan files and outlinks served over the web for malicious code. The Fail Safer service provides APIs for the hash filter and file filter features in a RESTful format. ## Common File Safer settings The following describes commonly used request and response formats in File Safer APIs. ### Request The following describes the common request format: #### API URL The request API URL is as follows: ``` https://filesafer.apigw.ntruss.com ``` #### Request headers The following describes the request headers: | Field | Required | Description | | --- | --- | --- | | `x-ncp-apigw-timestamp` | Required | This is the number of milliseconds that have elapsed since January 1, 1970 00:00:00 UTC. - Request is considered invalid if the timestamp differs from the current time by more than 5 minutes. - Unix timestamp format. | | `x-ncp-iam-access-key` | Required | Access key issued from NAVER Cloud Platform - Issue or view access key: See [Create authentication key](/docs/en/common-ncpapi#1%EC%9D%B8%EC%A6%9D%ED%82%A4%EC%83%9D%EC%84%B1). - Issue or view access key for sub account: See [Create sub account](https://guide.ncloud-docs.com/docs/en/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 | Base64-encoded signature generated by encrypting the request information with the secret key mapped to the access key, using the HmacSHA256 algorithm - Issue and check secret key: See [Create authentication key](/docs/en/common-ncpapi#1%EC%9D%B8%EC%A6%9D%ED%82%A4%EC%83%9D%EC%84%B1). - Create signature: See [Create signature](/docs/en/common-ncpapi#%EC%8B%9C%EA%B7%B8%EB%8B%88%EC%B2%98%EC%83%9D%EC%84%B1). | | `Accept` | Required | Response data format`application/json` | ### Response The following describes the common response format: ### Response status codes The following describes response status codes. | HTTP status code | Code | Message | | --- | --- | --- | | 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 | Note For information about the response status codes common to NAVER Cloud Platform, see [Ncloud API response status codes](/docs/en/common-ncpapi#3%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C). ## File Safer API The following describes the APIs provided by the File Safer service. ### Hash Filter The APIs related to hash filter are as follows: | API | Description | | --- | --- | | [checkHash](/docs/en/security-filesafer-checkhash) | Determine if a file or URL string is malicious. | | [getNotiConfig](/docs/en/security-filesafer-getnoticonfig) | Get notification settings for analytics results. | | [getThresholdNotiConfig](/docs/en/security-filesafer-getthresholdnoticonfig) | Get advanced notification settings for analytics results. | | [removeThresholdNotiConfig](/docs/en/security-filesafer-removethresholdnoticonfig) | Delete advanced notification settings for analytics results. | | [setNotiConfig](/docs/en/security-filesafer-setnoticonfig) | Set up notifications for analytics results. | | [setThresholdNotiConfig](/docs/en/security-filesafer-setthresholdnoticonfig) | Set up advanced notifications for analytics results. | ### File Filter The APIs related to file filter are as follows: | API | Description | | --- | --- | | [getInputFileLog](/docs/en/security-filesafer-getinputfilelog) | Get analytics results for files sent with the InputFile API. | | [getInputFileLogByParentHash](/docs/en/getinputfilelogbyparenthash) | Get analysis results for files in a compressed file sent with the InputFile API. | | [getNotiConfig](/docs/en/security-filesafer-getnoticonfig-2) | Get notification settings for analytics results. | | [getThresholdNotiConfig](/docs/en/security-filesafer-getthresholdnoticonfig-2) | Get advanced notification settings for analytics results. | | [InputFile](/docs/en/security-filesafer-inputfile) | Send files to analyze with file filter. | | [removeThresholdNotiConfig](/docs/en/security-filesafer-removethresholdnoticonfig-2) | Delete advanced notification settings for analytics results. | | [setNotiConfig](/docs/en/security-filesafer-setnoticonfig-2) | Set up notifications for analytics results. | | [setThresholdNotiConfig](/docs/en/security-filesafer-setthresholdnoticonfig-2) | Set up advanced notifications for analytics results. | ## File Safer related resources NAVER Cloud Platform provides a variety of related resources to help users better understand File Safer APIs. - File Safer API guides - [API overview](/docs/en/common-ncpapi): Learn how to issue and view the access key and secret key from NAVER Cloud Platform, and how to create the signature required for request headers. - [Sub Account user guide](https://guide.ncloud-docs.com/docs/en/subaccount-overview): Learn how to issue and view access keys for sub accounts in NAVER Cloud Platform. - [Common Ncloud response status codes](/docs/en/common-ncpapi#3%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C): Information on common response status codes of NAVER Cloud Platform used by File Safer - How to use the File Safer service - [File Safer user guide](https://guide.ncloud-docs.com/docs/en/filesafer-overview): Learn how to use the File Safer service in the NAVER Cloud Platform console. - [Ncloud user environment guide](https://guide.ncloud-docs.com/docs/en/environment-environment-1-1): Explore VPC and Classic environments and supported services. - [Pricing and features](https://www.ncloud.com/product/security/fileSafer): View pricing details and key capabilities. - [Latest announcements](https://www.ncloud.com/intro/news): tay informed about File Safer service updates and news. - [FAQs](https://www.ncloud.com/support/faq/all): Get answers to common File Safer questions. - [Contact Us](https://www.ncloud.com/support/question/general): Send direct inquiries for unresolved questions that aren't answered by the API guide.