IAST設定

delayフィールドは、アプリケーションの起動後に IAST スキャンが開始されるまでの時間を分単位で指定します。 デフォルト値は0です。

durationフィールドは、IAST スキャンが実行される時間の長さを分単位で指定します。 デフォルト値は永久で、制限はありません。

たとえば、 duration: 300設定すると、IAST スキャンは 300 分 (5 時間) 実行されます。

scheduleフィールドは、IAST スキャンをいつ実行するかを定義する cron 式を指定します。 デフォルトでは、 scheduleは無効になっています。 cron 式は、スペースで区切られた 6 つのフィールドで構成されます。

• second : 秒を指定します (0-59)

• minute: 分を指定します (0-59)

• hour : 時間を指定します (0-23)

• day : 月の日付を指定します (1-31)

• month: 年の月 (1-12 または JAN-DEC)

• day_of_week : 曜日を指定します（1～7またはSUN～SAT）。1は日曜日です。

  重要

  durationが指定されていない場合はどうなりますか? 期間を省略すると、 IASTスキャンを決して停止してはいけないことを意味します。 このシナリオでは、指定されたスケジュールは定期的な操作ではなく、開始時刻として扱われます。 スキャンは中断または終了することなく無期限に継続されます。 たとえば、 schedule: "0 0 0 * * ?" IAST スキャンを毎日午前 12 時に実行するようにスケジュールします。

always-sample-traces IAST がバックグラウンドでトレース データをアクティブに収集できるようにし、セキュリティ エージェントは収集されたこのデータを使用して、スケジュールされた時間に IAST スキャンを実行します。 ただし、セッション管理を備えたアプリケーションの場合は、 always_sample_tracesフラグのデフォルト値をfalseに設定したままにしておくことをお勧めします。 これにより、IAST のサンプリングとスキャンが指定されたウィンドウに制限されます。 セッションの有効期間は通常短く、多くの場合 30 分以内に終了します。 このシナリオでは、ウィンドウの前でトレースをサンプリングすると、価値のあるインサイトが提供されず、脆弱性が失われる可能性があります。 デフォルトでは、 always_sample_tracesの値は false です。

IAST をアプリケーションの起動後 30 分後に開始し、300 分間実行するようにスケジュールするには、遅延を 30 に設定し、期間を 300 に設定する必要があります。

security:
    scan_schedule:
      delay: 30                  #In minutes, default is 0 min
      duration: 300            #In minutes, default is forever

IAST を特定の時間に実行するようにスケジュールするには、希望する時間を表す cron 式にスケジュールを設定します。 たとえば、IAST を毎日深夜に実行するようにスケジュールするには、スケジュールを"0 0 0 * * ?"に設定します。

security:
    scan_schedule:
      schedule: "0 0 0 * * ?"         #By default, schedule is inactive

IAST で常にトレースをサンプリングする場合は、 always_sample_traces trueに設定します。 デフォルトでは、これはfalseに設定されており、IAST はアクティブなスキャン ウィンドウ内のトレースのみをサンプリングすることを意味します。

security:
    scan_schedule:
      delay: 30                          #In minutes, default is 0 min
      always_sample_traces: true     #regardless of scan schedule

これは HTTP ヘッダー キーのリストです。 リクエストにこれらのキーを含むヘッダーが含まれている場合、対応する IAST スキャンはスキップされます。 たとえば、ヘッダー付きの curl リクエストがあり、X-Forwarded-For ヘッダーのIASTスキャンをスキップしたい場合は、次の設定を渡すことができます。

$
curl -X POST -H "X-Forwarded-For: 123.456.789.012" -H "Content-Type: application/x-www-form-urlencoded" -d "param1=value1&param2=value2" http://example.com

次の設定を使用できます:

exclude_from_iast_scan:
    http_request_parameters:
      header: 
        - X-Forwarded-For

これは、問題キーのリストです。 リクエストの最初の文字列にこれらの問題が存在すると、 IASTスキャンがスキップされます。 たとえば、問題のあるカール リクエストがあり、customerID と username のIASTスキャンをスキップしたい場合は、次の設定を渡すことができます。

$
curl --location --request GET 'localhost:8080/sql/save?firstName=test&lastName=user&customerID=testuser&username=test123'

次の設定を使用できます:

exclude_from_iast_scan:
    http_request_parameters:
      query: 
        - username
        - customerID

これはリクエスト本文内のキーのリストです。 本文コンテンツ内にこれらのキーが見つかった場合、IAST スキャンはスキップされます。 リクエスト本文でサポートされているコンテンツ タイプは、JSON、XML、および Form-URL-Encoded データです。

JSONコンテンツタイプの例

これは、JSON 本文を含む curl リクエストがあり、 customerIDおよびfirstNameで IAST スキャンをスキップする場合の JSON コンテンツ タイプの curl の例です。

$
curl --location --request POST 'localhost:8080/application/json/post' \
>
  --header 'Content-Type: application/json' \
>
  --data '{
$
      "path": "sample.txt",
$
      "script":"testscript",
$
      "customerID":"GREAL",
$
      "name": {
$
  "firstName": "john",
$
  "lastName": "wick"
$
  },
$
      "url":"http://example.com",
$
      "cmd":"ls"
$
  }'

次の設定を使用できます:

exclude_from_iast_scan:
    http_request_parameters:
      body: 
        - customerID
        - name.firstName

XMLコンテンツタイプの例

これは XML 本文を含む curl リクエストであり、 customerIDとusernameでの IAST スキャンをスキップします。

$
curl --location 'localhost:8080/application/xml/post' \
>
  --header 'Content-Type: application/xml' \
>
  --data '<?xml version="1.0" encoding="UTF-8" ?>
$
  <AppData>
$
    <path>sample.txt</path>
$
    <script>K2</script>
$
    <customerID>GREAL</customerID>
$
    <username>bob</username>
$
    <url>http://example.com</url>
$
    <cmd>ls</cmd>
$
    <name>keshav</name>
$
    <firstName>Aliko</firstName>
$
  </AppData>'

次の設定を使用できます:

exclude_from_iast_scan:
    http_request_parameters:
      body: 
        - AppData.customerID
        - AppData.username

フォーム URL エンコードされたコンテンツ タイプの例

これは、Form-URL-Encoded 本文を含む curl リクエストであり、 customerIDおよびusernameでの IAST スキャンをスキップします。

$
curl --location 'localhost:8080/application/urlencode/post' \
>
  --header 'Content-Type: application/x-www-form-urlencoded' \
>
  -d 'name=madhav&path=sample.txt&customerID=GREAL&script=K2&url=http://example.com&username=bob&firstName=Aliko&cmd=ls'

次の設定を使用できます:

http_request_parameters:
    body: 
      - customerID
      - username