halkyon / ss-oauth2-server

An OAuth 2.0 Server library for Silverstripe

OAuth2 Server

Introduction

This allows your Silverstripe site to be in OAuth 2.0 provider.

Please note that this is under development. It should work just fine, but has not been extensively tested, and is poorly documented.

It supports the following grants:

• Authorization code grant
• Refresh grant

Requirements

• SilverStripe 3.x

Installation

Install the add-on with Composer:

composer require iansimpson/ss-oauth2-server

Next, generate a private/public key pair:

openssl genrsa -out private.key 1024
openssl rsa -in private.key -pubout -out public.key
chmod 600 private.key
chmod 600 public.key

And put these on your web server, somewhere outside the web root. Add the following lines in your mysite/_config/config.yml, updating the privateKey and publicKey to point to the key file (relative to the Silverstripe root), and adding an encryption key (which you might generate with php -r 'echo base64_encode(random_bytes(32)), PHP_EOL;').

IanSimpson\OAuth2\OauthServerController:
  privateKey: '../private.key'
  publicKey: '../public.key'
  encryptionKey: ''

Finally, after doing a /dev/build/ go into your site settings and on the OAuth Configuration and add a new Client. Using this you should now be able to generate a key at /oauth/authorize, per the OAuth 2.0 spec (https://tools.ietf.org/html/rfc6749).

Usage

To verify the Authorization header being submitted is correct, add this to your Controller:

$member = IanSimpson\OAuth2\OauthServerController::getMember($this);

it will return a Member object if the Authorization header is correct, or false if there's an error. Simple!