getIPSList
    • PDF

    getIPSList

    • PDF

    記事の要約

    Classic/VPC環境で利用できます。

    Intrusion Prevention System(IPS)サービスの使用中に発生したセキュリティイベントリストを照会します。

    リクエスト

    リクエスト形式を説明します。リクエスト形式は次の通りです。

    メソッドURI
    POST/getIPSList

    リクエストヘッダ

    Security Monitoring APIで共通して使用されるヘッダの詳細は、Security Monitoringのリクエストヘッダをご参照ください。

    リクエストボディ

    リクエストボディの説明は次の通りです。

    フィールドタイプ必須の有無説明
    startDateTimeLongRequiredセキュリティイベント照会開始時間(Unix timestamp)
    • <例> 1720540427000
    endDateTimeLongRequiredセキュリティイベント照会終了時間(Unix timestamp)
    • <例> 1720540427000
    pageIntegerRequiredページ番号
    countPerPageIntegerRequiredページごとの表示数
    orderStringOptionalイベント検知時間のソート順序
    • asc | desc(デフォルト)
      • asc: 昇順
      • desc: 降順
    regionCodeStringOptionalリージョンコード
    • KR | DEN | JPN | SGN | USWN
      • KR: 韓国
      • DEN: ドイツ
      • JPN: 日本
      • SGN: シンガポール
      • USWN: 米国
    zoneNameStringOptionalゾーン区分
    • KR-1 | KR-2
    eventNmStringOptional検知されたイベントの名前
    attackIpStringOptional攻撃者 IPアドレス
    targetIpStringOptional攻撃対象の IPアドレス
    attackTypeStringOptional検知された攻撃タイプ
    • Classic環境でのみ使用可能
    protocolStringOptional攻撃プロトコル
    • VPC環境でのみ使用可能

    リクエスト例

    リクエストのサンプルコードは次の通りです。

    curl --location --request POST 'https://securitymonitoring.apigw.ntruss.com/vsecuritymonitoring/v1/getIPSList'
    --header 'x-ncp-apigw-timestamp: {Timestamp}'
    --header 'x-ncp-iam-access-key: {Access Key}' 
    --header 'x-ncp-apigw-signature-v2: {API Gateway Signature}' 
    --data '{
      "startDateTime": 1719849227000,
      "endDateTime": 1720108427000,
      "page": 1,
      "countPerPage": 20
    }'
    

    レスポンス

    レスポンス形式を説明します。

    レスポンスボディ

    レスポンスボディの説明は次の通りです。

    フィールドタイプ必須の有無説明
    returnCodeInteger-リクエストに対する処理結果コード
    ipsDataList[]Array-IPSセキュリティイベントリスト
    ipsDataList[].ticketIdString-セキュリティイベントに付与された固有番号
    ipsDataList[].dateString-セキュリティイベントの検知時間(Unix timestamp)
    ipsDataList[].productString-サービス区分
    • IPS | IPS_V2
      • IPS: Classic環境
      • IPS_V2: VPC環境
    ipsDataList[].eventNmString-検知されたセキュリティイベントの名前
    ipsDataList[].attackTypeString-検知された攻撃タイプ
    ipsDataList[].attackerIpString-攻撃者 IPアドレス
    ipsDataList[].attackerPortString-攻撃者のポート番号
    ipsDataList[].targetIpString-攻撃対象の IPアドレス
    ipsDataList[].targetPortString-攻撃対象のポート番号
    ipsDataList[].protocolString-攻撃プロトコル
    ipsDataList[].detectString-セキュリティイベント検知件数
    ipsDataList[].regionString-リージョン
    ipsDataList[].zoneNameString-ゾーン区分
    • KR-1 | KR-2
    ipsDataList[].platFormString-プラットフォーム区分
    • CLASSIC | VPC
    ipsDataList[].vpcNameString-VPC名
    returnMessageString-リクエストに対する処理結果メッセージ
    totalRowsInteger-照会されたリストの総数
    pageInteger-リクエストページ番号

    レスポンスステータスコード

    Security Monitoring APIで共通して使用されるエラーコードの詳細は、Security Monitoringの共通エラーコードをご参照ください。

    レスポンス例

    レスポンスのサンプルコードは次の通りです。

    {
        "returnCode": 0,
        "ipsDataList": [
            {
                "ticketId": "526068436",
                "date": "1720044443000",
                "product": "IPS_V2",
                "eventNm": "Deep Security Apache Log4j Remote Code Execution Vulnerability (CVE-2021-44228)",
                "attackType": null,
                "attackerIp": "***.***.***.***",
                "attackerPort": "51185",
                "targetIp": "***.***.***.***",
                "targetPort": "80",
                "protocol": "TCP",
                "detect": "1",
                "region": "Korea",
                "zoneName": "KR-2",
                "platForm": "VPC",
                "vpcName": "kr-sm-vpc"
            }
        ],
        "returnMessage": "SUCCESS",
        "totalRows": 1,
        "page": 1
    }
    

    この記事は役に立ちましたか?

    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.