locally administered account management for cloudpipe
This is the default implementation of the cloudpipe authentication backend protocol that stores account data in MongoDB, most likely the same instance that's used to host other internal Cloudpipe data. It exposes additional API endpoints to permit account creation and API key generation.
- Install Docker on your system.
- Install Compose.
- Use
script/genkeysto generate self-signed TLS keypairs incertificates/. - Run
docker-compose build && docker-compose up -dto build and launch everything locally.
To run the tests, use script/test. You can also use script/mongo to connect to your local MongoDB database.
Once it's up and running, you can use curl to interact the auth API. Here are a few examples:
# If you're on a Mac and using boot2docker. Otherwise, you can use "localhost".
DOCKER=$(boot2docker ip 2>/dev/null)
# Create a new account.
curl -k -i -X POST https://${DOCKER}:9000/v1/accounts -d 'accountName=me%40gmail.com&password=shhh'
# Generate a new API key.
curl -k -i -X POST https://${DOCKER}:9000/v1/keys -d 'accountName=me%40gmail.com&password=shhh'Current API documentation may be found in the docs/ directory.
