public interface IBurpExtenderCallbacks
registerExtenderCallbacks()
メソッドを呼び出し、IBurpExtenderCallbacks
インタフェースのインスタンスを渡します。拡張は、Burpの機能を拡張するために必要な、このインタフェースのメソッドを呼び出せます。修飾子と型 | フィールドと説明 |
---|---|
static int |
TOOL_COMPARER
Burp Comparerツールを識別するために使うフラグ
|
static int |
TOOL_DECODER
Burp Decoderツールを識別するために使うフラグ
|
static int |
TOOL_EXTENDER
Burp Extenderツールを識別するために使うフラグ
|
static int |
TOOL_INTRUDER
Burp Intruderツールを識別するために使うフラグ
|
static int |
TOOL_PROXY
Burp Proxyツールを識別するために使うフラグ
|
static int |
TOOL_REPEATER
Burp Repeaterツールを識別するために使うフラグ
|
static int |
TOOL_SCANNER
Burp Scannerツールを識別するために使うフラグ
|
static int |
TOOL_SEQUENCER
Burp Sequencerツールを識別するために使うフラグ
|
static int |
TOOL_SPIDER
Burp Spiderツールを識別するために使うフラグ
|
static int |
TOOL_SUITE
Burp Suite全体を識別するために使うフラグ
|
static int |
TOOL_TARGET
Burp Targetツールを識別するために使うフラグ
|
修飾子と型 | メソッドと説明 |
---|---|
void |
addScanIssue(IScanIssue issue)
Scannerの新しい問題を登録します。
|
void |
addSuiteTab(ITab tab)
Burp Suiteのメインウィンドウにカスタムタブを追加します。
|
void |
addToSiteMap(IHttpRequestResponse item)
Burpのサイトマップに、指定されたリクエスト/レスポンスの詳細を持つアイテムを追加します。
|
IHttpRequestResponseWithMarkers |
applyMarkers(IHttpRequestResponse httpRequestResponse,
java.util.List<int[]> requestMarkers,
java.util.List<int[]> responseMarkers)
HTTPリクエストまたはレスポンスメッセージに、いくつかの特定の目的に関連するオフセット位置にマーカを適用します。
|
IBurpCollaboratorClientContext |
createBurpCollaboratorClientContext()
Burp Collaboratorクライアントコンテキストのインスタンスを作成し、Burp Collaboratorペイロードの作成や、そのペイロードを使用した結果のネットワーク通信をCollaboratorサーバにポーリングできます。
|
IMessageEditor |
createMessageEditor(IMessageEditorController controller,
boolean editable)
独自のUIを使用する拡張のための、BurpのHTTPメッセージエディタの新しいインスタンスを作成します。
|
ITextEditor |
createTextEditor()
独自のUIを使用する拡張のための、Burpのプレーンテキストエディタの新しいインスタンスを作成します。
|
void |
customizeUiComponent(java.awt.Component component)
BurpのUIスタイルに沿って、フォントサイズ、色、一覧の行間隔などを含むUIコンポーネントをカスタマイズします。
|
IScanQueueItem |
doActiveScan(java.lang.String host,
int port,
boolean useHttps,
byte[] request)
アクティブ脆弱性スキャンを実行するよう、Burp ScannerツールにHTTPリクエストを送信します。
|
IScanQueueItem |
doActiveScan(java.lang.String host,
int port,
boolean useHttps,
byte[] request,
java.util.List<int[]> insertionPointOffsets)
スキャンされる挿入ポイントのリストに基づくアクティブ脆弱性スキャンをするよう、Burp ScannerツールにHTTPリクエストを送信します。
|
void |
doPassiveScan(java.lang.String host,
int port,
boolean useHttps,
byte[] request,
byte[] response)
パッシブ脆弱性スキャンを実行するよう、Burp ScannerツールにHTTPリクエストを送信します。
|
void |
excludeFromScope(java.net.URL url)
指定されたURLをSuite全体のスコープから除外します。
|
void |
exitSuite(boolean promptUser)
Burpプログラムをシャットダウンします。ユーザにプロンプトも表示できます。
|
void |
generateScanReport(java.lang.String format,
IScanIssue[] issues,
java.io.File file)
指定したScannerの問題についてのレポートを生成します。
|
java.lang.String[] |
getBurpVersion()
拡張が実行されているBurpのバージョンに関する情報を取得します。
|
java.lang.String[] |
getCommandLineArguments()
Burp起動時に渡されたコマンドライン引数を返します。
|
java.util.List<IContextMenuFactory> |
getContextMenuFactories()
拡張が登録したコンテキストメニューファクトリを取得します。
|
java.util.List<ICookie> |
getCookieJarContents()
Burpのセッションハンドリングcookie jarファイルの内容を取得します。
|
java.lang.String |
getExtensionFilename()
現在の拡張が読み込まれたファイルの絶対パス名を取得します。
|
java.util.List<IExtensionStateListener> |
getExtensionStateListeners()
拡張が登録した拡張状態リスナーを取得します。
|
java.lang.String[] |
getHeaders(byte[] message)
非推奨。
代わりに
IExtensionHelpers.analyzeRequest() またはIExtensionHelpers.analyzeResponse() を使用してください。 |
IExtensionHelpers |
getHelpers()
多数の有用なタスクを拡張で実行するために使われる
IExtensionHelpers オブジェクトを取得します。 |
java.util.List<IHttpListener> |
getHttpListeners()
拡張が登録したHTTPリスナーを取得します。
|
java.util.List<IIntruderPayloadGeneratorFactory> |
getIntruderPayloadGeneratorFactories()
拡張が登録したIntruderペイロードジェネレータファクトリを取得します。
|
java.util.List<IIntruderPayloadProcessor> |
getIntruderPayloadProcessors()
拡張が登録したIntruderペイロードプロセッサを取得します。
|
java.util.List<IMessageEditorTabFactory> |
getMessageEditorTabFactories()
拡張が登録したメッセージエディタタブのファクトリを取得します。
|
java.lang.String[][] |
getParameters(byte[] request)
非推奨。
代わりに
IExtensionHelpers.analyzeRequest() を使用してください。 |
IHttpRequestResponse[] |
getProxyHistory()
Proxy履歴のすべてにアイテムの詳細を返します。
|
java.util.List<IProxyListener> |
getProxyListeners()
拡張が登録したProxyリスナーを取得します。
|
IScanIssue[] |
getScanIssues(java.lang.String urlPrefix)
指定されたリテラル プレフィックスに一致するURLのスキャンで見つかったすべての問題を返します。
|
java.util.List<IScannerCheck> |
getScannerChecks()
拡張が登録したScannerチェックを取得します。
|
java.util.List<IScannerInsertionPointProvider> |
getScannerInsertionPointProviders()
拡張が登録したScannerの挿入ポイントプロバイダーを取得します。
|
java.util.List<IScannerListener> |
getScannerListeners()
拡張が登録したScannerのリスナーを取得します。
|
java.util.List<IScopeChangeListener> |
getScopeChangeListeners()
拡張が登録したスコープ変更リスナーを取得します。
|
java.util.List<ISessionHandlingAction> |
getSessionHandlingActions()
拡張に登録されたセッションハンドリングアクションを取得します。
|
IHttpRequestResponse[] |
getSiteMap(java.lang.String urlPrefix)
サイトマップ内のアイテムの詳細を返します。
|
java.io.OutputStream |
getStderr()
この拡張の標準エラーストリームを取得します。
|
java.io.OutputStream |
getStdout()
この拡張の標準出力ストリームを取得します。
|
java.lang.String |
getToolName(int toolFlag)
指定されたツールフラグのBurpツールの、わかりやすい名前を取得します。
|
void |
includeInScope(java.net.URL url)
Suite全体スコープに、指定したURLを含めます。
|
boolean |
isExtensionBapp()
この拡張が、BApp (BAppストアのBurpアプリ)として読み込まれたかどうかを判別します。
|
boolean |
isInScope(java.net.URL url)
指定されたURLが、現在のSuite全体スコープ内にあるかどうかを照会します。
|
void |
issueAlert(java.lang.String message)
指定したメッセージを、Burp Suite警告タブに表示します。
|
void |
loadConfig(java.util.Map<java.lang.String,java.lang.String> config)
非推奨。
代わりに
loadConfigFromJson() を使用してください。 |
void |
loadConfigFromJson(java.lang.String config)
指定されたJSON文字列から、プロジェクトレベルの設定を新しく読み込みます。
|
java.lang.String |
loadExtensionSetting(java.lang.String name)
メソッド
saveExtensionSetting() を使用して保存された、拡張の設定を読み込みます。 |
byte[] |
makeHttp2Request(IHttpService httpService,
java.util.List<IHttpHeader> headers,
byte[] body)
HTTP/2リクエストを発行し、レスポンスを取得します。
|
byte[] |
makeHttp2Request(IHttpService httpService,
java.util.List<IHttpHeader> headers,
byte[] body,
boolean forceHttp2)
HTTP/2リクエストを発行し、レスポンスを取得します。
|
byte[] |
makeHttp2Request(IHttpService httpService,
java.util.List<IHttpHeader> headers,
byte[] body,
boolean forceHttp2,
java.lang.String connectionIdentifier)
HTTP/2リクエストを発行し、レスポンスを取得します。
|
IHttpRequestResponse |
makeHttpRequest(IHttpService httpService,
byte[] request)
HTTPリクエストを発行し、レスポンスを取得します。
|
IHttpRequestResponse |
makeHttpRequest(IHttpService httpService,
byte[] request,
boolean forceHttp1)
HTTPリクエストを発行し、レスポンスを取得します。
|
byte[] |
makeHttpRequest(java.lang.String host,
int port,
boolean useHttps,
byte[] request)
HTTPリクエストを発行し、レスポンスを取得します。
|
byte[] |
makeHttpRequest(java.lang.String host,
int port,
boolean useHttps,
byte[] request,
boolean forceHttp1)
HTTPリクエストを発行し、レスポンスを取得します。
|
void |
printError(java.lang.String error)
この拡張の標準エラーストリームに、1行出力します。
|
void |
printOutput(java.lang.String output)
この拡張の標準出力ストリームに、1行出力します。
|
void |
registerContextMenuFactory(IContextMenuFactory factory)
カスタムコンテキストメニューアイテムのファクトリーを登録します。
|
void |
registerExtensionStateListener(IExtensionStateListener listener)
拡張の状態変化を通知されるリスナーを登録します。
|
void |
registerHttpListener(IHttpListener listener)
任意のBurpツールが作成したリクエストやレスポンスが通知されるリスナーを登録します。
|
void |
registerIntruderPayloadGeneratorFactory(IIntruderPayloadGeneratorFactory factory)
Intruderペイロードのファクトリーを登録します。
|
void |
registerIntruderPayloadProcessor(IIntruderPayloadProcessor processor)
拡張が登録したIntruderペイロードプロセッサを取得します。カスタムIntruderペイロードプロセッサを登録します。
|
void |
registerMenuItem(java.lang.String menuItemCaption,
IMenuItemHandler menuItemHandler)
非推奨。
代わりに
registerContextMenuFactory() を使用してください。 |
void |
registerMessageEditorTabFactory(IMessageEditorTabFactory factory)
カスタムメッセージエディタタブのファクトリーを登録します。
|
void |
registerProxyListener(IProxyListener listener)
Proxyツールに処理されているリクエストとレスポンスが通知されるリスナーを登録します。
|
void |
registerScannerCheck(IScannerCheck check)
カスタムScannerチェックを登録します。
|
void |
registerScannerInsertionPointProvider(IScannerInsertionPointProvider provider)
Scanner挿入ポイントのプロバイダーを登録します。
|
void |
registerScannerListener(IScannerListener listener)
Scannerツールが報告した新規の問題が通知されるリスナーを登録します。
|
void |
registerScopeChangeListener(IScopeChangeListener listener)
BurpのSuite全体のターゲットスコープの変更が通知されるリスナーを登録します。
|
void |
registerSessionHandlingAction(ISessionHandlingAction action)
カスタムセッションハンドリングアクションを登録します。
|
void |
removeContextMenuFactory(IContextMenuFactory factory)
拡張が登録したコンテキストメニューファクトリーを削除します。
|
void |
removeExtensionStateListener(IExtensionStateListener listener)
拡張が登録した拡張状態リスナーを削除します。
|
void |
removeHttpListener(IHttpListener listener)
拡張が登録したHTTPリスナーを削除します。
|
void |
removeIntruderPayloadGeneratorFactory(IIntruderPayloadGeneratorFactory factory)
拡張が登録したIntruderペイロードジェネレータファクトリを削除します。
|
void |
removeIntruderPayloadProcessor(IIntruderPayloadProcessor processor)
拡張が登録したIntruderペイロードプロセッサを削除します。
|
void |
removeMessageEditorTabFactory(IMessageEditorTabFactory factory)
拡張が登録したメッセージエディタタブのファクトリを削除します。
|
void |
removeProxyListener(IProxyListener listener)
拡張が登録したProxyリスナーを削除します。
|
void |
removeScannerCheck(IScannerCheck check)
拡張が登録したScannerチェックを削除します。
|
void |
removeScannerInsertionPointProvider(IScannerInsertionPointProvider provider)
拡張が登録したScanner挿入ポイントプロバイダーを削除します。
|
void |
removeScannerListener(IScannerListener listener)
拡張が登録したScannerリスナーを削除します。
|
void |
removeScopeChangeListener(IScopeChangeListener listener)
拡張が登録したスコープ変更リスナーを削除します。
|
void |
removeSessionHandlingAction(ISessionHandlingAction action)
拡張が登録したセッションハンドリングアクションを削除します。
|
void |
removeSuiteTab(ITab tab)
Burp Suiteのメインウィンドウに以前追加したタブを削除します。
|
void |
restoreState(java.io.File file)
非推奨。
ステートファイルは、Burpプロジェクトファイルに置き換えられました。
|
IHttpRequestResponsePersisted |
saveBuffersToTempFiles(IHttpRequestResponse httpRequestResponse)
IHttpRequestResponse オブジェクトのリクエストとレスポンスを一時ファイルに保存し、メモリに保持しないようにします。 |
java.util.Map<java.lang.String,java.lang.String> |
saveConfig()
非推奨。
代わりに
saveConfigAsJson() を使用してください。 |
java.lang.String |
saveConfigAsJson(java.lang.String... configPaths)
現在のプロジェクトレベルの設定をJSON形式で保存します。
|
void |
saveExtensionSetting(java.lang.String name,
java.lang.String value)
拡張やBurp Suiteがリロードされても残り続けるように、拡張の設定を保存します。
|
void |
saveState(java.io.File file)
非推奨。
ステートファイルは、Burpプロジェクトファイルに置き換えられました。
|
ITempFile |
saveToTempFile(byte[] buffer)
指定されたデータを含む一時ファイルをディスクに作成します。
|
void |
sendToComparer(byte[] data)
Compareツールにデータを送信します。
|
void |
sendToIntruder(java.lang.String host,
int port,
boolean useHttps,
byte[] request)
HTTPリクエストをBurp Intruderツールに送信します。
|
void |
sendToIntruder(java.lang.String host,
int port,
boolean useHttps,
byte[] request,
java.util.List<int[]> payloadPositionOffsets)
HTTPリクエストをBurp Intruderツールに送信します。
|
void |
sendToRepeater(java.lang.String host,
int port,
boolean useHttps,
byte[] request,
java.lang.String tabCaption)
HTTPリクエストをBurp Repaterツールに送信します。
|
void |
sendToSpider(java.net.URL url)
開始URLをBurp Spiderツールに送信します。
|
void |
setExtensionName(java.lang.String name)
Extenderツールのユーザインタフェース内に表示される、この拡張の表示名を設定します。
|
void |
setProxyInterceptionEnabled(boolean enabled)
Burp Proxyのマスターインターセプトを設定します。
|
void |
unloadExtension()
拡張をBurp Suiteからアンロードします。
|
void |
updateCookieJar(ICookie cookie)
Burpのセッションハンドリングcookie jarのコンテンツを更新します。
|
static final int TOOL_SUITE
static final int TOOL_TARGET
static final int TOOL_PROXY
static final int TOOL_SPIDER
static final int TOOL_SCANNER
static final int TOOL_INTRUDER
static final int TOOL_REPEATER
static final int TOOL_SEQUENCER
static final int TOOL_DECODER
static final int TOOL_COMPARER
static final int TOOL_EXTENDER
void setExtensionName(java.lang.String name)
name
- 拡張名。IExtensionHelpers getHelpers()
IExtensionHelpers
オブジェクトを取得します。java.io.OutputStream getStdout()
java.io.OutputStream getStderr()
void printOutput(java.lang.String output)
output
- 出力するメッセージ。void printError(java.lang.String error)
error
- 出力するメッセージ。void registerExtensionStateListener(IExtensionStateListener listener)
listener
- 拡張が作成した、IExtensionStateListener
インタフェースを実装したオブジェクト。java.util.List<IExtensionStateListener> getExtensionStateListeners()
void removeExtensionStateListener(IExtensionStateListener listener)
listener
- 削除する拡張状態リスナー。void registerHttpListener(IHttpListener listener)
listener
- 拡張が作成した、IHttpListener
インタフェースを実装したオブジェクト。java.util.List<IHttpListener> getHttpListeners()
void removeHttpListener(IHttpListener listener)
listener
- 削除するHTTPリスナー。void registerProxyListener(IProxyListener listener)
listener
- 拡張が作成した、IProxyListener
インタフェースを実装したオブジェクト。java.util.List<IProxyListener> getProxyListeners()
void removeProxyListener(IProxyListener listener)
listener
- 削除するProxyリスナー。void registerScannerListener(IScannerListener listener)
listener
- 拡張が作成した、IScannerListener
インタフェースを実装したオブジェクト。java.util.List<IScannerListener> getScannerListeners()
void removeScannerListener(IScannerListener listener)
listener
- 削除するScannerリスナー。void registerScopeChangeListener(IScopeChangeListener listener)
listener
- 拡張が作成した、IScopeChangeListener
インタフェースを実装したオブジェクト。java.util.List<IScopeChangeListener> getScopeChangeListeners()
void removeScopeChangeListener(IScopeChangeListener listener)
listener
- 削除するスコープ変更リスナー。void registerContextMenuFactory(IContextMenuFactory factory)
factory
- 拡張が作成した、IContextMenuFactory
インタフェースを実装したオブジェクト。java.util.List<IContextMenuFactory> getContextMenuFactories()
void removeContextMenuFactory(IContextMenuFactory factory)
factory
- 削除するコンテキストメニューファクトリー。void registerMessageEditorTabFactory(IMessageEditorTabFactory factory)
IMessageEditorTab
オブジェクトの新規インスタンスを提供するよう要求されます。factory
- 拡張が作成した、IMessageEditorTabFactory
インタフェースを実装したオブジェクト。java.util.List<IMessageEditorTabFactory> getMessageEditorTabFactories()
void removeMessageEditorTabFactory(IMessageEditorTabFactory factory)
factory
- 削除するメッセージエディタタブファクトリー。void registerScannerInsertionPointProvider(IScannerInsertionPointProvider provider)
provider
- 拡張が作成した、IScannerInsertionPointProvider
インタフェースを実装したオブジェクト。java.util.List<IScannerInsertionPointProvider> getScannerInsertionPointProviders()
void removeScannerInsertionPointProvider(IScannerInsertionPointProvider provider)
provider
- 削除するScanner挿入ポイントプロバイダー。void registerScannerCheck(IScannerCheck check)
check
- 拡張が作成した、IScannerCheck
インタフェースを実装したオブジェクト。java.util.List<IScannerCheck> getScannerChecks()
void removeScannerCheck(IScannerCheck check)
check
- 削除するScannerチェック。void registerIntruderPayloadGeneratorFactory(IIntruderPayloadGeneratorFactory factory)
IIntruderPayloadGenerator
オブジェクトの新規インスタンスを提供するよう要求されます。factory
- 拡張が作成した、IIntruderPayloadGeneratorFactory
インタフェースを実装したオブジェクト。java.util.List<IIntruderPayloadGeneratorFactory> getIntruderPayloadGeneratorFactories()
void removeIntruderPayloadGeneratorFactory(IIntruderPayloadGeneratorFactory factory)
factory
- 削除するIntruderペイロード生成ファクトリー。void registerIntruderPayloadProcessor(IIntruderPayloadProcessor processor)
processor
- 拡張が作成した、IIntruderPayloadProcessor
インタフェースを実装したオブジェクト。java.util.List<IIntruderPayloadProcessor> getIntruderPayloadProcessors()
void removeIntruderPayloadProcessor(IIntruderPayloadProcessor processor)
processor
- 削除するIntruderペイロードプロセッサ。void registerSessionHandlingAction(ISessionHandlingAction action)
action
- 拡張が作成した、ISessionHandlingAction
インタフェースを実装したオブジェクト。java.util.List<ISessionHandlingAction> getSessionHandlingActions()
void removeSessionHandlingAction(ISessionHandlingAction action)
action
- 削除する拡張セッションハンドリングアクション。void unloadExtension()
void addSuiteTab(ITab tab)
tab
- 拡張が作成した、ITab
インタフェースを実装したオブジェクト。void removeSuiteTab(ITab tab)
tab
- 拡張が作成した、ITab
インタフェースを実装したオブジェクト。void customizeUiComponent(java.awt.Component component)
component
- カスタマイズするUIコンポーネント。IMessageEditor createMessageEditor(IMessageEditorController controller, boolean editable)
controller
- 拡張が作成した、IMessageEditorController
インタフェースを実装したオブジェクト。このパラメータはオプションで、null
も可能です。指定された場合メッセージエディタは、現在表示されているメッセージの詳細を取得する必要があるときに、メッセージに対するIHttpService
と、関連するリクエストやレスポンスメッセージとともに、コントローラーに問い合わせを行います。コントローラーが提供されていない場合メッセージエディタは、他のBurpツールへのリクエスト送信などのコンテキストメニューアクションをサポートしません。editable
- 作成されたエディタが編集可能か、表示のみかを指定します。IMessageEditor
インタフェースを実装し、拡張が独自のUIを使用するオブジェクト。java.lang.String[] getCommandLineArguments()
void saveExtensionSetting(java.lang.String name, java.lang.String value)
loadExtensionSetting()
メソッドを使用して取得できます。name
- 設定の名前。value
- 設定の値。この値がnull
の場合、指定された名前の既存の設定が削除されます。java.lang.String loadExtensionSetting(java.lang.String name)
saveExtensionSetting()
を使用して保存された、拡張の設定を読み込みます。name
- 設定の名前。null
。ITextEditor createTextEditor()
ITextEditor
インタフェースを実装し、拡張が独自のUIを使用するオブジェクト。void sendToRepeater(java.lang.String host, int port, boolean useHttps, byte[] request, java.lang.String tabCaption)
host
- リモートHTTPサーバのホスト名。port
- リモートHTTPサーバのポート。useHttps
- プロトコルがHTTPSかHTTPかのフラグ。request
- HTTPリクエスト全体。tabCaption
- リクエストを含むRepeaterタブの表示名(オプション)。この値がnull
の場合、デフォルトのタブインデックスが表示されます。void sendToIntruder(java.lang.String host, int port, boolean useHttps, byte[] request)
host
- リモートHTTPサーバのホスト名。port
- リモートHTTPサーバのポート。useHttps
- プロトコルがHTTPSかHTTPかのフラグ。request
- HTTPリクエスト全体。void sendToIntruder(java.lang.String host, int port, boolean useHttps, byte[] request, java.util.List<int[]> payloadPositionOffsets)
host
- リモートHTTPサーバのホスト名。port
- リモートHTTPサーバのポート。useHttps
- プロトコルがHTTPSかHTTPかのフラグ。request
- HTTPリクエスト全体。payloadPositionOffsets
- 使用されるペイロードポジションを表すインデックスペアのリスト。リスト内の各アイテムは、ペイロードポジションの開始オフセットと終了オフセットを含むint[2]配列でなければなりません。void sendToComparer(byte[] data)
data
- Comparerに送信するデータ。void sendToSpider(java.net.URL url)
url
- 巡回を開始する開始URL。IScanQueueItem doActiveScan(java.lang.String host, int port, boolean useHttps, byte[] request)
host
- リモートHTTPサーバのホスト名。port
- リモートHTTPサーバのポート。useHttps
- プロトコルがHTTPSかHTTPかのフラグ。request
- HTTPリクエスト全体。IScanQueueItem doActiveScan(java.lang.String host, int port, boolean useHttps, byte[] request, java.util.List<int[]> insertionPointOffsets)
host
- リモートHTTPサーバのホスト名。port
- リモートHTTPサーバのポート。useHttps
- プロトコルがHTTPSかHTTPかのフラグ。request
- HTTPリクエスト全体。insertionPointOffsets
- スキャンされる挿入ポイントの位置を表す、インデックスのペア。リスト内の各アイテムは、挿入ポイントの開始オフセットと終了オフセットを含むint[2]配列でなければなりません。void doPassiveScan(java.lang.String host, int port, boolean useHttps, byte[] request, byte[] response)
host
- リモートHTTPサーバのホスト名。port
- リモートHTTPサーバのポート。useHttps
- プロトコルがHTTPSかHTTPかのフラグ。request
- HTTPリクエスト全体。response
- HTTPレスポンス全体。IHttpRequestResponse makeHttpRequest(IHttpService httpService, byte[] request)
httpService
- 送信されるリクエストのHTTPサービス。request
- HTTPリクエスト全体。IHttpRequestResponse
インタフェースを実装し、拡張がレスポンスの詳細を照会できるオブジェクト。IHttpRequestResponse makeHttpRequest(IHttpService httpService, byte[] request, boolean forceHttp1)
httpService
- 送信されるリクエストのHTTPサービス。request
- HTTPリクエスト全体。forceHttp1
- trueの場合、HTTP/1が使用されます。IHttpRequestResponse
インタフェースを実装し、拡張がレスポンスの詳細を照会できるオブジェクト。byte[] makeHttpRequest(java.lang.String host, int port, boolean useHttps, byte[] request)
host
- リモートHTTPサーバのホスト名。port
- リモートHTTPサーバのポート。useHttps
- プロトコルがHTTPSかHTTPかのフラグ。request
- HTTPリクエスト全体。byte[] makeHttpRequest(java.lang.String host, int port, boolean useHttps, byte[] request, boolean forceHttp1)
host
- リモートHTTPサーバのホスト名。port
- リモートHTTPサーバのポート。useHttps
- プロトコルがHTTPSかHTTPかのフラグ。request
- HTTPリクエスト全体。forceHttp1
- trueの場合、HTTP/1が使用されます。byte[] makeHttp2Request(IHttpService httpService, java.util.List<IHttpHeader> headers, byte[] body)
httpService
- 送信されるリクエストのHTTPサービス。headers
- リクエストヘッダ。body
- リクエストボディ。byte[] makeHttp2Request(IHttpService httpService, java.util.List<IHttpHeader> headers, byte[] body, boolean forceHttp2)
httpService
- 送信されるリクエストのHTTPサービス。headers
- リクエストヘッダ。body
- リクエストボディ。forceHttp2
- このリクエストに対してHTTP/2を強制するかどうか。byte[] makeHttp2Request(IHttpService httpService, java.util.List<IHttpHeader> headers, byte[] body, boolean forceHttp2, java.lang.String connectionIdentifier)
httpService
- 送信されるリクエストのHTTPサービス。headers
- リクエストヘッダ。body
- リクエストボディ。forceHttp2
- このリクエストに対してHTTP/2を強制するかどうか。connectionIdentifier
- 使用したい接続の識別子。boolean isInScope(java.net.URL url)
url
- クエリーするURL。true
を返します。void includeInScope(java.net.URL url)
url
- Suite全体スコープに含めるURL。void excludeFromScope(java.net.URL url)
url
- Suite全体スコープから除外するURL。void issueAlert(java.lang.String message)
message
- 表示する警告メッセージ。IHttpRequestResponse[] getProxyHistory()
IHttpRequestResponse[] getSiteMap(java.lang.String urlPrefix)
urlPrefix
- サイトマップの指定したサブセットを抽出するための、URLプレフィックスの指定に使用されます。このメソッドは単純な大文字小文字を区別するテキストマッチを実行し、サイトマップ内のアイテムで指定したプレフィックスで始まるURLのものを返します。nullの場合、サイトマップ全体が返されます。IScanIssue[] getScanIssues(java.lang.String urlPrefix)
urlPrefix
- スキャン項目の指定したサブセットを抽出するための、URLプレフィックスの指定に使用されます。このメソッドは単純な大文字小文字を区別するテキストマッチを実行し、全スキャン項目内のアイテムで指定したプレフィックスで始まるURLのものを返します。nullの場合、すべての項目が返されます。void generateScanReport(java.lang.String format, IScanIssue[] issues, java.io.File file)
format
- レポートで使用する形式。指定できる値は、HTMLとXMLです。issues
- レポートするScanner項目。file
- レポートを保存するファイル。java.util.List<ICookie> getCookieJarContents()
ISessionHandlingAction
を実装すると、cookie jarの照会と更新をし、通常とは異なるセッションハンドリングメカニズムを処理できます。ICookie
オブジェクトの一覧。void updateCookieJar(ICookie cookie)
ISessionHandlingAction
を実装すると、cookie jarの照会と更新をし、通常とは異なるセッションハンドリングメカニズムを処理できます。cookie
- 更新するcookieの詳細を含んだICookie
オブジェクト。指定されたドメインと名前に一致するcookieが既にcookie jarにある場合、新しい値と有効期限でcookieが更新され、新しい値がnull
の場合cookieは削除されます。指定されたドメインと名前に一致するcookieがcookie jarにない場合、cookieが追加されます。void addToSiteMap(IHttpRequestResponse item)
item
- サイトマップに追加するアイテムの詳細。@Deprecated void restoreState(java.io.File file)
file
- Burpのステートが保存されたファイル。@Deprecated void saveState(java.io.File file)
file
- Burpのステートを保存するファイル。@Deprecated java.util.Map<java.lang.String,java.lang.String> saveConfig()
saveConfigAsJson()
を使用してください。@Deprecated void loadConfig(java.util.Map<java.lang.String,java.lang.String> config)
loadConfigFromJson()
を使用してください。config
- Burpの新規設定として使用する、名前/値のマップ。java.lang.String saveConfigAsJson(java.lang.String... configPaths)
configPaths
- 含める各設定セクションへのパスを表す、文字列のリスト。void loadConfigFromJson(java.lang.String config)
config
- 新規設定を含んだJSON文字列。void setProxyInterceptionEnabled(boolean enabled)
enabled
- Proxyメッセージのインターセプトを有効にするかどうか。java.lang.String[] getBurpVersion()
java.lang.String getExtensionFilename()
boolean isExtensionBapp()
void exitSuite(boolean promptUser)
promptUser
- ユーザにシャットダウンの確認をするかどうか。ITempFile saveToTempFile(byte[] buffer)
buffer
- 一時ファイルに保存するデータ。ITempFile
インタフェースを実装したオブジェクト。IHttpRequestResponsePersisted saveBuffersToTempFiles(IHttpRequestResponse httpRequestResponse)
IHttpRequestResponse
オブジェクトのリクエストとレスポンスを一時ファイルに保存し、メモリに保持しないようにします。IHttpRequestResponse
オブジェクトを、長期保存に適した形式に変換します。httpRequestResponse
- 一時ファイルに保存するリクエストとレスポンスメッセージのIHttpRequestResponse
オブジェクト。IHttpRequestResponsePersisted
インタフェースを実装したオブジェクト。IHttpRequestResponseWithMarkers applyMarkers(IHttpRequestResponse httpRequestResponse, java.util.List<int[]> requestMarkers, java.util.List<int[]> responseMarkers)
httpRequestResponse
- マーカを適用するIHttpRequestResponse
オブジェクト。requestMarkers
- リクエストメッセージに適用するマーカのオフセットを示すインデックスペアのリスト。リスト内の各アイテムは、マーカの開始オフセットと終了オフセットを含むint[2]配列でなければなりません。リスト内のマーカは、連続していて、重なっていない必要があります。このパラメータはオプションで、リクエストマーカが必要ない場合はnull
にしてください。responseMarkers
- レスポンスメッセージに適用するマーカのオフセットを示すインデックスペアのリスト。リスト内の各アイテムは、マーカの開始オフセットと終了オフセットを含むint[2]配列でなければなりません。リスト内のマーカは、連続していて、重なっていない必要があります。このパラメータはオプションで、レスポンスマーカが必要ない場合はnull
にしてください。IHttpRequestResponseWithMarkers
インタフェースを実装したオブジェクト。java.lang.String getToolName(int toolFlag)
toolFlag
- Burpツールを識別するフラグ( TOOL_PROXY
、TOOL_SCANNER
など)。ツールフラグはこのインタフェース内で定義されています。void addScanIssue(IScanIssue issue)
IScannerCheck
を使用して実装し、そのチェック経由で問題を報告してください。このメソッドは、他のスキャンツールから結果をインポートするなど、通常のテストワークフロー以外のタスクに対してのみ設計されています。issue
- 拡張が作成した、IScanIssue
インタフェースを実装したオブジェクト。IBurpCollaboratorClientContext createBurpCollaboratorClientContext()
IBurpCollaboratorClientContext
の新規インスタンス。@Deprecated java.lang.String[][] getParameters(byte[] request)
IExtensionHelpers.analyzeRequest()
を使用してください。request
- 分析するリクエスト。String[] { name, value, type }
配列。@Deprecated java.lang.String[] getHeaders(byte[] message)
IExtensionHelpers.analyzeRequest()
またはIExtensionHelpers.analyzeResponse()
を使用してください。message
- 分析するリクエスト。@Deprecated void registerMenuItem(java.lang.String menuItemCaption, IMenuItemHandler menuItemHandler)
registerContextMenuFactory()
を使用してください。menuItemCaption
- メニューアイテムに表示する見出し。menuItemHandler
- メニューアイテムがクリックされたときに呼び出されるハンドラー。