MENU
      Web Security Checker 개요

        Web Security Checker 개요


        기사 요약

        개요

        Web Security Checker API는 RETSTful 형태로 제공되며, 제공되는 API를 호출하기 위해서는 Sub Account (서브 계정) 생성 및 Access Key가 필요합니다.

        공통 설정

        API

        ServiceAPIMethodRequest URI
        Web Security CheckergetJobsGEThttps://wsc.apigw.ntruss.com/api/v1/jobs
        Web Security CheckersearchJobsPOSThttps://wsc.apigw.ntruss.com/api/v1/jobs/search
        Web Security CheckercancelJobPATCHhttps://wsc.apigw.ntruss.com/api/v1/jobs/{instanceId}/cancel
        Web Security CheckerstopJobPATCHhttps://wsc.apigw.ntruss.com/api/v1/jobs/{instanceId}/stop
        Web Security CheckergetReportGEThttps://wsc.apigw.ntruss.com/api/v1/jobs/report
        Web Security CheckercreateJobPUThttps://wsc.apigw.ntruss.com/api/v1/job

        요청 헤더

        IAM 인증을 위한 요청 헤더입니다.

        헤더명설명
        x-ncp-apigw-timestamp1970년 1월 1일 00:00:00 협정 세계시(UTC)부터의 경과 시간을 밀리초로 나타낸 것
        API Gateway 서버와 시간 차가 5분 이상 나는 경우 유효하지 않은 요청으로 간주
        x-ncp-iam-access-key네이버 클라우드 플랫폼 IAM 에서 발급받은 Access Key
        x-ncp-apigw-signature-v2요청 경로 및 헤더를 Access Key와 매핑되는 Secret Key로 암호화한 서명
        HMAC 암호화 알고리즘은 HmacSHA256을 사용
        Content-Type요청 바디 Content Type을 application/json으로 지정

        공통 오류

        HTTP 응답 코드ErrorCodeErrorMessage
        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

        서비스 오류

        HTTP 응답 코드에러message설명
        2000success성공
        200901API Call Fail일시적으로 사용이 원활하지 않으며 오류가 계속될 경우 고객지원 > 문의하기에 문의
        200169201Auth Check Error사용 권한 없음
        200169202User Check Error고객 계정정보 확인에 실패했으며 확인을 위해 고객문의 필요
        200160331ActionURL Check ErrorAction URL 에 http, https 를 입력
        200160332Param Check Error입력값에 허용되지 않는 값이 존재하며, ID param / PW param 값에는 특수문자 사용이 제한됨
        200160351Login_Check_Fail로그인 과정에서 오류가 발생했으며 로그인 정보를 다시 확인하여 재시도를 하거나, Cookie 직접 입력 필요
        200160353URL Connection Error입력한 Action URL 연결 실패
        200160431Param Check Error입력값에 허용되지 않는 값 존재
        200160432Param Check Null입력값에 누락 존재
        200160433Param Value Not Define입력값에 정의되지 않은 값 존재
        200160441DB Execute Query Error스캔 작업 등록 처리 과정에서 에러가 발생했으며 잠시후 다시 시도 필요
        200160451Assets_Check_Fail고객의 네이버 클라우드 플랫폼 서버가 아니며 고객 소유의 네이버 클라우드 플랫폼 자산만 진단 가능
        200160452Queue_Full선택한 일정의 경우, 예약이 꽉 찼으며 다른 일정으로 선택 필요
        200160453Already_Exists하나의 대상에 대해서 취약점 진단을 동시에 수행 불가하며, 현재 설정한 진단 대상은 진단 대기중임으로 페이지 상단에 있는“Scan Status / Results” 메뉴에서 확인 필요
        200160454TooMany_Insert작업 대기중인 리스트가 너무 많기에 스캔 진행 후 추가 필요
        200160455ReScan Create failed재진단 등록 조건이 맞지 않기에 대상의 도메인 및 IP 가 최초 진단과 같아야하며, 첫 진단 종료로부터 60일 내에 3번만 가능
        200160456Managed Service agree chk failed타사 웹서버 진단에 대한 동의 정보를 확인 할 수 없으며 동의한 후 이용 가능
        200160457Managed Service file chk failed타사 웹서버 진단에 필요한 파일체크에 실패했으며 타사 웹서버 진단 안내 팝업의 2번 항목 진행 필요
        200160701Open period expired진단결과 리포트의 열람 가능 기간은 1년
        200160842DB Matcing Data 0취소할 대상이 없으며 일괄 취소는 예약 및 대기 상태의 작업만 취소 가능
        200165244DB Data Record CNT Not Matching요청된 intacneNo 리스트와 DB조회 레코드 수가 다름

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

        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.