Fallball connector

This is a basic sample connector for the Fallball Cloud Storage.

Running on localhost with tunnel

• Download and unzip fallball-connector

• Install package and requirements for local development

python setup.py develop

• Update config.yml file with your credentials

fallball_service_url: PUT_HERE_FALLBALL_SERVICE_URI
fallball_service_authorization_token: PUT_HERE_FALLBALL_SERVICE_AUTHORIZATION_TOKEN
oauth_key: PUT_HERE_OAUTH_KEY
oauth_secret: PUT_HERE_OAUTH_SECRET

• Run application

$ python connector/app.py
 * Running on http://0.0.0.0:5000/ (Press CTRL+C to quit)

• Create HTTP tunnel with ngrok

ngrok http 5000

• Use public connector URL https://YOUR_UNIQ_ID.ngrok.io/v1/

If you run the connector without SSL behind SSL-enabled reverse proxy, make sure that proxy populates the X-Forwarded-Proto header.

Running in Docker

docker-compose up

Application is started in debug mode in docker container on port 5000.

Development

• Run unit tests

python setup.py nosetests