Configure Java API Wrapper Parameters

Veracode APIs

You configure the API wrapper parameters to specify your Veracode API credentials, the actions to perform, and to add parameters.

To enter required parameters to run the API wrapper functions:

  1. Enter this command:
    java -jar vosp-api-wrapper-java{version}.jar -vid <Veracode API ID> -vkey <Veracode API key> -action <action>
    Veracode recommends that you use an external Veracode API credentials file to provide your credentials to the Veracode API wrapper. When you use a Veracode API credentials file, you can omit the -vid and -vkey parameters for specifying your Veracode API credentials.
    For a list of valid actions, run this command with the -help parameter.
    java -jar vosp-api-wrapper-java{version}.jar -help
  2. Review the parsing errors window to identify missing parameters or invalid arguments.
  3. To add missing parameters, run this command:
    java -jar vosp-api-wrapper-java{version}.jar -vid <Veracode API ID> -vkey <Veracode API key> -action <action> -<param1> <arg1> -<param2> <arg2>…

    where <param#> is a missing parameter and <arg#> is the corresponding argument.

Use the optional parameter -inputfilepath to provide the filepath of a CSV file from which to read additional command-line arguments. The correct format of the CSV file is to enter the parameter names in the first row and the corresponding values of those parameters in the subsequent rows.

You can use inputfilepath to make multiple calls to the API specified by the action. In the CSV file, use one row to specify the parameters for each call. For an example, see createuser.do.

The wrapper returns a zero (integer) exit code when a command succeeds.

The wrapper returns a non-zero (integer) exit codes when a command fails:

  • 1 = Invalid input
  • 2 = API internal error
  • 3 = Incorrect file format of the CSV file referred to in the -inputfilepath parameter
  • 4 = The scan did not pass policy compliance. This code only applies to an uploadandscan composite action that specifies the scantimeout parameter.

The Veracode API wrappers return errors for missing required parameters and unrecognized parameters. The API wrappers do not return errors on defined API parameters that are not valid for use with the specified action. For example, if an API wrapper takes sandboxid as an optional parameter and you supply sandboxname in error, the API wrapper ignores sandboxname and executes. You can verify the list of valid parameters in the console or the XML API documentation.

You can also reference the Java API wrapper from Eclipse.