getTrafficLog
    • PDF

    getTrafficLog

    • PDF

    記事の要約

    Classic環境で利用できます。

    Secure Zone Firewallで発生したトラフィックログを照会します。

    リクエスト

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

    メソッドURI
    POST/{type}/{zone}/getTrafficLog

    リクエストヘッダ

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

    リクエストパスパラメータ

    パラメータの説明は次の通りです。

    フィールドタイプ必須の有無説明
    typeStringRequiredSecure Zoneで提供するファイアウォールタイプ
    • szfw | psfw
      • szfw: Secure Zone Standard
      • psfw: Secure Zone Advanced
    zoneStringRequiredSecure Zoneを構成したゾーン
    • kr1 | kr2
      • kr1: KR-1ゾーン
      • kr2: KR-2ゾーン

    リクエストボディ

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

    フィールドタイプ必須の有無説明
    actionStringOptional許可するかどうか
    • allow | deny
    countPerPageIntegerOptionalページごとの項目数
    • 0(デフォルト)
    pageIntegerOptionalページインデックス
    • 0(デフォルト)
    fromDateDateRequired照会期間の開始日
    toDateDateRequired照会期間の終了日
    timeZoneStringOptionalタイムゾーン
    • +09:00(デフォルト)
    destinationIpStringOptional目的地の IPアドレス
    portStringOptional目的地のポート番号
    protocolStringOptional目的地のプロトコル
    sourceIpStringOptional出発地の IPアドレス

    リクエスト例

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

    curl --location --request POST 'https://securezonefirewall.apigw.ntruss.com/api/v2/szfw/kr2/getTrafficLog'
    --header 'x-ncp-apigw-timestamp: {Timestamp}' \
    --header 'x-ncp-iam-access-key: {Access Key}' \
    --header 'x-ncp-apigw-signature-v2: {API Gateway Signature}' \
    --header 'x-ncp-mbr_no: {User number}' \
    --header 'Content-Type: application/json' \
    --data '{
      "fromDate": "2024-07-01T00:32:14.953Z",
      "toDate": "2024-07-03T04:59:58.525Z"
    }'
    

    レスポンス

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

    レスポンスボディ

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

    フィールドタイプ必須の有無説明
    actionString-リクエストタイプ
    returnCodeInteger-レスポンスコード
    returnMessageString-レスポンスメッセージ
    totalCountInteger-トラフィックログの総数
    trafficLogList[]Array-トラフィックログ情報
    trafficLogList[].receiveDateLong-ログ発生日(Unix timestamp)
    trafficLogList[].sourceIpString-出発地 IPアドレス
    trafficLogList[].sourceServerNameString-出発地サーバの名前
    trafficLogList[].destinationIpString-目的地 IPアドレス
    trafficLogList[].destinationServerNameString-目的地サーバの名前
    trafficLogList[].protocolString-目的地プロトコル
    trafficLogList[].serviceString-サービス
    trafficLogList[].portString-目的地ポート番号
    trafficLogList[].actionString-許可するかどうか
    • allow | deny
    trafficLogList[].policyNameString-ポリシー名

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

    NAVERクラウドプラットフォームで共通して使用されるレスポンスステータスコードの詳細は、Ncloud APIのレスポンスステータスコードをご参照ください。

    レスポンス例

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

    {
        "action": "getTrafficLog",
        "returnCode": 0,
        "returnMessage": "success",
        "totalCount": 5,
        "trafficLogList": [
            {
                "receiveDate": 1719982292000,
                "sourceIp": "***.***.***.***",
                "sourceServerName": "",
                "destinationIp": "***.***.***.***",
                "destinationServerName": "sv-securezone",
                "protocol": "TCP",
                "service": "SSH",
                "port": "22",
                "action": "deny",
                "policyName": "Policy(Default Deny)"
            },
            {
                "receiveDate": 1719982286000,
                "sourceIp": "***.***.***.***",
                "sourceServerName": "",
                "destinationIp": "***.***.***.***",
                "destinationServerName": "sv-securezone",
                "protocol": "TCP",
                "service": "SSH",
                "port": "22",
                "action": "deny",
                "policyName": "Policy(Default Deny)"
            },
            {
                "receiveDate": 1719982282000,
                "sourceIp": "***.***.***.***",
                "sourceServerName": "",
                "destinationIp": "***.***.***.***",
                "destinationServerName": "sv-securezone",
                "protocol": "TCP",
                "service": "SSH",
                "port": "22",
                "action": "deny",
                "policyName": "Policy(Default Deny)"
            },
            {
                "receiveDate": 1719982281000,
                "sourceIp": "***.***.***.***",
                "sourceServerName": "",
                "destinationIp": "***.***.***.***",
                "destinationServerName": "sv-securezone",
                "protocol": "TCP",
                "service": "SSH",
                "port": "22",
                "action": "deny",
                "policyName": "Policy(Default Deny)"
            },
            {
                "receiveDate": 1719982279000,
                "sourceIp": "***.***.***.***",
                "sourceServerName": "",
                "destinationIp": "***.***.***.***",
                "destinationServerName": "sv-securezone",
                "protocol": "TCP",
                "service": "SSH",
                "port": "22",
                "action": "deny",
                "policyName": "Policy(Default Deny)"
            }
        ]
    }
    

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

    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.