bundle/

README

Scalable OCF Cloud Hosting / Testing

Being plugged.in provides you a complete set of tools and services to manage your devices at scale. Allowing for the processing of real-time device data and interconnection of your devices and applications based on an interoperable standard. Interconnect, monitor and manage your devices in a cloud native way.

OCF Cloud Bundle

Provides a simple docker cloud image for testing purpose.

Features

• OCF Native Cloud
• OAUTH Athorization code is not verified
• GRPC

Supported clients

• iotivity v2+
• iotivity-lite v2+

Pull the image

docker pull plgd/bundle:vnext

Configuration

Image can be configured via enviroment variables as argument -e ENV=VALUE of command docker:

ENV variable	Type	Description	Default
COAP_GATEWAY_UNSECURE_PORT	uint16	exposed public port for coap-tcp	"5683"
COAP_GATEWAY_UNSECURE_ADDRESS	string	coap-tcp listen address	"0.0.0.0:5683"
COAP_GATEWAY_UNSECURE_FQDN	string	public FQDN for coap-tcp	localhost
COAP_GATEWAY_PORT	uint16	exposed public port for coaps-tcp	"5684"
COAP_GATEWAY_ADDRESS	string	coaps-tcp listen address	"0.0.0.0:5684"
COAP_GATEWAY_FQDN	string	public FQDN for coaps-tcp	"localhost"
COAP_GATEWAY_CLOUD_ID	string	cloud id	"00000000-0000-0000-0000-000000000001"
COAP_GATEWAY_DISABLE_BLOCKWISE_TRANSFER	bool	disable blockwise transfer	false
COAP_GATEWAY_BLOCKWISE_TRANSFER_SZX	string	blockwise transfer size	"1024"
COAP_GATEWAY_DISABLE_PEER_TCP_SIGNAL_MESSAGE_CSMS	bool	ignore tcp control signal message from peer	"false"
COAP_GATEWAY_DISABLE_VERIFY_CLIENTS	bool	disable verifying coap clients certificates	true
GRPC_GATEWAY_ADDRESS	string	secure grpc-tcp listen address	"0.0.0.0:9084"
GRPC_GATEWAY_DISABLE_VERIFY_CLIENTS	bool	disable verifying grpc clients certificates	true
HTTP_GATEWAY_ADDRESS	string	secure grpc-tcp listen address	"0.0.0.0:9086"
HTTP_GATEWAY_DISABLE_VERIFY_CLIENTS	bool	disable verifying http clients certificates	true
INITIALIZE_CERITIFICATES	bool	initialze certificates	true
CERITIFICATES_PATH	string	path to directory	"/data/certs"
MONGO_PATH	string	path to directory	"/data/db"
MONGO_PORT	uint16	mongo listen port	"10000"
NATS_PORT	uint16	nats listen port	"10001"
LOGS_PATH	string	path to directory	"/data/log"

Run

docker run -d --network=host --name=cloud -t plgd/bundle:vnext

Device Onboarding

The onboarding values which should be set to the coapcloudconf device resource are:

Unsecured device

Attribute	Value
apn	test
cis	coap+tcp://127.0.0.1:5683
sid	same as is set in COAP_GATEWAY_CLOUD_ID
at	test

Secured device

Attribute	Value
apn	test
cis	coaps+tcp://127.0.0.1:5684
sid	same as is set in COAP_GATEWAY_CLOUD_ID
at	test

Conditions:

• Device must be owned.
• Cloud CA must be set as TRUST CA with subject COAP_GATEWAY_CLOUD_ID in device.
• Cloud CA in PEM:

  docker exec -it cloud cat CERITIFICATES_PATH/root_ca.crt
  

• ACL for Cloud (Subject: COAP_GATEWAY_CLOUD_ID) must be set with full access to all published resources in device.

Build a sample device application

git clone --recursive https://github.com/iotivity/iotivity-lite.git
cd ./iotivity-lite/port/linux
make CLOUD=1 SECURE=0 cloud_server
./cloud_server test test coap+tcp://127.0.0.1:5683 COAP_GATEWAY_CLOUD_ID

Build a COAP client application

To build the client you need to have golang v1.13+.

cd ./client/coap
go build
./coap --help
# gets a resource links of the registered devices from cloud
./coap --signUp test --href /oic/res

Build a GRPC client application

To build the client you need to have golang v1.13+.

cd ./client/grpc
go build
./grpc --help
# gets all resources with contents from cloud
./grpc
# gets resources of device with contents from cloud
./grpc --deviceid {deviceID}
# gets devices from cloud
./grpc --getdevices

HTTP access

REST API