MENU
      File Safer 개요

        File Safer 개요


        기사 요약

        Classic/VPC 환경에서 이용 가능합니다.

        File Safer는 웹을 통해 제공되는 파일과 아웃링크의 악성 코드 포함 여부를 검사할 수 있도록 돕는 네이버 클라우드 플랫폼의 서비스입니다. Fail Safer 서비스에서는 Hash Filter, File Filter 기능에 대한 API를 RETSTful 형태로 제공합니다.

        File Safer 공통 설정

        File Safer API에서 공통으로 사용하는 요청 형식과 응답 형식을 설명합니다.

        요청

        공통 요청 형식을 설명합니다.

        API URL

        요청 API URL은 다음과 같습니다.

        Hash Filter: https://filesafer.apigw.ntruss.com/hashfilter/v1
        File Filter: https://filesafer.apigw.ntruss.com/filefilter/v1
        HTTP

        요청 헤더

        요청 헤더에 대한 설명은 다음과 같습니다.

        필드필수 여부설명
        x-ncp-apigw-timestampRequired1970년 1월 1일 00:00:00 협정 세계시(UTC)부터의 경과 시간 (밀리초)
      • API Gateway 서버와 5분 이상 시간차 발생 시 유효하지 않은 요청으로 간주
      • x-ncp-apigw-api-keyRequired네이버 클라우드 플랫폼의 API Gateway에서 발급받은 API Key
        x-ncp-iam-access-keyRequired네이버 클라우드 플랫폼에서 발급받은 Access Key
      • Access Key 발급 및 확인: 인증키 생성 참조
      • 서브 계정의 Access Key 발급 및 확인: 서브 계정 생성 참조
      • x-ncp-apigw-signature-v2Required네이버 클라우드 플랫폼에서 발급받은 Access Key에 맵핑되는 Secret Key 및 HMAC 암호화 알고리즘(HmacSHA256)으로 요청 정보를 암호화한 후 Base64로 인코딩한 서명
      • Secret Key 발급 및 확인: 인증키 생성 참조
      • 서명 생성: 시그니처 생성 참조
      • AcceptRequired응답 데이터의 형식
      • application/json
      • 응답

        공통 응답 형식을 설명합니다.

        응답 상태 코드

        응답 상태 코드는 다음과 같습니다.

        HTTP 상태 코드코드메시지
        2000success
        200140000Unknown Error
        200140001Parameter is invalid
        200140002Not existent user
        200140003Already in use
        200140004Not allowed user
        200140005Not existing the required parameter
        200140006invalid request
        200140007file size exceeds the limit
        200140009Input file has a problem
        200140010Unzip failed
        400100Bad Request Exception
        401200Authentication Failed
        401210Permission Denied
        404300Not Found Exception
        429400Quota Exceeded
        429410Throttle Limited
        429420Rate Limited
        413430Request Entity Too Large
        503500Endpoint Error
        504510Endpoint Timeout
        500900Unexpected Error
        참고

        네이버 클라우드 플랫폼에서 공통으로 사용하는 응답 상태 코드에 대한 정보는 Ncloud API 응답 상태 코드를 참조해 주십시오.

        File Safer API

        File Safer 서비스에서 제공하는 API에 대한 설명은 다음과 같습니다.

        Hash Filter

        Hash Filter 관련 API는 다음과 같습니다.

        API설명
        checkHash파일 또는 URL 스트링의 악성 여부 확인
        getNotiConfig분석 결과의 통보 설정 조회
        getThresholdNotiConfig분석 결과의 통보 고급 설정 조회
        removeThresholdNotiConfig분석 결과의 통보 고급 설정 삭제
        setNotiConfig분석 결과의 통보 설정
        setThresholdNotiConfig분석 결과의 통보 고급 설정

        File Filter

        File Filter 관련 API는 다음과 같습니다.

        API설명
        getInputFileLogInputFile API로 전송한 파일의 분석 결과 조회
        getInputFileLogByParentHashInputFile API로 전송한 압축 파일 내 파일의 분석 결과 조회
        getNotiConfig분석 결과의 통보 설정 조회
        getThresholdNotiConfig분석 결과의 통보 고급 설정 조회
        InputFileFile Filter로 분석할 파일 전송
        removeThresholdNotiConfig분석 결과의 통보 고급 설정 삭제
        setNotiConfig분석 결과의 통보 설정
        setThresholdNotiConfig분석 결과의 통보 고급 설정

        File Safer 연관 리소스

        File Safer API에 대한 사용자의 이해를 돕기 위해 다양한 연관 리소스를 제공하고 있습니다.


        이 문서가 도움이 되었습니까?

        Changing your password will log you out immediately. Use the new password to log back in.
        First name must have atleast 2 characters. Numbers and special characters are not allowed.
        Last name must have atleast 1 characters. Numbers and special characters are not allowed.
        Enter a valid email
        Enter a valid password
        Your profile has been successfully updated.