The capabilities described on this page are included in Appian's standard capability tier. Usage limits may apply. |
OverviewCopy link to clipboard
This page guides you through configuring the agent to work with an RPA Console that uses a private SSL certificate. Before you begin, ensure the following conditions are met:
- Your site is already set up with a custom domain and a matching private SSL certificate.
- You have a copy of the SSL certificate (without the private key) named
certificate.cer
. - You have access to a Windows command shell, such as NT Batch or PowerShell.
- A JDK is installed, and the Java keytool utility is available in your path.
This process consists of these three steps: creating the custom keystore for your agent, creating the .l4j.ini
configuration file, and starting the agent. These tasks are typically performed by system administrators or engineers who are responsible for maintaining a secure and reliable IT infrastructure.
Configuring the agent on your host machineCopy link to clipboard
1. Create the custom keystore for the agentCopy link to clipboard
- Export the certificate from your browser:
Tip: These instructions are for Chrome. Steps may vary in other browsers.- Click the Not Secure chip next to the URL in the browser.
- Click the pop-out icon and go to Details > Export.
- Generate the keystore:
- Set the file path and hostname. In the following command, replace
your-custom-domain.com
with your actual custom domain name.1 2
set CERT_FILEPATH=path\to\certificate.cer set HOSTNAME="your-custom-domain.com"
Copy - Run the keytool command to import the certificate. In the following command, replace
password
with the actual password for your keystore.1
keytool -importcert -file %CERT_FILEPATH% -keystore KeyStore.jks -alias %HOSTNAME% -storepass password -noprompt
Copy
- Set the file path and hostname. In the following command, replace
- Place the
KeyStore.jks
file in the same directory as your RPA agent executable.
2. Create the .l4j.ini configuration fileCopy link to clipboard
- In the same directory as your RPA agent executable, create a file named
AppianRPAagent.l4j.ini
. - Add the following lines to the file. Again, replace
password
with the actual password of your keystore.1 2
-Djavax.net.ssl.trustStore=full/path/to/KeyStore.jks -Djavax.net.ssl.trustStorePassword=password
Copy
3. Start the agentCopy link to clipboard
Start the agent by double-clicking the executable file.
FeedbackCopy link to clipboard
Was this page helpful?