Skip to main content

Javascript-DBus bridge

Project description


Cloudeebus
==========

Cloudeebus - DBus for the Cloud - is a component which enables calling DBus
methods and registering on DBus signals from Javascript.


Install
-------

### Installing Cloudeebus from the project root directory:

Cloudeebus will install itself in Python's dist-packages folder. The
cloudeebus.py wrapper shell goes in the executables path.

sudo python setup.py install

See the [Getting Started](https://github.com/01org/cloudeebus/wiki/Getting-started)
section of the [Cloudeebus wiki](https://github.com/01org/cloudeebus/wiki)
for a list of dependencies to install.


### Running Cloudeebus:

The Cloudeebus server must be run either with credentials and a whitelist to
restrict access to DBus services, or in opendoor mode.

usage: cloudeebus.py [-h] [-v] [-d] [-o] [-p PORT] [-c CREDENTIALS]
[-w WHITELIST] [-s SERVICELIST] [-n NETMASK]

Javascript DBus bridge.

optional arguments:
-h, --help show this help message and exit
-v, --version print version and exit
-d, --debug log debug info on standard output
-o, --opendoor allow anonymous access to all services
-p PORT, --port PORT port number
-c CREDENTIALS, --credentials CREDENTIALS
path to credentials file
-w WHITELIST, --whitelist WHITELIST
path to whitelist file (DBus services to use)
-s SERVICELIST, --servicelist SERVICELIST
path to servicelist file (DBus services to export)
-n NETMASK, --netmask NETMASK
netmask,IP filter (comma separated.) eg. : -n
127.0.0.1,192.168.2.0/24,10.12.16.0/255.255.255.0


Documentation
-------------

* [Cloudeebus](http://01.org/cloudeebus) project home page on [01.org](http://01.org)
* [Javascript API](https://github.com/01org/cloudeebus/wiki/API) reference.
* [Architecture](https://github.com/01org/cloudeebus/wiki/Architecture) block diagram.


Examples
--------

### dbus-tools

The /doc/dbus-tools folder contains dbus-send and dbus-register test pages.
Cloudeebus runs in opendoor mode, the dbus-tools pages have no manifest.

cloudeebus.py --debug --opendoor --port=9001 &
firefox ./doc/dbus-tools/dbus-register.html ./doc/dbus-tools/dbus-send.html &

### sample

The /doc/sample folder contains a working sample using credentials, whitelist and manifest.
Cloudeebus runs with credentials and a whitelist that are matched by the
sample page manifest.

cloudeebus.py --debug --credentials=./doc/sample/CREDENTIALS --whitelist=./doc/sample/WHITELIST &
firefox ./doc/sample/cloudeebus.html &

The sample page is also online as a [live demo](http://01org.github.com/cloudeebus/).

### agent

The /doc/agent folder contains a working client sample using credentials, whitelist and manifest and
a working service sample using credentials, servicelist and manifest.
One instance of cloudeebus runs with credentials and a whitelist that are matched by the
client page manifest.

cloudeebus.py --debug --credentials=./doc/agent/CREDENTIALS --whitelist=./doc/agent/SAMPLELIST -p 9002 &
firefox ./doc/agent/client.html &

The other instance of cloudeebus runs with credentials and a servicelist that are matched by the
server page manifest.

cloudeebus.py --debug --credentials=./doc/agent/CREDENTIALS --servicelist=./doc/agent/SAMPLELIST -p 9003 &
firefox ./doc/agent/server.html &


Acknowledgements
----------------

Cloudeebus uses code from the following open-source projects:

* [AutobahnJS](http://autobahn.ws/js) ([MIT](http://opensource.org/licenses/MIT) License)
* [AutobahnPython](http://autobahn.ws/python) ([Apache 2.0](http://opensource.org/licenses/Apache-2.0) License)

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

cloudeebus-0.6.0.tar.gz (8.6 kB view details)

Uploaded Source

Built Distribution

cloudeebus-0.6.0-py2.7.egg (31.4 kB view details)

Uploaded Source

File details

Details for the file cloudeebus-0.6.0.tar.gz.

File metadata

  • Download URL: cloudeebus-0.6.0.tar.gz
  • Upload date:
  • Size: 8.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for cloudeebus-0.6.0.tar.gz
Algorithm Hash digest
SHA256 a19662d52a4c756d1be6e5bae7134b34676695fdf9266da6509c686d831300d7
MD5 d431ff9f9150cf7ba0f6f89980789a32
BLAKE2b-256 82e3388d271bdd79951a5aceb44cf05ab75c95c06a49e6e2a96b3e0562bf45f8

See more details on using hashes here.

File details

Details for the file cloudeebus-0.6.0-py2.7.egg.

File metadata

File hashes

Hashes for cloudeebus-0.6.0-py2.7.egg
Algorithm Hash digest
SHA256 ade028910c9e75f1dffaa37d37b305d5fb7910781d3f7c8899ade8869bf3934d
MD5 b849ff5f3ab861abbacf04adb67046fc
BLAKE2b-256 2d7a9cd5bee1b85c9cc12868f9d7823b056cd5265b49b71926416cd471852706

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page