Непосредственная аутентификация по OAuth 2.0 ¶

Протокол OAuth версии 2.0 предоставляет несколько дополнительных процессов, которые позволяет производить аутентификацию без посещения веб сайта OAuth провайдера.

Замечание: процессы, описанные в этом разделе, обычно не поддерживаются OAuth провайдерами, т.к. они менее защищенные чем стандартный. Убедитесь, что ваш OAuth провайдер поддерживает нужный процесс, прежде чем пытаться им воспользоваться.

Resource Owner Password Credentials Grant ¶

Resource Owner Password Credentials Grant позволяет аутентифицировать пользователя напрямую используя пару "имя пользователя / пароль" без перенаправления на сайт OAuth провайдера.

Вы можете аутентифицировать пользователя по этому процессу, используя yii\authclient\OAuth2::authenticateUser(). Например:

$loginForm = new LoginForm();

if ($loginForm->load(Yii::$app->request->post()) && $loginForm->validate()) {
    /* @var $client \yii\authclient\OAuth2 */
    $client = Yii::$app->authClientCollection->getClient('someOAuth2');

    try {
        // аутентификация напрямую через имя пользователя и пароль:
        $accessToken = $client->authenticateUser($loginForm->username, $loginForm->password);
    } catch (\Exception $e) {
        // аутентификация завершилась неудачей, используйте `$e->getMessage()` для полной информации
    }
    // ...
}

Client Credentials Grant ¶

Client Credentials Grant позволяет аутентифицировать исключительно OAuth клиента (ваше приложение) без задействования третьей стороны (пользователя). Этот процесс используется, если вам нужно использовать только какое-то API общего назначения, которое не требует участия пользователя.

Вы можете аутентифицировать исключительно клиента, используя yii\authclient\OAuth2::authenticateClient(). Например:

/* @var $client \yii\authclient\OAuth2 */
$client = Yii::$app->authClientCollection->getClient('someOAuth2');

// аутентификация исключительно клиета напрямую:
$accessToken = $client->authenticateClient();

JSON Web Token (JWT) ¶

JSON Web Token (JWT) позволяет аутентифицировать конкретного пользователя используя механизм JSON Web Signature (JWS). Следующий пример позволяет аутентифицировать Сервисную учетную запись Google:

use yii\authclient\clients\Google;
use yii\authclient\signature\RsaSha;

$oauthClient = new Google();

$accessToken = $oauthClient->authenticateUserJwt(
    'your-service-account-id@developer.gserviceaccount.com',
    [
        'class' => RsaSha::className(),
        'algorithm' => OPENSSL_ALGO_SHA256,
        'privateCertificate' => "-----BEGIN PRIVATE KEY-----   ...   -----END PRIVATE KEY-----\n"
    ]
);