IScannerInsertionPoint

```
public interface IScannerInsertionPoint
```
アクティブスキャンで使用する挿入ポイントを定義します。拡張は、IScannerCheckに登録してこのインタフェースのインスタンスを生成するか、IScannerInsertionPointProviderに登録してBurp自身のスキャンチェックで使うインスタンスを生成できます。

フィールドのサマリー

フィールド
修飾子と型	フィールドと説明
`static byte`	`INS_ENTIRE_BODY` ペイロードのHTTPリクエストのボディへの挿入を示します。
`static byte`	`INS_EXTENSION_PROVIDED` `IScannerInsertionPointProvider`に登録された拡張にペイロードの挿入ポイントを示すために使用されます。
`static byte`	`INS_HEADER` ペイロードのHTTPリクエストヘッダへの入を示します。
`static byte`	`INS_PARAM_AMF` ペイロードのAMFパラメータ値への挿入を示します。
`static byte`	`INS_PARAM_BODY` ペイロードのボディパラメータ値への挿入を示します。
`static byte`	`INS_PARAM_COOKIE` ペイロードのHTTP cookieへの挿入を示します。
`static byte`	`INS_PARAM_JSON` ペイロードのJSON構造内の値への挿入を示します。
`static byte`	`INS_PARAM_MULTIPART_ATTR` ペイロードのマルチパートメッセージのパラメター属性の値(アップロードしたファイル名など)への挿入を示します。
`static byte`	`INS_PARAM_NAME_BODY` ペイロードの追加ボディパラメータへの挿入を示します。
`static byte`	`INS_PARAM_NAME_URL` ペイロードの追加URLパラメータへの挿入を示します。
`static byte`	`INS_PARAM_URL` ペイロードのURLパラメータ値への挿入を示します。
`static byte`	`INS_PARAM_XML` ペイロードのXMLデータ構造内のデータ項目への挿入を示します。
`static byte`	`INS_PARAM_XML_ATTR` ペイロードのXML構造内のタグの属性値への挿入を示します。
`static byte`	`INS_UNKNOWN` ペイロードのリクエストの不明な場所への挿入を示します。
`static byte`	`INS_URL_PATH_FILENAME` ペイロードのURLパスのファイル名への挿入を示します。
`static byte`	`INS_URL_PATH_FOLDER` ペイロードのURLパスのフォルダ名への挿入を示します。
`static byte`	`INS_URL_PATH_REST` 非推奨。
`static byte`	`INS_USER_PROVIDED` ペイロードのユーザが手動で設定した場所への挿入を示します。

メソッドのサマリー

すべてのメソッドインスタンスメソッド抽象メソッド
修飾子と型	メソッドと説明
`byte[]`	`buildRequest(byte[] payload)` 指定されたペイロードを挿入ポイントに配置してリクエストを作成します。
`java.lang.String`	`getBaseValue()` 挿入ポイントの元値を返します。
`java.lang.String`	`getInsertionPointName()` 挿入ポイントの名前を返します。
`byte`	`getInsertionPointType()` 挿入ポイントのタイプを返します。
`int[]`	`getPayloadOffsets(byte[] payload)` 挿入ポイントに配置された際の、リクエスト内におけるペイロード値のオフセットを決定します。

- フィールド詳細
  - INS_PARAM_URL
```
static final byte INS_PARAM_URL
```
    ペイロードのURLパラメータ値への挿入を示します。
    
    関連項目:
    
    定数フィールド値
  - INS_PARAM_BODY
```
static final byte INS_PARAM_BODY
```
    ペイロードのボディパラメータ値への挿入を示します。
    
    関連項目:
    
    定数フィールド値
  - INS_PARAM_COOKIE
```
static final byte INS_PARAM_COOKIE
```
    ペイロードのHTTP cookieへの挿入を示します。
    
    関連項目:
    
    定数フィールド値
  - INS_PARAM_XML
```
static final byte INS_PARAM_XML
```
    ペイロードのXMLデータ構造内のデータ項目への挿入を示します。
    
    関連項目:
    
    定数フィールド値
  - INS_PARAM_XML_ATTR
```
static final byte INS_PARAM_XML_ATTR
```
    ペイロードのXML構造内のタグの属性値への挿入を示します。
    
    関連項目:
    
    定数フィールド値
  - INS_PARAM_MULTIPART_ATTR
```
static final byte INS_PARAM_MULTIPART_ATTR
```
    ペイロードのマルチパートメッセージのパラメター属性の値(アップロードしたファイル名など)への挿入を示します。
    
    関連項目:
    
    定数フィールド値
  - INS_PARAM_JSON
```
static final byte INS_PARAM_JSON
```
    ペイロードのJSON構造内の値への挿入を示します。
    
    関連項目:
    
    定数フィールド値
  - INS_PARAM_AMF
```
static final byte INS_PARAM_AMF
```
    ペイロードのAMFパラメータ値への挿入を示します。
    
    関連項目:
    
    定数フィールド値
  - INS_HEADER
```
static final byte INS_HEADER
```
    ペイロードのHTTPリクエストヘッダへの入を示します。
    
    関連項目:
    
    定数フィールド値
  - INS_URL_PATH_FOLDER
