summaryrefslogtreecommitdiffstats
path: root/README.md
diff options
context:
space:
mode:
authormaratsabitov <marat.sabitov@mera.com>2020-05-08 18:03:57 +0300
committerMarat Sabitov <marat.sabitov@mera.com>2020-07-09 09:38:01 +0300
commit0cecffd4565b52bd8d200f6bc9f4144f244a6515 (patch)
treec0969bb192bb711c0bd2e2444a66c0060b2e13af /README.md
parentf496bfe75ef0a1ec2658d3fec51866d4c7551282 (diff)
Cloudproxy service allows applications to communicate with clouds. The commit includes the test applications as sample for real client imlementation. Bug-AGL: SPEC-3370 Change-Id: I82d8122e93d01451f4471cc20c706e75c16f1c29 Signed-off-by: maratsabitov <marat.sabitov@mera.com>
Diffstat (limited to 'README.md')
-rw-r--r--README.md50
1 files changed, 50 insertions, 0 deletions
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..876e80c
--- /dev/null
+++ b/README.md
@@ -0,0 +1,50 @@
+# Cloud Proxy Service
+
+## Overview
+
+*Cloud proxy service* provides possibility to send and receive data to/from clouds.
+
+It is allowed to use *Cloud proxy service* from several application.
+The messages/events separtion between application is done within service.
+
+## Verbs
+
+```
+| Name | Description | Data |
+| ------------------ |:----------------------------------------|:----------------------------------------------------|
+| sendMessage | send data to the cloud | application ID, JSON {"data":"message content"} |
+| subscribe | subs. for particular application id | application ID extracted from msg |
+| unsubscribe | unsubs. for particular application id | application ID extracted from msg |
+| ping | verify connectivity to service | N/A |
+```
+## Events
+
+```
+| Name | Description |
+| ---------------------------- |:--------------------------------------------------------|
+| sendMessageConfirmation | confirmation from cloud for previously sent message |
+| receivedMessage | message from cloud to be propagated to the application |
+```
+
+## Configuration
+
+Cloud proxy service requires configuration of the cloud to be used. Configuration is stored in the **config.ini** file.
+
+By default the configuration file **config.ini** is searched stored in
+
+* $AFM_APP_INSTALL_DIR/etc/config.ini - **default one**
+* /etc/cloudproxy-service/etc/config.ini
+
+At the moment only Azure cloud is supported.
+
+### Azure configuration
+The configuration has to contain the connection string for device: **DeviceConnectionString** in
+section **[AzureCloudConnection]**
+
+```
+[AzureCloudConnection]
+DeviceConnectionString=My=Azure=Device=Connection=String
+```
+
+
+