The Oauth Daemon is the open source version of the OAuth.io core. This is a background api server that runs on your own server that allow your clients to authenticate to any 70+ available OAuth provider.
- A working redis database >= v2.4, check Redis quickstart for a properly installation
- nodejs >= v0.8.2
- npm >= v1.1
- needed packages for npm dependencies: gcc g++ make python
git clone git://github.com/oauth-io/oauthd.git
(sudo) npm install -g coffee-script grunt-cli forever
In the cloned project dir, issue:
npm install
npm
will install dependencies listed in package.json
and compile coffee files.
If you have a problem during npm install
you may want to restart the compilation step by doing:
grunt
Run the redis server if it's not running yet.
To start, stop or restart oauthd, just use
npm [start|stop|restart]
in oauthd folder.
If you want to start oauthd in debug mode, you can also use grunt server
This will launch nodemon and watch/recompile modified files.
By default, you can access it by http://localhost:6284/admin.
The first time you connect, the given login & pass will be registered as the admin user, so don't forget it !
Then you can include the generated js sdk from oauthd to use it on your sites. By example for a local test:
<script src="http://localhost:6284/download/latest/oauth.js"></script>
You may configure config.js in oauthd folder, to configure your ports, connection with redis, enable ssl etc.
You can also write a config.local.js file that will overwrite existing fields of config.js.
Then the admin interface is available to your url / port set into config.js, at /admin.
If you want to contribute to this project, you can directly make pull requests to our Github repository that we regulary check.
Copyright (C) 2013 Webshell SAS
This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details.
You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.