{"id":22868519,"url":"https://github.com/datavenueliveobjects/flexible_engine_dis_loconnector_to_install_on_fe","last_synced_at":"2026-03-05T03:33:25.449Z","repository":{"id":38454422,"uuid":"306647211","full_name":"DatavenueLiveObjects/Flexible_Engine_DIS_LOconnector_to_install_on_FE","owner":"DatavenueLiveObjects","description":null,"archived":false,"fork":false,"pushed_at":"2023-02-07T10:51:54.000Z","size":527,"stargazers_count":2,"open_issues_count":0,"forks_count":2,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-06-02T09:06:35.813Z","etag":null,"topics":["flexibleengine","iot","liveobjects","orange"],"latest_commit_sha":null,"homepage":"https://liveobjects.orange-business.com/","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/DatavenueLiveObjects.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-10-23T13:35:31.000Z","updated_at":"2023-01-10T07:22:52.000Z","dependencies_parsed_at":"2023-02-10T08:15:14.400Z","dependency_job_id":null,"html_url":"https://github.com/DatavenueLiveObjects/Flexible_Engine_DIS_LOconnector_to_install_on_FE","commit_stats":null,"previous_names":[],"tags_count":10,"template":false,"template_full_name":null,"purl":"pkg:github/DatavenueLiveObjects/Flexible_Engine_DIS_LOconnector_to_install_on_FE","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DatavenueLiveObjects%2FFlexible_Engine_DIS_LOconnector_to_install_on_FE","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DatavenueLiveObjects%2FFlexible_Engine_DIS_LOconnector_to_install_on_FE/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DatavenueLiveObjects%2FFlexible_Engine_DIS_LOconnector_to_install_on_FE/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DatavenueLiveObjects%2FFlexible_Engine_DIS_LOconnector_to_install_on_FE/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/DatavenueLiveObjects","download_url":"https://codeload.github.com/DatavenueLiveObjects/Flexible_Engine_DIS_LOconnector_to_install_on_FE/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DatavenueLiveObjects%2FFlexible_Engine_DIS_LOconnector_to_install_on_FE/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30108653,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-05T03:32:43.378Z","status":"ssl_error","status_checked_at":"2026-03-05T03:32:22.667Z","response_time":93,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["flexibleengine","iot","liveobjects","orange"],"created_at":"2024-12-13T12:35:38.698Z","updated_at":"2026-03-05T03:33:25.430Z","avatar_url":"https://github.com/DatavenueLiveObjects.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"## Table of contents\n* [General info](#general-info)\n* [Technologies](#technologies)\n* [Requirements](#requirements)\n* [Configuration](#configuration)\n    * [Logging](#logging)\n    * [Connector](#connector)\n* [Installation](#installation)\n\n## General info\nThis repository contains everything you need to create 'Live Objects to FlexibleEngine Data Ingestion Service' connector. This project is intended for Live Objects users wishing to explore integration patterns with FlexibleEngine and for organizations already running business logic on FlexibleEngine planning to work on events from IoT devices sourced via Live Objects.\n\nMain feature is: \n* **messages synchronization** - every message which will be send from device to Live Objects will appear in Data Ingestion Service\n\nOne connector can handle one Live Objects account and one Data Ingestion Service. \n\nIt can be many instances of connector per Live Objects account.\n\nThe software is an open source toolbox which has to be integrated into an end to end solution. The ordering of messages is not guaranteed to be preserved.\nLive Objects platform supports load balancing between multiple MQTT subscribers.\n\n## Technologies\n* Java 8\n* Spring Boot 2.3.4.RELEASE\n\n## Requirements\nIn order to run the connector you need to have: \n* **Live Objects account** \n* **Flexible Engine account with an Data Ingestion Service** \n\n## Configuration\n\n### Connector\nAll configuration can be found in **application.yaml** file located in src/main/resources (in source distribution) or conf (in release zip).\n\n```\n1     lo-mqtt:\n2       hostname: liveobjects.orange-business.com\n3       username: application\n4       api-key: YOUR_API_KEY\n5       topics:\n6         - MESSAGES_TOPIC_1\n7         - MESSAGES_TOPIC_2\n8       recovery-interval: 10000\n9       completion-timeout: 20000\n10      connection-timeout: 30000\n11      qos: 1\n12      keep-alive-interval-seconds: 30  \n13  \n14    flexible-engine:\n15      dis:\n16        endpoint: https://dis.eu-west-0.prod-cloud-ocb.orange-business.com\n17        ask: YOUR_ASK_KEY\n18        sk: YOUR_SK_KEY\n19        projectId: YOUR_PROJECT_ID\n20        region: YOUR_REGION\n21        stream-name: YOUR_STREAM_NAME\n22        message-batch-size: 10\n23        message-sending-fixed-delay: 1000\n24\n25    management:\n26      endpoints:\n27        web:\n28          exposure:\n29            include: info, health, metrics, beans\n```\n\n#### hostname\nREST API endpoint url, leave the value of **https://liveobjects.orange-business.com/api**\n\n#### username\nLive Objects mqtt username (should be set to **application**)\n\n#### api-key\nLive Objects API key with at least DEVICE\\_R, DEVICE\\_W and BUS_R roles\n\nLogin to Live Objects Web Portal an go to **Administration** -\u003e **API keys** \n\n![Api Keys 1](./assets/api_key_1.png) \n\nClick **Add** button and fill fields. \n\n![Api Keys 2](./assets/api_key_2_.png)\n\nTo  validate  the  creation  of  the  key,  click  on  the **Create** button.  Your  key  is  generated  in  the form of an alphanumeric sequence and a QR code.\n\n#### topics\nNames of the FIFO queue for messages\n\n#### recovery-interval\nControls the interval (in miliseconds) at which the mqtt client attempts to reconnect after a failure. It defaults to 10000ms (10 seconds)\n\n#### completion-timeout\nSet the completion timeout for mqtt operations in miliseconds\n\n#### connection-timeout\nThis value, measured in miliseconds, defines the maximum time interval the client will wait for the network connection to the MQTT server to be established\n\n#### qos\nMessage QoS \n\n#### keep-alive-interval-seconds\nThis value, measured in seconds, defines the maximum time interval between messages sent or received. It enables the client to detect if the server is no longer available, without having to wait for the TCP/IP timeout. The client will ensure that at least one message travels across the network within each keep alive period.  In the absence of a data-related message during the time period, the client sends a very small \"ping\" message, which the server will acknowledge. A value of 0 disables keepalive processing in the client.\n\n#### endpoint\nREST API endpoint url, leave the value of https://dis.eu-west-0.prod-cloud-ocb.orange-business.com\n\n#### ask\nAK/SK-based Authentication\n\n#### sk\nAK/SK-based Authentication\n\n#### projectId\nYour project id\n\n#### region\nRegion\n\n#### stream-name \nYour stream name\n\n#### message-batch-size\nSize of batch\n\n#### message-sending-fixed-delay\nHow often messages will be sent to DIS\n\n### Logging\nLogging configuration can be found in **logback.xml** file located in src/main/resources or conf. You can find more information about how to configure your logs [here](http://logback.qos.ch/manual/configuration.html)\n\n\n### Installation\n\nYou can deploy this connector wherever you want (local server, cloud provider etc.)\n\n### From release\n\nA zip file containing the release can be found at https://github.com/DatavenueLiveObjects/Flexible_Engine_DIS_LOconnector_to_install_on_FE/releases\n\n#### Build\n\nAlternatively, you can build a JAR file using command:\n```\nmvn clean package\n```\nOr a release package zip:\n```\nmvn clean package -Prelease\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdatavenueliveobjects%2Fflexible_engine_dis_loconnector_to_install_on_fe","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdatavenueliveobjects%2Fflexible_engine_dis_loconnector_to_install_on_fe","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdatavenueliveobjects%2Fflexible_engine_dis_loconnector_to_install_on_fe/lists"}