security-authentication.md 3.8 KB
Newer Older
1 2
認証
====
3

4
> Note|注意: この節はまだ執筆中です。
5

6 7 8
認証はユーザが誰であるかを確認する行為であり、ログインプロセスの基礎となるものです。
典型的には、認証は、識別子 (ユーザ名またはメールアドレス) とパスワードの組み合わせを使用します。
ユーザはこれらの値をフォームを通じて送信し、アプリケーションは送信された情報を以前に (例えば、ユーザ登録時に) 保存された情報と比較します。
9

10 11 12
Yii では、このプロセス全体が半自動的に実行されます。
開発者に残されているのは、認証システムにおいて最も重要なクラスである [[yii\web\IdentityInterface]] を実装することだけです。
典型的には、`IdentityInterface` の実装は `User` モデルを使って達成されます。
13

14 15
十分な機能を有する認証の実例を [アドバンストアプリケーションテンプレート](tutorial-advanced-app.md) の中に見出すことが出来ます。
下記にインターフェイスのメソッドだけをリストします。
16 17 18 19 20 21 22

```php
class User extends ActiveRecord implements IdentityInterface
{
    // ...

    /**
23
     * 与えられた ID によって識別子を探す
24
     *
25 26
     * @param string|integer $id 探すための ID
     * @return IdentityInterface|null 与えられた ID に合致する識別子オブジェクト
27 28 29 30 31 32 33
     */
    public static function findIdentity($id)
    {
        return static::findOne($id);
    }

    /**
34
     * 与えられたトークンによって識別子を探す
35
     *
36 37
     * @param string $token 探すためのトークン
     * @return IdentityInterface|null 与えられたトークンに合致する識別子オブジェクト
38 39 40 41 42 43 44
     */
    public static function findIdentityByAccessToken($token, $type = null)
    {
        return static::findOne(['access_token' => $token]);
    }

    /**
45
     * @return int|string 現在のユーザの ID
46 47 48 49 50 51 52
     */
    public function getId()
    {
        return $this->id;
    }

    /**
53
     * @return string 現在のユーザの認証キー
54 55 56 57 58 59 60 61
     */
    public function getAuthKey()
    {
        return $this->auth_key;
    }

    /**
     * @param string $authKey
62
     * @return boolean 認証キーが現在のユーザに対して有効か否か
63 64 65 66 67 68 69 70
     */
    public function validateAuthKey($authKey)
    {
        return $this->getAuthKey() === $authKey;
    }
}
```

71 72 73 74 75 76 77
概要を述べたメソッドのうち、二つは単純なものです。
`findIdentity` は ID の値を受け取って、その ID と関連付けられたモデルのインスタンスを返します。
`getId` メソッドは ID そのものを返します。
その他のメソッドのうち、二つのもの - `getAuthKey``validateAuthKey` - は、「次回から自動ログイン ("remember me")」のクッキーに対して追加のセキュリティを提供するために使われます。
`getAuthKey` メソッドは全てのユーザに対してユニークな文字列を返さなければなりません。
`Yii::$app->getSecurity()->generateRandomString()` を使うと、信頼性の高い方法でユニークな文字列を生成することが出来ます。
これをユーザのレコードの一部として保存しておくのが良いアイデアです。
78 79 80 81 82 83 84 85 86 87 88 89 90 91

```php
public function beforeSave($insert)
{
    if (parent::beforeSave($insert)) {
        if ($this->isNewRecord) {
            $this->auth_key = Yii::$app->getSecurity()->generateRandomString();
        }
        return true;
    }
    return false;
}
```

92
`validateAuthKey` メソッドでは、パラメータとして渡された `$authKey` 変数 (これ自体はクッキーから読み出されます) をデータベースから読み出された値と比較する必要があるだけです。