Prerequisites for Testing a Robot Locally from the Canvas

To improve the quality of the testing, ensure that the computer where you run the robot, typically your own computer, matches the robot's real-world conditions.
Install the robot agent on the computer where you run the robot. Start at Meet the Robot Agent's Requirements, and complete the prerequisite steps for installing and starting the robot agent.
You don't need to associate the robot with an environment pool or activate the robot.

You MUST complete the following configuration steps:

Note:

Steps 1 to 3 should be completed only for the first time when you test a robot locally from the canvas.

Generate a local PKCS12 keystore.

keytool -genkeypair \
  -alias <example: rpa-test-agent> \
  -keyalg RSA \
  -keysize 2048 \
  -validity 825 \
  -storetype PKCS12 \
  -keystore <example: D:\dev\RPA\rpa-test-agent.p12> \
  -storepass <example: Welcome1234> \
  -keypass <example: Welcome1234> \
  -dname "CN=localhost, OU=RPA, O=Oracle, L=Redwood Shores, ST=CA, C=US" \
  -ext "SAN=DNS:localhost,IP:127.0.0.1"

Export the certificate from keystore.


keytool -exportcert \
  -rfc \
  -alias <example: rpa-test-agent> \
  -keystore <example: D:\dev\RPA\rpa-test-agent.p12> \
  -storetype PKCS12 \
  -storepass <example: Welcome1234> \
  -file <example: D:\dev\RPA\rpa-test-agent.cer>

Import the certificate into the browser trust store.
Import <example: D:\dev\RPA\rpa-test-agent.cer> into your browser or operating system trusted certificates list. This avoids HTTPS trust warnings when calling local robot agent endpoints.

Start the robot agent in test mode on port 443.


java -jar \
  <example: orpa-agent-1.34.172.jar> \
  -test \
  -port 443 \
  -keystore <example: D:\dev\RPA\rpa-test-agent.p12> \
  -storepass  <example: Welcome1234> \
  -keypass  <example: Welcome1234> \
  -storetype PKCS12