oauth2server

OAuth2Server

Project Goals

Most OAuth-related packages provide middleware or toolkits for implementing an authorization server. This project aims to deliver a complete, standalone, ready-to-deploy authorization server that can be incorporated out-of-the-box into a distributed architecture, along with a collection of SDKs for using it within client apps and API services. This won't be right for everyone, so it's great to have options like nightworld's node-oauth2-server and jaredhanson's oauth2orize.

There are currently three major use cases we intend to support:

• Centralized user account management and authentication for trusted client applications
• Third party API access as an OAuth 2.0 provider
• Single sign on

Using OAuth2Server

OAuth2Server is available as an npm package.

$ npm install oauth2server --save

Only two files are required to set up your own instance locally, app.js and config.development.json. For deployment to Modulus.io, the only additional requirements are config.production.json with a valid Redis configuration and a package.json file listing OAuth2Server as a dependency.

app.js

require('oauth2server').start();

config.production.json

{
  "local-ui": "path/to/ui/build",
  "redis": {
    "url": "redis://HOST:PORT",
    "auth": "PASSWORD"
  }
}

API and configuration docs are in the wiki. We're developing fast and this may be out of sync with the code. Please post an issue if you have questions about usage.

Developing OAuth2Server

Please fork the repository if you intend to contribute. Otherwise just clone this repo.

$ git clone https://github.com/christiansmith/OAuth2Server.git

You'll need to create a configuration file for development. Config files are loaded based on the NODE_ENV setting. By default, config.development.json is loaded and the server will look for a redis instance at localhost.

To get started experimenting, there's a script for generating sample data in your configured storage target.

From the source code, run $ node sample.js.

From a project directory, run $ node node_modules/oauth2server/sample.js.

How to Participate

Help us build the right thing by coming to the Google Hangout at 10am Pacific every Thursday to brainstorm features and use cases. The hangout link is tweeted by @anvilhacks and posted to the project blog a few minutes in advance each week. We love to hear from prospective users.

To help us build the thing right:

• Post and comment on issues. This is the best place to discuss/debate implementation details, point out bugs, flaws, and security issues.
• Fork and request pulls for features and bug fixes. For substantial features, please submit an issue describing your proposed enhancements first, so we can avoid duplicating efforts.
• Pair program. These sessions are always fun and productive. Send me an email to arrange a time (smith at anvil dot io).
• Stay up to date by watching this repository, reading the project blog and checking the issues.
• Promote the project and help us find more early users by blogging, tweeting, +1-ing, starring, gossiping and anything else you think might help.

Sponsorship & Consulting

Accelerate development of features you need by sponsoring the project, or get help integrating OAuth2Server into your architecture. Contact Christian Smith for more information (smith at anvil dot io).

Related Projects

• OAuth2Resource provides Express middleware for authorizing access to resource servers protected by OAuth2Server.
• OAuth2Admin is a standalone AngularJS application for administration of a running OAuth2Server instance.
• Modinha Schema-based data modeling. Extracted from OAuth2Server

Acknowledgements

Thanks to Ben Dalton, Tom Kersten, and everyone who's contributed to requirements, reviewed code, provided encouragement, expressed interest, made time to discuss the project, and otherwise helped to keep us on track! Thanks to Ward Cunningham for inspiring the weekly hangout!

The MIT License

Copyright (c) 2013 Christian Smith http://anvil.io

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.