ThingWorx Edge ADO Service > Configuring the ADO Service > How to Perform a Basic Configuration
How to Perform a Basic Configuration
A basic configuration establishes a connection to the ThingWorx platform, authenticates the ADO service, and binds the WebSocket with the entity on ThingWorx platform that represents the device.
The ADO service runs only as a Windows service. You can set it up to be started automatically when the computer starts up. The default setting is that the service must be started manually.
To configure the ADO service to communicate with the ThingWorx platform, follow these steps:
This procedure explains only the parameters you need to set to enable the ADO service to communicate with ThingWorx platform. For details on any of the parameters in AdoThing.config, refer to the Reference for Configuration Parameters.
1. Navigate to the directory where you extracted the ADO zip file.
2. Open the AdoThing.config file in a text editor.
3. In the Connection Settings section of the file, specify the address and port of ThingWorx platform by editing the lines that are in this font:
"rows": [
"Address": "",
"Port": 443,
4. For the ADO service to connect to ThingWorx platform, it must send an authentication message with an Application Key (AppKey) that has been generated by ThingWorx platform. Administrators can generate Application Keys from ThingWorx platform. As long as you have a valid Application Key, you can set the value of the following parameter, substituting your key for the string shown here:
5. Provide the name of the thing on ThingWorx platform that represents the device that will run the ADO service. Before attempting to run the ADO service, you must have created this thing in ThingWorx Composer, using the appropriate remote thing template.
"ThingName": "AdoThing",
6. If you are developing an application, you may have self-signed certificates that you want to use for testing. Alternatively, you may want to disable security temporarily while testing. To prevent errors that will be generated if you use a self-signed certificate, set the following parameter as shown here:
"AllowSelfSignedCertificates": true,
Alternatively, to disable certificate validation, set the following parameter as shown here:
"DisableCertValidation": true,
Always make sure that these properties are set to false in a production environment. For information on setting parameters for certificates, refer to How to Configure a Secure Connection to the ThingWorx Platform.
7. Keep the default values for the remaining parameters in the Connection Settings section. Those values suffice for connecting to the ThingWorx platform. For more information about all the parameters in this section, refer to the table, Reference for Configuration Parameters
8. Save the file.
What’s Next?
Continue to the next section to set up the connection between the ADO service and the SQL database, How to Configure the Settings for an SQL Database Connection