Specifying Agent Settings

Use the Web Service page to determine the following:

  • Whether to allow Groovy queries of response data and whether cURL commands can be used in RA Web Service REST Agent Jobs

  • Set the password for the certification authority

  • Use the SSL Certificates settings to define and manage a JKS Keystore

Specifying Settings

The Settings section includes the following options.

  • Allow Groovy parsings of response data

    • Allows anyone with access to edit RA Web Service REST Agent Jobs to select Groovy as a query type and include Groovy code as the input when defining queries. By default this option is unchecked for security purposes. When checked, users can define Groovy query types when defining queries from the Response page for Jobs. For more information on REST responses, see Defining Responses for RA Web Service REST Agent Jobs.

  • Allow cURL Commands

    • Allows anyone with access to edit RA Web Service REST Agent Jobs to define cURL commands for their request. For more information on defining RA Web Service REST Agent Jobs, see Defining Requests for RA Web Service REST Agent Jobs.

Updating the Certification Authority Password

If you updated your certification authority password outside of the RA Web Service REST Agent, you need to update it in the Password field in the CA Certificates section. You must then restart the Agent.

Specifying SSL Certificate Settings

Defining a Keystore

The Keystore holds trusted certificates for client/server authentication. To define a keystore:

  1. In the SSL Certificates section, enter a keystore and password in the Keystore and Password fields.

    2. You can browse to the keystore using the browse icon.

  2. Save and close the Agent definition.
  3. Stop and restart processes for the RA Web Service REST Agent solution Agent.
  4. Open your RA Web Service REST Agent solution Agent object again and reselect Web Service tab.

    5. The certificates for the keystore will be listed in the SSL Certificates table.

  5. From the SSL Certificates table, you can:
    • Import a certificate
    • Export a certificate
    • Delete a certificate

Importing a Certificate into the RA Web Service REST Agent Keystore

To import a .der certificate into the RA Web Service REST Agent Agent keystore:

  1. Click Import to open the Import dialog.

    2. On the Import dialog, enter a certificate file and alias in the Certificate File and Certificate Alias fields.

    You can use the browse icon to browse to the certificate file.

  2. Click Import.

Important !

You cannot import .pem certificates. Additionally, if you have a .der certificate that was converted from a .pem format, you may not be able to browse to it.

Exporting a Certificate from the Keystore

To export a certificate from the RA Web Service REST Agent keystore, select the certificate in the table and click Export. The Save file on agent file system dialog will appear. Browse to a or enter an absolute file name you want to export the certificate to, click the Save button to start the export.

Deleting a Certificate from the Keystore

To delete a certificate from the RA Web Service REST Agent keystore, select the certificate and click Delete.