Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/librecmscom/yii2-oauth2
oauth2服务器
https://github.com/librecmscom/yii2-oauth2
oauth yii2 yii2-extension yii2-modules yii2-oauth2
Last synced: 22 days ago
JSON representation
oauth2服务器
- Host: GitHub
- URL: https://github.com/librecmscom/yii2-oauth2
- Owner: librecmscom
- License: mit
- Created: 2017-01-13T08:37:46.000Z (almost 8 years ago)
- Default Branch: master
- Last Pushed: 2017-11-11T04:32:31.000Z (about 7 years ago)
- Last Synced: 2024-10-15T14:20:12.814Z (2 months ago)
- Topics: oauth, yii2, yii2-extension, yii2-modules, yii2-oauth2
- Language: PHP
- Size: 86.9 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# Yii2 OAuth 2.0 Server
## Description
This extension provides simple implementation of [Oauth 2.0](http://tools.ietf.org/wg/oauth/draft-ietf-oauth-v2/) specification using Yii2 framework.
## Installation
The preferred way to install this extension is through [composer](http://getcomposer.org/download/).
To install, either run
```
$ php composer.phar require yuncms/oauth2 "~2.0.0"
```
or add
```
"yuncms/oauth2": "~2.0.0"
```
to the ```require``` section of your `composer.json` file.
To create database tables run migration command
```
$ yii migrate --migrationNamespace=@yuncms/oauth2/migrations
```
## Usage
url:
Application
```bash
http://yourname.com/oauth2/auth/authorize
http://yourname.com/oauth2/auth/token
refresh_token
http://yourname.com/oauth2/auth/token
```
OAuth 2.0 Authorization usage
```php
namespace app\controllers;
use app\models\LoginForm;
class AuthController extends \yii\web\Controller
{
public function behaviors()
{
return [
/**
* Checks oauth2 credentions and try to perform OAuth2 authorization on logged user.
* AuthorizeFilter uses session to store incoming oauth2 request, so
* you can do additional steps, such as third party oauth authorization (Facebook, Google ...)
*/
'oauth2Auth' => [
'class' => \yuncms\oauth2\AuthorizeFilter::className(),
'only' => ['index'],
],
];
}
public function actions()
{
return [
/**
* Returns an access token.
*/
'token' => [
'class' => \yuncms\oauth2\TokenAction::classname(),
],
/**
* OPTIONAL
* Third party oauth providers also can be used.
*/
'back' => [
'class' => \yii\authclient\AuthAction::className(),
'successCallback' => [$this, 'successCallback'],
],
];
}
/**
* Display login form, signup or something else.
* AuthClients such as Google also may be used
*/
public function actionIndex()
{
$model = new LoginForm();
if ($model->load(\Yii::$app->request->post()) && $model->login()) {
if ($this->isOauthRequest) {
$this->finishAuthorization();
} else {
return $this->goBack();
}
} else {
return $this->render('index', [
'model' => $model,
]);
}
}
/**
* OPTIONAL
* Third party oauth callback sample
* @param OAuth2 $client
*/
public function successCallback($client)
{
switch ($client::className()) {
case GoogleOAuth::className():
// Do login with automatic signup
break;
...
default:
break;
}
/**
* If user is logged on, redirects to oauth client with success,
* or redirects error with Access Denied
*/
if ($this->isOauthRequest) {
$this->finishAuthorization();
}
}
}
```
Api controller sample
```php
class ApiController extends \yii\rest\Controller
{
public function behaviors()
{
return [
/**
* Performs authorization by token
*/
'tokenAuth' => [
'class' => \yuncms\oauth2\TokenAuth::className(),
],
];
}
/**
* Returns username and email
*/
public function actionIndex()
{
$user = \Yii::$app->user->identity;
return [
'username' => $user->username,
'email' => $user->email,
];
}
}
```
Sample client config
```php
return [
...
'components' => [
'authClientCollection' => [
'class' => 'yii\authclient\Collection',
'clients' => [
'myserver' => [
'class' => 'yii\authclient\OAuth2',
'clientId' => 'unique client_id',
'clientSecret' => 'client_secret',
'tokenUrl' => 'http://myserver.local/auth/token',
'authUrl' => 'http://myserver.local/auth/index',
'apiBaseUrl' => 'http://myserver.local/api',
],
],
],
];
```
## Thanks to
* [Yii framework](https://github.com/yiisoft/yii2)
* [yii2-oauth2-server](https://github.com/borodulin/yii2-oauth2-server)
## License
Yii2-oauth2 is released under the MIT License. See the bundled [LICENSE.md](LICENSE.md)
for details.