macfly/yii2-oauth2-server

Wrapper for filsh yii2-oauth2-server provide authorize, token, user controller

yii2-oauth2-server

A wrapper for Filsh/yii2-oauth2server which implement an OAuth2 Server, _(*1)

Add missing code that make it easy to use with social network aware user module like the one from dektrium/yii2-user, you can use the macfly/yii2-authclient-oauth2 which work with it out off the box., _(*2)

Add controller:, _(*3)

• Authorize
• Token
• User (Provide user information id, username, e-mail, ...)

/!\ with version 2.0.13 of the Yii framework there is an issue with Filsh/yii2-oauth2server, you can fix it by updated your composer.json with the following, _(*4)

    "repositories": [
        {
            "type": "vcs",
            "url": "https://github.com/Marty-Macfly/yii2-oauth2-server-1"
        }
    ],

...

    "require": {

...

        "filsh/yii2-oauth2-server": "2.0.2.x-dev",

...

    },

...

Installation

The preferred way to install this extension is through composer., _(*5)

Either run, _(*6)

php composer.phar require --prefer-dist macfly/yii2-oauth2-server "*"

or add, _(*7)

"macfly/yii2-oauth2-server": "*"

to the require section of your composer.json., _(*8)

To use this extension, simply add the following code in your application configuration as a new module:, _(*9)

'modules'=>[
    //other modules .....
    'oauth2' => [
        'class' => 'macfly\oauth2server\Module',
        'tokenParamName' => 'accessToken',
        'tokenAccessLifetime' => 3600 * 24, // Default token lifetime
        'userModel' => 'app\models\User',
        'userAttributes' => [ // List of user attributes you want to provide through the /oauth2/user api call
            'id',
            'username',
            'email',
        ],
    ]
    // yii2-oauth2-server is using the kartik\datecontrol\Module so you should define the configuration of the module
    // See more details at http://demos.krajee.com/datecontrol
    'datecontrol' =>  [
        'class'             => 'kartik\datecontrol\Module',
        'ajaxConversion'    => true,
        'autoWidget'        => true,
        'saveTimezone'      => 'UTC',
    ],
],

Can be usefull to enable in requet component the json parser and pretty url., _(*10)

Also, extend app\models\User - user model - implementing the interface \OAuth2\Storage\UserCredentialsInterface, so the oauth2 credentials data stored in user table., _(*11)

You should implement (for convenience a trait is provide): - findIdentityByAccessToken() - checkUserCredentials() - getUserDetails() - getAuthKey() - getOauthClient() mapping of one user to one oauth client., _(*12)

You can extend the model if you prefer it (please, remember to update the config files) :, _(*13)

use Yii;

class User extends app\models\User implements \OAuth2\Storage\UserCredentialsInterface
{
    use \macfly\oauth2server\traits\Oauth2User;
}

The next step you should run migration, _(*14)

yii migrate --migrationPath=@vendor/macfly/yii2-oauth2-server/src/migrations

this migration create the oauth2 database scheme and insert test user credentials testclient:testpass for http://127.0.0.1:8888/user/security/auth?authclient=oauth2, _(*15)

Usage

List of available actions

• /oauth2/authorize: Session verification from a browser
• /oauth2/token: Get token
• /oauth2/user: Get user information

You can see the filsh documentation to use token (https://github.com/Filsh/yii2-oauth2-server/tree/v2.0.0#usage), _(*16)

Admin interface

Manage client credentials, _(*17)

• /oauth2/clients

CRUD operations, _(*18)

• /oauth2/clients/index
• /oauth2/clients/create
• /oauth2/clients/update
• /oauth2/clients/delete

Manage access token, _(*19)

• /oauth2/accesstokens

CRUD operations, _(*20)

• /oauth2/accesstokens/index
• /oauth2/accesstokens/create
• /oauth2/accesstokens/update
• /oauth2/accesstokens/delete