포털 바로가기 네이버 클라우드 플랫폼 설명서

네이버 클라우드 플랫폼의 상품 사용 방법을 보다 상세하게 제공하고, 다양한 API의 활용을 돕기 위해 [설명서]와 [API 참조서]를 구분하여 제공하고 있습니다.

Web Security Checker API 참조서 바로가기 >>
Web Security Checker API 사용 가이드 바로가기 >>
Web Security Checker 설명서 바로가기 >>

Web Security Checker API 사용 가이드 개요

Web Security Checker API 사용 가이드에서는 Web Security Checker 의 API 를 사용하는 방법을 설명하고 있습니다.

Web Security Checker API 이용하기

Web Security Checker API 는 API Gateway 를 통해 제공됩니다. API Gateway 를 사용하기 위해서 서브 계정(Sub Account) 이(가) 필요합니다. 서브 계정을 생성하려면 아래의 링크를 참고해 주세요.

• 서브계정 및 Access Key 생성하기

서브 계정(Sub Account)을 생성한 후 해당 계정에 Web Security Checker 의 사용 권한을 추가 해야합니다.

1. 생성한 서브 계정을 선택하여 "서브 계정 상세" 페이지로 이동합니다.
2. 정책 탭에서 (1)추가 버튼을 클릭합니다.
3. (2) NCP_WEB_SECURITY_CHECKER_MANAGER 정책을 검색하여 선택한 뒤 추가 버튼을 클릭합니다.

서브 계정과 Access Key 발급이 완료되었다면 Web Security Checker API 를 사용할 준비가 완료되었습니다. API 에 대한 구체적인 내용은 Web Security Checker API 참조서 바로가기 를 확인해 주시길 바랍니다.

Web Security Checker API Support

Web Security Checker API 는 아래와 같이 Web Security Checker 의 일부 기능을 제공하고 있습니다.

Web Security Checker API 이용 예시

이 가이드에서는 1. 진단 리스트 조회하기, 2. 진단 검색하기, 그리고 3. 진단 취소하기 기능을 이용하는 방법을 알아보겠습니다.

1. 진단 리스트 조회하기

Web Security Checker API 는 콘솔을 통해 등록한 진단 리스트를 API 를 통해 조회할 수 있습니다. 시작하기 전에 서브 계정의 Access Key 와 Secret Key 를 미리 준비해주세요.

가이드는 Python3 을 기반으로 작성되었습니다. Java, Node.js 등의 샘플을 원하시는 경우 API 호출하기 링크에서 다른 언어의 동일한 샘플 코드를 참고할 수 있습니다.

1.1 URI 설정

진단 리스트 조회 API 는 아래와 같이 URI 가 구성됩니다.

1.2 샘플 코드

이 샘플 코드는 여러분의 진단 리스트를 조회하는 파이썬 코드입니다.

import sys
import os
import hashlib
import hmac
import base64
import requests
import time

def make_signature(method, uri, timestamp):

    access_key = "{accessKey}"  # access key id (from portal or sub account)
    secret_key = "{secretKey}"  # secret key (from portal or sub account)
    secret_key = bytes(secret_key, 'UTF-8')

    method = method
    uri = uri

    message = method + " " + uri + "\n" + timestamp + "\n" + access_key
    message = bytes(message, 'UTF-8')
    signingKey = base64.b64encode(hmac.new(secret_key, message, digestmod=hashlib.sha256).digest())
    return signingKey

timestamp = str(int(time.time() * 1000))

method = 'GET'
uri = '/api/v1/jobs?pages=1&limit=10'

signature = make_signature(method, uri, timestamp)

headers = {
    'x-ncp-apigw-signature-v2': signature.decode('utf-8'),
    'x-ncp-apigw-timestamp': timestamp,
    'x-ncp-iam-access-key': '{accessKey}' # access key id (from portal or sub account)
}

response = requests.request(
    method,
    f"https://wsc.apigw.ntruss.com{uri}",
    headers=headers
)

if respones.status_code == 200:
    print(response.text)

2. 진단 검색하기

Web Security Checker API 는 콘솔을 통해 등록한 진단 리스트를 API 를 통해 검색할 수 있습니다. 시작하기 전에 서브 계정의 Access Key 와 Secret Key 를 미리 준비해주세요.

가이드는 Python3 을 기반으로 작성되었습니다. Java, Node.js 등의 샘플을 원하시는 경우 API 호출하기 링크에서 다른 언어의 동일한 샘플 코드를 참고할 수 있습니다.

2.1 URI 설정

진단 리스트 검색 API 는 아래와 같이 URI 가 구성됩니다.

POST 리퀘스트의 BODY 영역은 application/json Content-Type 만을 지원합니다. BODY 영역의 샘플은 2.1.1 진단 URL 검색 에서 확인할 수 있습니다.

2.1.1 진단 URL 검색

searchType 은 반드시 "memo", "url", "(빈값)" 중의 하나입니다.

아래의 json 샘플은 여러분이 진단 대상으로 등록한 user-domain.co.kr 도메인을 검색하는 예시입니다.

{
  "searchType": "url",
  "searchKeyword": "user-domain.co.kr",
  "statusCode": null,
  "limit": 10,
  "page": 1
}

2.2 샘플 코드

이 샘플 코드는 여러분의 진단 리스트를 검색하는 파이썬 코드입니다.

