Docs
/
Devices
/

Creating a SOAP Device

Creating a SOAP Device

After creating a device with the SOAP protocol, you'll land on its Configuration tab. This is where you provide the connection details Koios needs to communicate with a SOAP web service.

Configuration Fields

SOAP Type

The type of SOAP service you're connecting to. This determines which additional configuration fields are shown.

TypeDescription
RDM (Resource Data Manager)RDM controller with SOAP API
  • Required

Hostname

The URL of the SOAP service endpoint.

  • Required
  • Example: http://192.168.1.100:8080/soap

Timeout (seconds)

How long Koios waits for the SOAP service to respond before giving up.

  • Default: 5 seconds
  • Minimum: 1 second
  • Maximum: 300 seconds (5 minutes)

RDM Username

The username for authenticating with the RDM controller. This field appears when the SOAP type is set to RDM.

  • Required (when type is RDM)

RDM Password

The password for authenticating with the RDM controller. This field appears when the SOAP type is set to RDM.

  • Required (when type is RDM)

RDM Web Authentication

Enable this option if the RDM controller requires web-based authentication in addition to the SOAP credentials.

  • Default: Disabled (unchecked)
  • This field appears when the SOAP type is set to RDM

After Configuration

Once you've filled in the connection settings:

  1. Save the configuration
  2. Test the connection — click the
    Test
    button to verify Koios can reach the SOAP service
  3. Add tags — define the RDM device and parameter for each data point (see Creating a SOAP Tag)
  4. Enable the device — flip the enable switch to start scanning