Web Security Checker 개요
    • PDF

    Web Security Checker 개요

    • PDF

    기사 요약

    개요

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

    공통 설정

    API

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

    요청 헤더

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

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

    공통 오류

    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 응답 코드errorCodemessage설명
    2000success성공
    200901API Call Fail내부 API 호출 실패
    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고객의 NCP 서버가 아님 (고객 소유의 NCP 자산만 진단 가능)
    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조회 레코드 수가 다름

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

    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.