Currently security is supported via resources that are marked as secure, and via an ACL file set up a priori. The high level bindings provide a persistent storage mechanism which iotivity uses to store ACLs. The mechanism works as follows:
-
The sha256sum of the absolute path of the main script which was used to launch the node process is computed. For example, if the script is
/home/user/secure-door/secure-door-lock.js
, then the sha256sum will be08417c1debd48131536fa8bc152d776c9e8949b639d1e0fa200b14d5f6c917c8
. The sha256sum corresponding to the above script can be obtained with the following command:echo -n '/home/user/secure-door/secure-door-lock.js' | sha256sum
-
The directory
${HOME}/.iotivity-node/<sha256sum>
is created, where<sha256sum>
is the checksum computed above. -
The ACL file generated by iotivity will be placed into that directory. You can use
iotivity-installed/bin/json2cbor
from the location where iotivity-node was installed to create a cbor file which you can place in the above-mentioned directory. -
test/preamble.js
is a utility script which you can use as a reference for generating your own ACL files. It's not suitable for production use, because it always gives full access to the resources it accepts as parameters, since it was designed for use by the test suite. -
The details of the structure of JSON source files to be used with
json2cbor
are described at https://wiki.iotivity.org/security_resource_manager.