auth-store
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.
Getting Started
- Install Docker on your system.
- Install Compose.
- Use
script/genkeys
to generate self-signed TLS keypairs in certificates/
.
- Run
docker-compose build && docker-compose up -d
to 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.
Using the API
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'
API Documentation
Current API documentation may be found in the docs/
directory.