Integrate Enterprise Applications with Oracle IoT Cloud Service

Integrate your enterprise application to send, receive, and manage Oracle Internet of Things Cloud Service device data.

See Developing Enterprise Applications That Use Oracle IoT Cloud Service to learn about the typical workflow for developing enterprise applications.

1. Open the Oracle Internet of Things Cloud Service Management Console. See Access Oracle IoT Cloud Service.
2. Click the Menu () icon adjacent to the Oracle Internet of Things Cloud Service title on the Management Console.
3. Click Applications.
4. Click an application.
5. Click Integration.
6. Select one of these options:
   • If you have not previously created an integration, click Create Integration and then select Enterprise Application.
   • If you have previously created an integration, click the Add () icon and then select Enterprise Application.
7. Complete these fields:
   • Name: Enter a unique name for the Oracle Internet of Things Cloud Service integration.
   • Description: Enter an optional description for the Oracle Internet of Things Cloud Service integration.
   • URL: Enter the URL that Oracle Internet of Things Cloud Service will use to transfer data.
8. (Optional) Click Verify Connectivity to test the connection between theOracle Internet of Things Cloud Service instance and the target service or application.
   The connectivity test can include:

   • DNS Resolution Test: Checks whether the server name resolves to an IP address.

   • Connectivity Test: Checks whether the IP address is reachable.

   • IP/Port test: Checks whether you can talk to the target URL on the specified port.

   • SSL Verification Test: Checks whether you have a secured, or trusted, connection to the target. Applies only if the target is an SSL endpoint.

   • Authentication Test: Checks whether you can exchange messages with the target.

9. Click Create.
10. Select the integration in the Integrations list and then click the Edit () icon.
11. To manage devices using the enterprise application:
    1. Click the Overview tab.
    2. Enter a password in the File Protection Password field to encrypt the provisioning file that contains the configuration and credentials to activate your integration.
    3. Enter the password again in the Confirm Password field.
    4. Click Download Provisioning File.
    5. Click Save File.
    6. Browse to a location to save the file and then click Save.
    7. Click the Connection tab.
    8. Enter a URL in the URL field.
       If you intend to use the enterprise application to control and manage devices, enter a value such as http://notused.
12. To send unmodified device data to an enterprise application listening on an HTTP URL endpoint:
    1. Click the Connection tab.
    2. Enter the URL for the enterprise application server in the URL field.
    3. Select Enable authentication for this URL if user authentication is used on the enterprise application server.
    4. Enter a user name in the Username field.
    5. Enter a password in the Password field.
13. (Optional) To add headers to the outgoing HTTP requests being sent to your enterprise application:

    Note:

    By default, the Content-Type; application/json header is included when the integration is created.
    1. Click the Custom Headers tab.
    2. Click Create a Header.
    3. Enter a name for the header in the Header Name field.
    4. Enter a value for the header in the Header Value field.
    5. Click the Add () icon to add another header.
14. Add a stream to the integration:
    1. Click the Streams tab.
    2. Click Create a Stream.
    3. Select a message format in the Message Format list.
       The same message format cannot be used by multiple streams. Select a unique message format for each stream you create.
    4. Select annotations in the Annotations list. Annotations identify the metadata sent to the enterprise application.

       If you previously created custom metadata keys for your devices and streams, then these also appear in the list of annotations.

       You can also type a new annotation name and select the data type for the annotation.

    5. Click the Add () icon to add another stream.
15. Click the Messages tab to view integration messages.
16. Click Save .