Auth パッケージ

Auth パッケージは Fuel における標準化された認証インターフェイスを提供します。 これにより、ユーザは自分自身で新しいドライバを書くことができ、 基本的なメソッドを保つことで、古いコードに新しいドライバを簡単に統合することもできます。

はじめに

すべての人、すべての実装に合う Auth パッケージを作るのは不可能です。フレームワークとして、 私たちはどのように認証を行うかを強制しません。しかし、ユーザが自分自身や他の人が作ったものを利用することの手助けをしたいと思っています。 これが、 Auth パッケージが作られた理由です。 もちろん、ユーザのためのシンプルな実装もその中に含まれています。

インターフェイスは 3 タイプのドライバで構成されています(より多くのタイプに拡張できます):Login、Group、 ACL です。 Login ドライバはユーザのログインを扱います。また、同時に複数の Login ドライバも扱えます。 例えば、 2 つの Login ドライバを使うことで、Twitter 経由のユーザと固有のユーザとしてのログインの 両方を同時に行えます。
次のステップとして、これらの 2 つのタイプのログインを Group ドライバを使って、ログインのタイプに左右されることなく、 まとめてグループにすることができます。それらすべてに加えて、グループごとに ACL ドライバを使うことで 特定の権限をグループに与えることができます。

上記は、使い方のほんの一例です。上記のように使うべきというわけではありません。 次のセクションに読み進んで、どのメソッドがジェネリックインターフェイスの一部で、どれがドライバ固有なのかを 理解しましょう:基本的な使用方法、および、ドライバを書く.

インストール

Auth パッケージは Fuel のダウンロードに含まれます。設定で有効化してください。

'always_load' => array(
	'packages' => array(
		'auth',
	),
),

設定

Auth は config/auth.php ファイルに、下記のキーで設定できます:

パラメータ 規定値 説明
driver 文字列 | 配列
array('SimpleAuth')
ロードする Login ドライバ、最初のドライバが Auth::instance() のデフォルト返り値にもなります。
verify_multiple_logins 論理型
false
ひとつのドライバでログインの成功を確認したあとにも、継続してログインのチェックを行うかどうか。 これにより複数の方法でログインすることが可能。
salt 文字列
'put_your_salt_here'
パスワードをハッシュにするときのサルト。

'verify_multiple_logins' はドライバレベルの設定であることに注意。 Login ドライバ そのものを意味していないし、「ユーザに多重ログインすることを許可する」ということではありません!

auth.php ファイルはこのようになります:

<?php

return array(
	// ドライバ
	'driver' => array('SimpleAuth'),

	// 複数ログインを有効にする場合、 true
	'verify_multiple_logins' => true,

	// セキュリティのために、サルトを設定しましょう
	'salt' => 'Th1s=mY0Wn_$@|+',
);

/* End of file auth.php */