Security TestRunner Arguments

The fully qualified path to the project that contains the security tests to be run. If the file name or path includes spaces, enclose the entire argument in quotes.

Examples:

C:\Work\readyapi-project.xml
C:\Work\composite-project

Specifies whether the runner will export all the generated test results. If you skip this argument, the runner will export only errors.

Commands the runner to create folders and subfolders for the test results of test suites and test cases. The folders are organized into a structure that is similar to the structure of the corresponding test suites and test cases. To specify the root directory, use the ‑f argument.

If you skip the -A argument, the runner will save all the files containing the results to the directory that the ‑f argument specifies. The file names will include the names of the test suite and test case.

The runner ignores this attribute depending on the -R command-line argument value.

Specifies the test case to be run.

In ReadyAPI, the names of the parent test suite and test case are shown in the security test editor right after the security test name in the following format: <security test> (<test suite> -> <test case>):

If you do not specify this argument, the runner will launch all the security tests that relate to the parent test suite. Also, see the description of the -s argument.

Example:

"-cTest Case 1"

Specifies the Client ID for SLM On-premises license Server when configured for OIDC. Please see here for instructions on configuring SLM on-premises for OIDC and how to access the credentials.

Specifies the Client Secret for SLM On-premises license Server when configured for OIDC. Please see here for instructions on configuring SLM on-premises for OIDC and how to access the credentials.

Specifies the domain the simulated requests will use for authorization.

This argument overrides the authorization domain specified for test steps in your test project.

Assigns a value to a system property for the test run. The specified value will override the current system property value during the test run.

Usage: -D<variable>=<value>. If the value includes spaces, enclose the entire argument in quotes. To override several variable values, specify the -D argument several times.

Example:

-Dtest.history.disabled=true

Specifies the endpoint to be used in test requests. The specified endpoint should include the protocol part (for example, https://).

This argument overrides the endpoints specified for test steps in your test project. See the description of the -h argument, as well.

Example:

-ehttp://www.soapui.org/sample

Specifies the environment to be used during the test run. If specified, ‑e, ‑u, and ‑p parameters so that the values are taken from the environment.

Example:

-ENewEnvironment

Specifies the root directory where the runner will save the files containing the test results. If the specified directory does not exist, it will be created.

Example:

-fC:\Work\ReadyAPI-test-results

Specifies the format of the exported reports. Usage: -F<FormatName>. The supported formats include: PDF, XLS, HTML, RTF, CSV, TXT, XML.

To export results in several formats, separate them with commas. For example, ‑FPDF, XML, CSV.

The runner ignores the -F argument depending on the value of the -R argument. See the description of the -R argument below.

Assigns a value to a global property for the test run. The specified value will override the current global property value during the test run. Usage: -G<variable>=<value>. If the value includes spaces, enclose the entire argument in quotes. To override several variable values, specify the -G argument several times.

Example:

-Gglobal.property=true

Specifies the host and port to be used in test requests.

Usage: -h<host>:<port>. To specify the host, use its IP address or name.

This argument overrides the endpoints specified in the project file. See the description of the -e argument, as well.

Example:

-h127.46.44.12:80

Use this argument to add a custom HTTP header to all simulated requests.

Usage: -H<header>=<value>. To add several headers, specify the -H argument several times.

Example:

-Hx-content-type-options=nosniff

Commands the runner to enable UI-related components. Use this command-line argument when using the UISupport class in your tests.

Commands the runner to ignore errors. If you specify this argument in the command line, the test log will contain no information on the errors that occurred during the test run.

If you skip this argument, the runner will stop the run on the first error that occurs and will post full information about the error to the log.

Commands the runner to generate JUnit-compatible reports.

Commands the runner to create an XML file with brief test results. This argument does not depend on other command-line arguments that concern the result export: -F, -R and -A.

The name of the security test to be run. Usage -n<security-test-name>. If the test name includes spaces, enclose the entire parameter in quotes. If this parameter is not specified, the runner will execute all the security tests of the specified test case.

Example:

-nSecurityTest1

Commands the runner to open the generated reports in your default web browser after the test run is over.

Commands the runner not to collect or send usage statistics.

Assigns a value to a project property for the test run. The specified value will override the current project property value during the test run. Usage: -P<variable>=<value>. If the value includes spaces, enclose the entire argument in quotes. To override several variable values, specify the -P argument several times.

Example:

-Pproject.property=true

Specifies the password to be used during the test run for authorization.

This argument overrides the authorization password specified in your test project.

Commands the runner to include a summary report in the test log.

Specifies the type of the report data. Usage: -R<Report type>. For The Report type, use one of the following:

Use the -f argument to specify the directory where the runner will save the generated report files.

Example:

-R"SecurityTest Report"

Specifies the test suite to be run.

In ReadyAPI, the names of the parent test suite and test case are shown in the security test editor right after the name of the security test in the following format: <security test> (<test suite> -> <test case>):

If you do not specify this argument, the runner will launch all the security tests of the specified project.

Example:

"-sTest Suite 1"

Commands the runner to save the test project after the test run is over. This command-line argument may be useful if you store data within the project during the test run.

Specifies the ReadyAPI settings file to use during the test run. If you skip this command-line argument, the runner will use the default readyapi-settings.xml file located in the <User directory>/.readyapi directory.

Use this argument to specify another setting file for the run. It helps you use different proxy, SSL, HTTP and other settings without changing them in ReadyAPI.

Also, see the description of the -v argument.

Specifies the username to be used for request authorization.

This argument overrides the usernames specified in your test project.

Specifies the password for the XML settings file.

Also, check the description of the -t argument.

Specifies the WSS password type. Usage: -w<password type>, where <password type> is one of the following:

Specifies the project password in case the project is encrypted.