Package burp.api.montoya.scanner
Interface Scanner
public interface Scanner
[Professional only] Provides access to the functionality of the Scanner tool.
-
Method Summary
Modifier and TypeMethodDescriptionbChecks()
Access functionality related to BChecks.void
generateReport
(List<AuditIssue> issues, ReportFormat format, Path path) Generate a report for the specified Scanner issues.registerAuditIssueHandler
(AuditIssueHandler auditIssueHandler) Register a handler which will be notified of new audit issues that are reported by the Scanner tool.registerInsertionPointProvider
(AuditInsertionPointProvider insertionPointProvider) Register a provider of Scanner insertion points.registerScanCheck
(ScanCheck scanCheck) Register a custom Scanner check.startAudit
(AuditConfiguration auditConfiguration) This method can be used to start an audit in the Burp Scanner tool.startCrawl
(CrawlConfiguration crawlConfiguration) This method can be used to start a crawl in the Burp Scanner tool.
-
Method Details
-
registerAuditIssueHandler
Register a handler which will be notified of new audit issues that are reported by the Scanner tool. Extensions can perform custom analysis or logging of audit issues by registering an audit issue handler.- Parameters:
auditIssueHandler
- An object created by the extension that implements theAuditIssueHandler
interface.- Returns:
- The
Registration
for the handler.
-
registerScanCheck
Register a custom Scanner check. When performing scanning, Burp will ask the check to perform active or passive scanning on the base request, and report any Scanner issues that are identified.- Parameters:
scanCheck
- An object created by the extension that implements theScanCheck
interface.- Returns:
- The
Registration
for the check.
-
registerInsertionPointProvider
Register a provider of Scanner insertion points. For each base request that is actively scanned, Burp will ask the provider to provide any custom Scanner insertion points that are appropriate for the request.- Parameters:
insertionPointProvider
- An object created by the extension that implements theAuditInsertionPointProvider
interface.- Returns:
- The
Registration
for the provider.
-
startCrawl
This method can be used to start a crawl in the Burp Scanner tool.- Returns:
- The
Crawl
started in the Burp Scanner tool.
-
startAudit
This method can be used to start an audit in the Burp Scanner tool.- Returns:
- The
Audit
started in the Burp Scanner tool.
-
generateReport
Generate a report for the specified Scanner issues. The report format can be specified. For all other reporting options, the default settings that appear in the reporting UI wizard are used.- Parameters:
issues
- TheAuditIssue
s issues to be reported.format
- TheReportFormat
to be used in the report.path
- ThePath
to the file that will be saved.
-
bChecks
BChecks bChecks()Access functionality related to BChecks.- Returns:
- An implementation of the
BChecks
interface which exposes BChecks functionality.
-