Webshell Behavior Detector 개요
    • PDF

    Webshell Behavior Detector 개요

    • PDF

    기사 요약

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

    Webshell Behavior Detector는 웹쉘 의심 행위를 실시간으로 탐지하여 빠르게 대응할 수 있도록 알림을 제공하는 네이버 클라우드 플랫폼의 서비스입니다. Webshell Behavior Detector 서비스에서는 Webshell, Excepted Webshell, Quarantine, Exception Rule, Deleted Exception Rule, Notification, Detection Setting 기능에 대한 API를 RESTful 형태로 제공합니다.

    Webshell Behavior Detector 공통 설정

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

    요청

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

    API URL

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

    https://wbd.apigw.ntruss.com/api/v1/
    

    요청 헤더

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

    필드필수 여부설명
    x-ncp-apigw-timestampRequired1970년 1월 1일 00:00:00 협정 세계시(UTC)부터의 경과 시간 (밀리초)
  • API Gateway 서버와 5분 이상 시간차 발생 시 유효하지 않은 요청으로 간주
  • 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 발급 및 확인: 인증키 생성 참조
  • 서명 생성: 시그니처 생성 참조
  • Content-typeRequired요청 데이터의 형식
  • application/json
  • X-NCP-USE_PLATFORM_TYPERequired이용 중인 플랫폼 환경
    • VPC

    응답

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

    응답 상태 코드

    응답 상태 코드에 대한 설명은 다음과 같습니다.

    HTTP 상태 코드코드메시지설명
    200400Platform must be not null.플랫폼 헤더 누락
    2008008Invalid file status.The status of file is quarantineFailed격리 실패하여 유효하지 않은 파일
    2008004Invaliddata.The detection data deleted is false, excepted is false.삭제 또는 예외 실패하여 유효하지 않은 데이터
    참고

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

    Webshell Behavior Detector API

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

    Webshell

    웹쉘 행위의 탐지 내역 관련 API에 대한 설명은 다음과 같습니다.

    API설명
    GetWebshell웹쉘 행위 탐지 내역 조회
    UpdateWebshellMemo웹쉘 행위 탐지 내역의 메모 변경
    DeleteWebshell웹쉘 행위 탐지 내역 삭제
    SearchWebshell웹쉘 행위 탐지 내역 검색
    GetWebshellSuspiciousObject웹쉘 의심 파일 조회
    QuarantineWebshellSuspiciousObject웹쉘 의심 파일 격리
    RecoverWebshellSuspiciousObject격리된 웹쉘 의심 파일 복구
    UpdateWebshellSuspiciousObjectMemo웹쉘 의심 파일의 매모 변경

    ExceptedWebshell

    탐지된 웹쉘 행위의 예외 처리 관련 API에 대한 설명은 다음과 같습니다.

    API설명
    GetExceptedWebshell예외 처리된 웹쉘 행위 탐지 내역 조회
    RevokeExceptedWebshell예외 처리된 웹쉘 행위 탐지 내역에 대해 예외 취소
    UpdateExceptedWebshellMemo예외 처리된 웹쉘 행위 탐지 내역의 메모 변경
    SearchExceptedWebshell예외 처리된 웹쉘 행위 탐지 내역 검색
    GetExceptedWebshellSuspiciousObject예외 처리된 웹쉘 행위 탐지 내역의 의심 파일 조회
    QuarantineExceptedWebshellSuspiciousObject예외 처리된 웹쉘 행위 탐지 내역의 의심 파일 격리
    RecoverExceptedWebshellSuspiciousObject예외 처리된 웹쉘 행위 탐지 내역의 의심 파일 복구
    UpdateExceptedWebshellSuspiciousObjectMemo예외 처리된 웹쉘 행위 탐지 내역의 의심 파일 메모 변경

    Quarantine

    검역소 관련 API에 대한 설명은 다음과 같습니다.

    API설명
    GetQuarantine격리된 웹쉘 의심 파일 조회
    RecoverQuarantine격리된 웹쉘 의심 파일 복구
    SearchQuarantine격리된 웹쉘 의심 파일 검색
    UpdateQuarantineMemo격리된 웹쉘 의심 파일 메모 변경

    ExceptionRule

    예외 규칙 관련 API에 대한 설명은 다음과 같습니다.

    API설명
    GetExceptionRule예외 규칙 조회
    SearchExceptionRule예외 규칙 검색
    UpdateExceptionRuleMemo예외 규칙 메모 변경
    DeleteExceptionRule예외 규칙 삭제

    DeletedExceptionRule

    삭제된 예외 규칙 관련 API에 대한 설명은 다음과 같습니다.

    API설명
    GetDeletedExceptionRule삭제된 예외 규칙 조회
    SearchDeletedExceptionRule삭제된 예외 규칙 검색
    UpdateDeletedExceptionRuleMemo삭제된 예외 규칙 메모 변경
    RecoverDeletedExceptionRule삭제된 예외 규칙 복구

    Notification

    알림 설정 관련 API에 대한 설명은 다음과 같습니다.

    API설명
    GetNotificationInterval설정된 알림 간격 조회
    UpdateNotificationInterval알림 간격 설정

    Detection Setting

    탐지 설정 관련 API에 대한 설명은 다음과 같습니다.

    API설명
    GetDetectionTarget탐지 대상 조회
    SearchDetectionTarget탐지 대상 검색
    ActivateAgent서버에 설치된 에이전트 활성화
    DeactivateAgent서버에 설치된 에이전트 비활성화
    UpdateDetectionTargetMemo탐지 대상 메모 변경

    Webshell Behavior Detector 연관 리소스

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


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

    What's Next
    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.