```
static final byte INS_URL_PATH_FOLDER
```
    ペイロードのURLパスのフォルダ名への挿入を示します。
    
    関連項目:
    
    定数フィールド値
  - INS_URL_PATH_REST
```
@Deprecated
static final byte INS_URL_PATH_REST
```
    非推奨。
    
    ペイロードのURLパスのフォルダ名への挿入を示します。これは廃止されました: 代わりにINS_URL_PATH_FOLDERを使用してください。
    
    関連項目:
    
    定数フィールド値
  - INS_PARAM_NAME_URL
```
static final byte INS_PARAM_NAME_URL
```
    ペイロードの追加URLパラメータへの挿入を示します。
    
    関連項目:
    
    定数フィールド値
  - INS_PARAM_NAME_BODY
```
static final byte INS_PARAM_NAME_BODY
```
    ペイロードの追加ボディパラメータへの挿入を示します。
    
    関連項目:
    
    定数フィールド値
  - INS_ENTIRE_BODY
```
static final byte INS_ENTIRE_BODY
```
    ペイロードのHTTPリクエストのボディへの挿入を示します。
    
    関連項目:
    
    定数フィールド値
  - INS_URL_PATH_FILENAME
```
static final byte INS_URL_PATH_FILENAME
```
    ペイロードのURLパスのファイル名への挿入を示します。
    
    関連項目:
    
    定数フィールド値
  - INS_USER_PROVIDED
```
static final byte INS_USER_PROVIDED
```
    ペイロードのユーザが手動で設定した場所への挿入を示します。
    
    関連項目:
    
    定数フィールド値
  - INS_EXTENSION_PROVIDED
```
static final byte INS_EXTENSION_PROVIDED
```
    IScannerInsertionPointProviderに登録された拡張にペイロードの挿入ポイントを示すために使用されます。
    
    関連項目:
    
    定数フィールド値
  - INS_UNKNOWN
```
static final byte INS_UNKNOWN
```
    ペイロードのリクエストの不明な場所への挿入を示します。
    
    関連項目:
    
    定数フィールド値
- メソッドの詳細
  - getInsertionPointName
```
java.lang.String getInsertionPointName()
```
    挿入ポイントの名前を返します。
    
    戻り値:
    
    挿入ポイントの名前 (たとえば、特定のリクエストパラメータの説明など)。
  - getBaseValue
```
java.lang.String getBaseValue()
```
    挿入ポイントの元値を返します。
    
    戻り値:
    
    スキャンされるベースリクエスト内の、この挿入ポイントの元値、またはベースリクエストにこの挿入ポイントに対応する値がない場合はnull。
  - buildRequest
```
byte[] buildRequest(byte[] payload)
```
    指定されたペイロードを挿入ポイントに配置してリクエストを作成します。リクエストのボディ長が変更された場合のContent-Lengthヘッダの調整は、拡張が提供する挿入ポイントでは必要ありません。Burpが提供する挿入ポイントでは妥当なContent-Lengthを常に返します。注: スキャンチェックは、エンコードされていない生のペイロードを挿入ポイントに指定する必要があり、挿入ポイントはその性質と場所に応じた適切なエンコードをすべてのデータに対して行う責任があります。
    
    パラメータ:
    
    payload - 挿入ポイントに配置されるペイロード。
    
    戻り値:
    
    結果のリクエスト。
  - getPayloadOffsets
```
int[] getPayloadOffsets(byte[] payload)
```
    挿入ポイントに配置された際の、リクエスト内におけるペイロード値のオフセットを決定します。スキャンチェックが問題を報告する際にこのメソッドを呼び出し、UI上でリクエストの関連する部分を強調表示できます。
    
    パラメータ:
    
    payload - 挿入ポイントに配置されるペイロード。
    
    戻り値:
    
    リクエスト内のペイロードの、開始と終了オフセットを含んだint[2]配列、または適用できない場合(たとえば、シリアライズされたデータ構造内にペイロードが配置されて結果のレスポンス内のどこにも生のペイロードが出現しない場合など)はnull。
  - getInsertionPointType
```
byte getInsertionPointType()
```
    挿入ポイントのタイプを返します。
    
    戻り値:
    
    挿入ポイントのタイプ。有効な値は、このインタフェースで定義されています。

インタフェース IScannerInsertionPoint

フィールドのサマリー

メソッドのサマリー

フィールド詳細

INS_PARAM_URL

INS_PARAM_BODY

INS_PARAM_COOKIE

INS_PARAM_XML

INS_PARAM_XML_ATTR

INS_PARAM_MULTIPART_ATTR

INS_PARAM_JSON

INS_PARAM_AMF

INS_HEADER

INS_URL_PATH_FOLDER

INS_URL_PATH_REST

INS_PARAM_NAME_URL

INS_PARAM_NAME_BODY

INS_ENTIRE_BODY

INS_URL_PATH_FILENAME

INS_USER_PROVIDED

INS_EXTENSION_PROVIDED

INS_UNKNOWN

メソッドの詳細

getInsertionPointName

getBaseValue

buildRequest

getPayloadOffsets

getInsertionPointType