Running SecurityTests from the command-line is straightforward using the included securitytestrunner.bat/.sh script, which takes a number of arguments to control which SecurityTest(s) to run, output, etc:
- e : The endpoint to use when invoking test-requests, overrides the endpoint set in the project file
- h : The host:port to use when invoking test-requests, overrides only the host part of the endpoint set in the project file
- s : The TestSuite containging the SecurityTests to run, used to narrow down the tests to run
- c : The TestCase containging the SecurityTests to run, used to narrow down the tests to run
- n : The name of the SecurityTest to run
- u : The username to use in any authentications, overrides any username set for any TestRequests
- p : The password to use in any authentications, overrides any password set for any TestRequests
- w : Sets the WSS password type, either 'Text' or 'Digest'
- d : The domain to use in any authentications, overrides any domain set for any TestRequests
- r : Turns on printing of a small summary report (see below)
- f : Specifies the root folder to which test results should be exported (see below)
- j : Turns on exporting of JUnit-compatible reports, see below
- a : Turns on exporting of all test results, not only errors
- o : Opens the generated report in a browser (ReadyAPI only)
- i : Enables soapUI UI-related components, required if you use the UISupport class for prompting or displaying information
- t : Sets the soapui-settings.xml file to use, required if you have custom proxy, ssl, http, etc setting
- x : Sets project password for decryption if project is encrypted
- v : Sets password for soapui-settings.xml file
- D : Sets system property with name=value
- G : Sets global property with name=value
- P : Sets project property with name=value
- S : Sets to save the project file after tests have been run
- I : Do not stop if error occurs, ignore them
- R : Selects which report to generate for the test objects executed, for example if running the entire project, this could specify the name of a test-suite-level report that would be generated for each TestSuite. The report is saved as specified with the -F option to the folder specified with the -f option. (ReadyAPI only)
- F : Sets the format of the report specified with the -R option, for Printable reports this is one of PDF, XLS, HTML, RTF, CSV, TXT, and XML. For Data Export this is either XML or CSV (ReadyAPI only)
- g : Sets the output to include Coverage HTML reports ( ReadyAPI only )
So for example:
securitytestrunner.bat -FPDF -R"SecurityTest Report" c:\projects\my-soapui-project.xml
Runs all tests in the specified my-soapui-project.xml file and creates the default SecurityTest report available with ReadyAPI.