Skip to content

Security: xiaoyu3x/iotivity-node

Security

SECURITY.md

Setting up security

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:

  1. 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 be 08417c1debd48131536fa8bc152d776c9e8949b639d1e0fa200b14d5f6c917c8. 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
    
  2. The directory ${HOME}/.iotivity-node/<sha256sum> is created, where <sha256sum> is the checksum computed above.

  3. 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.

  4. 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.

  5. The details of the structure of JSON source files to be used with json2cbor are described at https://wiki.iotivity.org/security_resource_manager.

There aren’t any published security advisories