mirror of https://github.com/elyby/oauth2-server.git synced 2024-12-16 02:08:56 +05:30

A spec compliant, secure by default PHP OAuth 2.0 Server

Go to file

Alex Bilbie 785d3bd21f Merge pull request #151 from giftcards/develop add the ability to change the algorithm that is used to generate the token strings		2014-04-06 21:13:58 +01:00
sql	Added cascading relationship between oauth_sessions_authcodes and oauth_sessions	2013-05-10 17:32:39 -07:00
src/League/OAuth2/Server	added the ability to change the algorithm used to generate the token strings. added files missing in last commit	2014-03-11 12:41:21 -04:00
tests	removed unused use statement	2014-03-11 12:42:26 -04:00
.gitattributes	Merge branch 'refs/heads/master' into develop	2013-09-26 11:18:10 +01:00
.gitignore	Updated .gitignore	2013-11-25 23:59:37 +00:00
.travis.yml	Ninja 5.6 test	2014-02-11 12:27:35 -05:00
CHANGELOG.md	Updated changelog.	2014-02-26 17:35:34 -05:00
composer.json	Bumped composer.json version	2014-02-26 18:14:53 -05:00
CONTRIBUTING.md	Update CONTRIBUTING.md	2013-12-06 10:50:22 +00:00
license.txt	Updated License	2013-05-08 19:04:40 -07:00
phpunit.xml	Added html coverage	2013-11-25 23:59:10 +00:00
phpunit.xml.dist	Removed printer [ci skip]	2013-07-30 10:13:47 +01:00
README.md	Fixed lots of links, and improved readability of links.	2014-02-26 17:45:32 -05:00

README.md

PHP OAuth 2.0 Server

A standards compliant OAuth 2.0 authorization server and resource server written in PHP.

Package Installation

The framework is provided as a Composer package which can be installed by adding the package to your composer.json file:

{
	"require": {
		"league/oauth2-server": "3.*"
	}
}

Framework Integrations

Laravel Service Provider by @lucadegasperi
Laravel Eloquent implementation by @ScubaClick (under development)

The library features 100% unit test code coverage. To run the tests yourself run phpunit from the project root.

[master]

[develop]

Current Features

Authorization Server

The authorization server is a flexible class and the following core specification grants are implemented:

authorization code (section 4.1)
refresh token (section 6)
client credentials (section 2.3.1)
password (user credentials) (section 4.3)

An overview of the different OAuth 2.0 grants can be found in the wiki.

Resource Server

The resource server allows you to secure your API endpoints by checking for a valid OAuth access token in the request and ensuring the token has the correct scope(s) (i.e. permissions) to access resources.

Custom grants

Custom grants can be created easily by implementing an interface. Check out the custom grant guide.

Tutorials and Documentation

Wiki - The wiki has lots of guides on how to use this library.
Developing an OAuth-2.0 Authorization Server - A simple tutorial on how to use the authorization server.
Securing your API with OAuth 2.0 - A simple tutorial on how to use the resource server to secure an API server.

Changelog

See the project releases page

Contributing

Please see CONTRIBUTING for details.

Support

Bugs and feature request are tracked on GitHub

License

This package is released under the MIT License. See the bundled LICENSE file for details.

Credits

This code is principally developed and maintained by Alex Bilbie.

Special thanks to:

The initial code was developed as part of the Linkey project which was funded by JISC under the Access and Identity Management programme.