Create the configuration setting

You create a custom configuration setting for the integration in Oracle Service Cloud.

About this task

All fields are required in the CUSTOM_CFG_IOT_Accel_Integrations custom configuration setting. Any empty string will result in an incorrect configuration and the error message IOT Integration Configuration verb is not set or is incorrect.

The optional valid_ipv4_hosts or valid_ipv6_hosts parameter is used to include an additional security feature, so that incoming SOAP calls will only be accepted if they come from a specific Oracle Integration Cloud Service site. The agentauthenticator.php file contains code to verify that the incoming SOAP call originates from a valid IP address that falls within the range entered. If the range is not entered correctly, the SOAP call from Oracle Integration Cloud Service will fail and return an Authentication Failed error message. Though specifying an IP address range is optional, it is highly recommended that you use it to help secure the integration. Contact your help desk to obtain the IP address range for your instance.

Procedure

In Oracle Service Cloud, click the Configuration button on the navigation pane.
Under Site Configuration, double-click Configuration Settings.
The Configuration Settings editor appears, with the search window open.
Click Cancel to close the search window.
Click New in the ribbon, then select Text.

Fill in the following fields:

Field	Value
Key	CUSTOM_CFG_IoT_Accel_Integrations
Type	Interface
Required	No
Default	{ "rnt_host": "https://your_site_interface", "integration": { "ics_service": { "base_url": "https://ICS_site_URL", "username": "ICS_username", "password": "ICS_password", "get_attributes_url": "/integration/flowapi/rest/GET_DEVICE_ATTR_FRM_IOT/v01", "set_attributes_url": "/integration/flowapi/rest/PUT_APP_DEVICE_ATTR_INTG/v01/v2/apps/app_id/devices/device_id/deviceModels/urn:com:oracle:iot:device:hvac/attributes", "get_messages_url": "/integration/flowapi/rest/OSVC_TO_IOT_GET_DEVIC_MSGS/v01/v2/messages", "valid_ipv4_hosts": "hostIPv4_1, hostIPv4_2, ...", "valid_ipv6_hosts": "hostIPv6_1, hostIPv6_2, ..." }}} where: your_site_interface is the name of your Oracle Service Cloud site, for example, mysite.example.com ICS_site_URL is the URL of your Oracle Integration Cloud Service site, for example, my_ICS_site.example.com ICS_username is the username for accessing the Oracle Integration Cloud Service site ICS_password is the password for the Oracle Integration Cloud Service user app_id is the application ID from creating the application in Oracle Internet of Things Cloud Service device_id is the device ID from registering the device in Oracle Internet of Things Cloud Service hostIPv4_n is a valid IP v4 address range hostIPv6_n is a valid IP v6 address range
Maximum Length	300000

For the specific interface, set the value of the Configuration Base as follows, for example:

{
"rnt_host": "https://mysite.example.com",
"integration": {
"ics_service": {
"base_url": "https://my_ICS_site.example.com",
"username": "jsmith",
"password": "Password1234",
"get_attributes_url": "/integration/flowapi/rest/GET_DEVICE_ATTR_FRM_IOT/v01",
"set_attributes_url": "/integration/flowapi/rest/PUT_APP_DEVICE_ATTR_INTG/v01/v2/apps/AAAAAARXNIIA-AI/devices/
AAAAAARXNIIA-CE/deviceModels/urn:com:oracle:iot:device:hvac/attributes",
"get_messages_url": "/integration/flowapi/rest/OSVC_TO_IOT_GET_DEVIC_MSGS/v01/v2/messages",
"valid_ipv4_hosts": "",
"valid_ipv6_hosts": "21DA:00D3:0000:2F3B::/64, 21DA:00D3:0000:2F2B::/64"
}}}

Click Save & Close.

Results

CUSTOM_CFG_IoT_Accel_Integrations is listed in the Configuration Settings editor when you search for settings in the Custom folder.