Web Security Checker Overview
- Print
- PDF
Web Security Checker Overview
- Print
- PDF
Article summary
Did you find this summary helpful?
Thank you for your feedback
Overview
Web Security Checker API is provided in a RESTful format. To call the provided API, a Sub Account and an Access Key are required.
Common Setting
API
| Service | API | Method | Request URI |
|---|---|---|---|
| Web Security Checker | getJobs | GET | https://wsc.apigw.ntruss.com/api/v1/jobs |
| Web Security Checker | searchJobs | POST | https://wsc.apigw.ntruss.com/api/v1/jobs/search |
| Web Security Checker | cancelJob | PATCH | https://wsc.apigw.ntruss.com/api/v1/jobs/{instanceId}/cancel |
| Web Security Checker | stopJob | PATCH | https://wsc.apigw.ntruss.com/api/v1/jobs/{instanceId}/stop |
| Web Security Checker | getReport | GET | https://wsc.apigw.ntruss.com/api/v1/jobs/report |
| Web Security Checker | createJob | PUT | https://wsc.apigw.ntruss.com/api/v1/job |
Request Headers
The following table lists the request headers for IAM authentication.
| Header | Description |
|---|---|
| x-ncp-apigw-timestamp | The number of milliseconds that have elapsed since January 1, 1970 00:00:00 UTC. If the time differs from that of the API Gateway server by 5 minutes or more, then the request is considered invalid. |
| x-ncp-iam-access-key | Access Key issued by IAM from NAVER Cloud Platform. |
| x-ncp-apigw-signature-v2 | This is the signature used to encrypt the request directory and the header with the SecretKey that maps with the AccessKey. The HMAC encryption algorithm is HmacSHA256. |
Common Errors
| HTTP Response Code | ErrorCode | ErrorMessage |
|---|---|---|
| 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 |
Service Errors
| HTTP Response Code | errorCode | message | Description |
|---|---|---|---|
| 200 | 0 | success | Success |
| 200 | 901 | API Call Fail | The service is temporarily unavailable. If this failure persists, contact our Help Center. |
| 200 | 169201 | Auth Check Error | You don't have the permission. |
| 200 | 169202 | User Check Error | User account information check failed. Please contact customer service for verification. |
| 200 | 160331 | ActionURL Check Error | Please enter http or https in the Action URL. |
| 200 | 160332 | Param Check Error | Input value includes invalid character(s). Special characters can't be used as ID param / PW param values. |
| 200 | 160351 | Login_Check_Fail | An error has occurred during the login process. Please try again after checking your login information, or enter the cookie directly. |
| 200 | 160353 | URL Connection Error | Connection to the entered Action URL failed |
| 200 | 160431 | Param Check Error | Input value includes invalid character(s). |
| 200 | 160432 | Param Check Null | Input value(s) missing |
| 200 | 160433 | Param Value Not Define | Undefined input value(s) entered |
| 200 | 160441 | DB Execute Query Error | An error occurred while registering a scanning task. Please try again later. |
| 200 | 160451 | Assets_Check_Fail | This NAVER Cloud Platform server does not belong to you. You can only diagnose the NAVER Cloud Platform assets you own. |
| 200 | 160452 | Queue_Full | The schedule you selected is full. Please choose a different schedule. |
| 200 | 160453 | Already_Exists | You can't run simultaneous vulnerability diagnostic tasks on a single target. The selected target is currently pending for diagnosis. Please check the "Scan Status / Results" menu at the top of the page. |
| 200 | 160454 | TooMany_Insert | There are too many tasks in the pending list. Please perform a scan before adding a task. |
| 200 | 160455 | ReScan Create failed | The conditions for re-diagnosis have not been met. The target must have the same domain and IP as the first diagnosis. Re-diagnosis can only be performed up to 3 times within 60 days from the completion of the first diagnosis. |
| 200 | 160456 | Managed Service agree chk failed | Managed external web server's diagnosis agreement information can't be found. You must agree to the service. |
| 200 | 160457 | Managed Service file chk failed | File check for managed external web server diagnosis failed. Please proceed with Item Number 2 in the managed external web server diagnosis pop-up window. |
| 200 | 160701 | Open period expired | Diagnosis result reports are accessible for up to 1 year. |
| 200 | 160842 | DB Matcing Data 0 | There are no tasks to cancel. Batch cancellation can only be performed on scheduled or pending tasks. |
| 200 | 165244 | DB Data Record CNT Not Matching | The requested intacneNo list does not match the DB access record number. |
Was this article helpful?