make_signature 함수는 1.2 절의 샘플 코드를 사용해주세요.

# 생략, 1.2 절을 참고 하세요

method = 'POST'
uri = '/api/v1/jobs/search'
payload = {
  "searchType": "url",
  "searchKeyword": "user-domain.co.kr",
  "statusCode": None,
  "limit": 1,
  "page": 1
}

timestamp = str(int(time.time() * 1000))

signature = make_signature(method, uri, timestamp)

headers = {
    'x-ncp-apigw-signature-v2': signature.decode('utf-8'),
    'x-ncp-apigw-timestamp': timestamp,
    'x-ncp-iam-access-key': '{accessKey}' # access key id (from portal or sub account)
}

response = requests.request(
    method,
    f"https://wsc.apigw.ntruss.com{uri}",
    headers=headers,
    data=json.dumps(payload), # Json format required
)

if response.status_code == 200:
    print(response.text)

3. 진단 취소하기

Web Security Checker API 는 등록한 진단을 API 를 통해 취소할 수 있습니다. 시작하기 전에 서브 계정의 Access Key 와 Secret Key 를 미리 준비해주세요.

가이드는 Python3 을 기반으로 작성되었습니다. Java, Node.js 등의 샘플을 원하시는 경우 API 호출하기 링크에서 다른 언어의 동일한 샘플 코드를 참고할 수 있습니다.

3.1. 진단 취소/중지/리포트 기능

진단은 대기, 진행, 완료 단계로 구분되며 상태에 따라 기능이 다르게 적용됩니다.

3.2. 진단 생성하기

createJob API 를 통해 진단 작업을 생성합니다. API 의 상세한 사용방법은 Web Security Checker API 참조서 바로가기를 통해 확인해주세요.

curl -X PUT "https://wsc.apigw.ntruss.com/api/v1/job"
   -H "accept: application/json"
   -H "x-ncp-iam-access-key: {x-ncp-iam-access-key}"
   -H "x-ncp-apigw-timestamp: {x-ncp-apigw-timestamp}"
   -H "x-ncp-apigw-signature-v2: {x-ncp-apigw-signature-v2}"
   --data-raw '{
    "StartUrl": "https://target-domain.com",
    "ExcludeUrl": [
        "https://www.target-domain.com/event",
        "https://www.target-domain.com/robot.txt"
    ],
    "Cookies": "JSESSIONID=AB123123123123ASAS; Login_Ok=true; Role=admin;",
    "VulnItems": [
        "ALL"
    ],
    "UserAgent": "Android",
    "Speed": "1",
    "Memo": "sample"
}'

3.3 URI 설정

진단 취소 API 는 아래와 같이 URI 가 구성됩니다.

3.4. 샘플 코드

진단 취소를 위해서 진단 검색 API 와 진단 취소 API 가 필요합니다. 진단 검색 API 를 통해서 취소할 진단의 instanceNo의 값을 추출하고 이 값을 이용해 취소 API 를 호출합니다.

아래는 target-domain.com 키워드를 url 로 검색한 결과입니다. 출력된 진단 리스트 중 대기(Pending) 상태인 진단의 instanceNo 값을 복사합니다.

$ python jobSearch.py "url target-domain.com"
{'resources':
    {
        'current_end_page': '10',
        'current_start_page': '1',
        'record_data': [{'crawl_cnt': None,
                        'end_date': None,
                        'instanceNo': '12341234',
                        'memo': 'Wsc Sample',
                        'rescan_button': None,
                        'result_button': 'cancel',
                        'result_desc': None,
                        'scan_cnt': None,
                        'slave_data': None,
                        'start_date': '2020-05-21 22:00:00',
                        'start_url': 'http://target-domain.com',
                        'status': 'Pending'}],
        'total_cnt': 10,
        'total_page_cnt': '1'}}

복사된 instanceNo 값을 샘플 코드의 instanceId 변수에 대입합니다.

import sys
import os
import hashlib
import hmac
import base64
import requests
import time
import json
from pprint import pprint

def make_signature(method, uri, timestamp):

    access_key = "{accessKey}"  # access key id (from portal or sub account)
    secret_key = "{secretKey}"  # secret key (from portal or sub account)
    secret_key = bytes(secret_key, 'UTF-8')

    method = method
    uri = uri

    message = method + " " + uri + "\n" + timestamp + "\n" + access_key
    message = bytes(message, 'UTF-8')
    signingKey = base64.b64encode(hmac.new(secret_key, message, digestmod=hashlib.sha256).digest())
    return signingKey

method = 'PATCH'
instanceId = "{instanceId}" # instance id (from api)
uri = f'/api/v1/jobs/{instanceId}/cancel'
timestamp = str(int(time.time() * 1000))

signature = make_signature(method, uri, timestamp)

headers = {
    'x-ncp-apigw-signature-v2': signature.decode('utf-8'),
    'x-ncp-apigw-timestamp': timestamp,
    'x-ncp-iam-access-key': '{accessKey}' # access key id (from portal or sub 
}

response = requests.request(
    method,
    f"https://wsc.apigw.ntruss.com{uri}",
    headers=headers
)

if response.status_code == 200:
    pprint(json.loads(response.text))
else:
    pprint(json.loads(response.text))

연관 정보 바로가기

아래의 가이드에서 연관 정보를 확인할 수 있습니다.

• Web Security Checker 사용 가이드
• 서브 계정 생성하기
• API 호출하기