CakePHP3のCakeDC/Usersのログイン後のリダイレクトとユーザ権限管理の設定解説

2017/04/10 2019/03/25

CakeDC/Usersのリダイレクト設定解説

　
「CakePHP3のユーザ管理・ログイン認証プラグインCakeDC/Usersのインストール解説・3.6以降対応」の記事で、CakePHP3で CakeDC/Usersを使ってログイン認証機能を実装し、実際にログインを実施してみました。
果たしてログイン後はどこの画面に遷移するでしょうか？
　
今回の記事では、そのログイン後に遷移する画面（リダイレクトする画面）を設定する方法を解説します。
　
　

CakeDC/Usersのログイン後のリダイレクト設定

１．bootstrap.phpを編集

　
最初にリダイレクトの設定情報を記述する設定ファイルの情報を「bootstrap.php」に追記します。
　
編集するファイルは下記になります。
/config/bootstrap.php
　
下記の 1行目の記述を追加します。

Configure::write('Users.config', ['users']);
Plugin::load('Users', ['routes' => true, 'bootstrap' => true]);

1 2	Configure::write('Users.config', ['users']); Plugin::load('Users', ['routes' => true, 'bootstrap' => true]);

　
追記する場所は「CakePHP3のユーザ管理・ログイン認証プラグインCakeDC/Usersのインストール解説・3.6以降対応」で、CakeDC/Usersをインストールしたときに追記した、2行目のプラグインをロードする「Plugin::load．．．」の前に記述をします。
「Configure::write．．．」と「Plugin::load．．．」の順番は重要な意味を持ちますので、順番を間違えないように記述します。
　
　

２．users.phpを作成、編集

　
続いて、前項で追記した内容に該当する設定ファイル「users.php」を作成し、内容を編集します。
　
作成し、編集するファイルは、以下となります。
このファイルは、新規で作成をします。
/config/users.php
　
編集する内容は、以下になります。

<?php
use Cake\Core\Configure;
use Cake\Routing\Router;

$config = [
    //default configuration used to auto-load the Auth Component, override to change the way Auth works
    'Auth' => [
        'loginAction' => [
            'plugin' => 'CakeDC/Users',
            'controller' => 'Users',
            'action' => 'login',
            'prefix' => false
        ],
        'authenticate' => [
            'all' => [
                'finder' => 'auth',
            ],
            'CakeDC/Users.ApiKey',
            'CakeDC/Users.RememberMe',
            'Form',
        ],
        'authorize' => [
            'CakeDC/Users.Superuser',
            'CakeDC/Users.SimpleRbac',
        ],

        'loginRedirect' => [ // ログイン後
            'plugin' => 'CakeDC/Users',
            'controller' => 'Users',
            'action' => 'index',
        ],
        'logoutRedirect' => [ // ログアウト後
            'plugin' => null,
            'controller' => 'Pages', // トップページにリダイレクトする例
            'action' => 'display', 'home',
        ]
    ],
];

return $config;

<?php

use Cake\Core\Configure;

use Cake\Routing\Router;

$config = [

//default configuration used to auto-load the Auth Component, override to change the way Auth works

'Auth' => [

'loginAction' => [

'plugin' => 'CakeDC/Users',

'controller' => 'Users',

'action' => 'login',

'prefix' => false

'authenticate' => [

'all' => [

'finder' => 'auth',

'CakeDC/Users.ApiKey',

'CakeDC/Users.RememberMe',

'Form',

'authorize' => [

'CakeDC/Users.Superuser',

'CakeDC/Users.SimpleRbac',

'loginRedirect' => [ // ログイン後

'plugin' => 'CakeDC/Users',

'controller' => 'Users',

'action' => 'index',

'logoutRedirect' => [ // ログアウト後

'plugin' => null,

'controller' => 'Pages', // トップページにリダイレクトする例

'action' => 'display', 'home',

]

];

return $config;

　
この編集する内容の基本形は、プラグインの設定情報ファイルである「/vendor/cakedc/users/config/users.php」にありますので、必要に応じてコピペすると楽に設定できます。
　
28～30行目がリダイレクトする URLの指定です。
上記の設定は、下記の URLにリダイレクトする設定になっています。
　http://example.com/users/users/
　
また、32～36行目がログアウトしたときにリダイレクトする URLの指定です。
上記の設定は、トップページにリダイレクトするようになっています。
　
　

２．permissions.phpを作成、編集

　
パーミッションの設定を行う「permissions.php」を作成し、内容を編集します。
　
パーミッションの設定は、ユーザのロール（role、権限）に対してどのページを表示させることができるか、という設定を行うもので、この設定を正しく行わないとリダイレクト先のページが表示されない場合も出てきます。
　
編集するファイルは、以下となります。
ファイルがない場合は新規作成します。
/config/permissions.php
　
　
編集する内容は、以下になります。

<?php
    return [
        'Users.SimpleRbac.permissions' => [
            [
                'role' => 'user',
                'controller' => '*',
                'action' => "*",
            ],
            [
                'role' => 'superuser',
                'controller' => '*',
                'action' => "*",
            ],
        ]
    ];

<?php

return [

'Users.SimpleRbac.permissions' => [

[

'role' => 'user',

'controller' => '*',

'action' => "*",

[

'role' => 'superuser',

'controller' => '*',

'action' => "*",

]

];

　
上記の設定は、「*」を指定することで、すべてのコントロール、すべてのアクションを対象にアクセスを可能にする設定で、「user」も「superuser」もすべてのページにアクセスする権限を割り当てています。
　
アクセスできるページを制限する場合は、下記のような形でページを指定します。
　

<?php
    return [
        'Users.SimpleRbac.permissions' => [
            [
                'role' => 'user',
                'plugin' => 'CakeDC/Users',
                'controller' => 'Users',
                'action' => ['register', 'edit', 'view'],
            ],
        ]
    ];

<?php

return [

'Users.SimpleRbac.permissions' => [

[

'role' => 'user',

'plugin' => 'CakeDC/Users',

'controller' => 'Users',

'action' => ['register', 'edit', 'view'],

]

];

　
permissions.phpの標準設定は、下記のファイルにありますので、あわせて参考にしてください。
/vendor/cakedc/users/config/permissions.php
　
　

PHPフレームワーク CakePHP 3入門

CakeDC/Usersのリダイレクトの特性を理解する上で大事なポイント

CakeDC/Usersのリダイレクト設定の仕様

　
CakeDC/Usersのリダイレクト設定には非常に悩ましい事象があります。
リダイレクト設定をしていても想定しているページにリダイレクトしない、という事象です。
　
ただ、これは、CakeDC/Usersのリダイレクトの仕組みですので、そういうものだという理解をする必要がある内容です。
　
　
CakeDC/Usersのリダイレクトは、下記の仕組みになっています。

認証が必要なページにアクセスをし、権限がないためにログインページにリダイレクトした場合は、ログイン認証が実行されると、ログイン前にリダイレクトしたページにリダイレクトする
上記の設定がない場合は、リダイレクトの設定に従ってリダイレクトをする

　
そのため、例えば、
　
　　http://example.com/
にアクセスします。でも、認証が必要なページのため
　　http://example.com/login
にリダイレクトします。この場合、ログイン認証を通過すると
　　http://example.com/
に遷移します。
　
この記事で解説をした「http://example.com/users/users/」にリダイレクトをする設定にしていたとしても、ログイン後は「http://example.com/」にリダイレクトするのです。
そのため、リダイレクト設定が正しく動作していないんじゃないか、という気になるのですが、ログイン画面「http://example.com/login」の前にアクセスしていた URLが「http://example.com/」であるため、正しい動きなのです。
「http://example.com/login」にリダイレクトした後にリロードしたり、ブラウザを閉じても動作は変わりません。
　
　
この記事で解説をしたリダイレクト設定を検証するには、
・検証に一度も使っていないブラウザを用意するか
・ブラウザのキャッシュをすべて削除するか
の対応を行う必要があります。
そのうえで、「http://example.com/」などリダイレクトする URLを入力せずに、直接「http://example.com/login」の URLを入力する、という方法が必要です。
　
その状態でログインすると、「/config/users.php」に設定したリダイレクトページに遷移します。
　
　

CakeDC/Usersのリダイレクトを実運用で活用するポイント

　
実運用上は、ユーザがわざわざブラウザを変えたり、キャッシュを削除してアクセスすることはないワケですので、設定しているリダイレクト処理はほぼ使われることはない、ということになるでしょう。
　
また、実運用上は、リダイレクトさせたいページがある場合は、リダイレクト設定をしたうえでログイン画面を呼び出すのではなく、リダイレクトさせたいページにリンクを張って、ログインページにリダイレクトさせる、という処理が必要になるのでしょう。
　
具体的には、「http://example.com/news/」にリダイレクトさせたいとしましょう。
　
その時は、「ログインページはこちら」のリンクは「http://example.com/login」ではなく、「http://example.com/news」に設定したうえで、リダイレクトして「http://example.com/login」に遷移するようにしておく、ということですね。
　
　
この仕様は一見するとややこしいように感じますが、ログイン認証を要求するリンクごとにログイン後にリダイレクトするページを指定することが簡単な仕様、ということになります。
　
具体的には、同じページの中でもそれぞれ認証が必要なページにリンクを設定します。
　・マイページはこちら（http://example.com/mypage）
　・ニュース更新はこちら（http://example.com/news）
この状態で、すでに認証を通っていればそのページに遷移しますが、認証が通っていなければログイン画面が出て、その後、それぞれのページに遷移する、ということです。
　
ブラウザをリロードしたり、ブラウザを閉じてもログイン後のリダイレクトする URLの情報は失われませんので、ログイン前にユーザの作業が中断しても、ログイン後は想定しているページにリダイレクトする安心な仕様になっています。
（これを安心な仕様とみるか、余計な仕様とみるか、判断は分かれると思いますが．．．）
　
　

permissions.phpの設定ミスでログアウトできない場合も

　
permissions.phpの設定を間違えて、ログアウトページにアクセスできない設定にしてしまうと、ログアウトができなくなります。
　
私が初めて CakeDC/Usersインストールしたとき、何も考えずに「superuser」でログインしたのですが、ログアウトの URLがそもそも分からなかったことと、permissions.phpの設定を間違えていたことで、ログアウトができずに困ったことがありました。
　
permissions.phpの設定は、十分に注意して設定し、十分な検証を実施しましょう。
　
　

CakePHP3のCakeDC/Usersの関連記事

　
CakePHP3の CakeDC/Usersを使うために、基本となるインストールの方法から入力画面のテンプレートのカスタマイズや、リダイレクトの設定など、CakeDC/Usersに関する記事を下記に書いています。
あわせて参考にしてみてください。
　CakePHP3のユーザ管理・ログイン認証プラグインCakeDC/Usersのインストール解説・3.6以降対応
　 CakePHP3のCakeDC/Usersの画面、メール本文テンプレートのカスタマイズ方法解説
　 CakePHP3のCakeDC/UsersのUserHelperでログアウトやreCAPTCHAをカスタマイズ
　 Google reCAPTCHAのSite key、Secret keyの取得方法・20170408バージョン
　 CakePHP3のCakeDC/Usersのバリデーションのカスタマイズ方法解説
　
　

- CakePHP 2.x　3.x CakePHP3

最後までお読みいただきましてありがとうございます。
この記事が参考になったと思いましたらソーシャルメディアで共有していただけると嬉しいです！

Message コメントをキャンセル

※入力いただいたコメントは管理者の承認後に掲載されます。

: CakePHP 2.3で saveの便利な使い方・サンプルソース付き

CakePHPのレコードを保存、更新する際に使う Saveを詳細解説します。

: CakePHP3のタイムゾーンを協定世界時UTCから日本標準時間JSTにずれを変更する方法

CakePHP3の標準設定のタイムゾーンは「UTC（協定世界時）」に設定されている。これを日本標準時に変更する方法（app.php、bootstrap.phpの変更方法）の解説。

: CakePHP3のインストールでURL rewriting……のエラーが！その解決方法解説

CakePHP3をインストールしたら URL rewriting is not properly configured.のエラーが。原因は.htaccessが有効になっていないこと。httpd.confに設定を追加すればOK。

: CakePHP 2.3　ID以外のカラムでアソシエーション（連携）をさせる場合の詳細ページの注意点

ID以外のカラムでアソシエーション（連携）させて詳細ページを表示させる際の考え方と注意点をサンプルソースを用いて解説しています。

: CakePHP3のHtmlHelperのLink設定のまとめ。mailto、URL、Root／Homeのリンクなども

CakePHP3でHtmlHelperを使ってリンクの設定をする方法のまとめ。基本形からURLを指定、class、id、targetを指定、mailtoのリンク、画像をアンカーに、JavaScriptのダイアログなどの解説。

: CakePHP3の検索プラグイン「friendsofcake/search」の設置方法・CakePHP3.6対応

CakePHP3で検索を担うプラグイン「friendsofcake/search」の紹介。基本的な設置方法の紹介のほか、処理の記述方法のバリエーション、エラーの解説など。CakeDC/searchより導入は簡単！

: CakePHP3でファイルのアップロード処理を自作・解説付き・その１

CakePHP3でファイルをアップロードする処理を、php.netにある「エラーを起こさない」と説明がある処理を参考に作成。サンプルソースとその解説付きで、コピペでも動くし、カスタマイズも簡単！

: CakePHP3で静的ページの作成は webrootか pagesを使う。トップページを参考に解説

CakePHP3で静的なページを設置する場合の方法（webrootとpagesとを活用する方法）を解説。pagesの解説はデフォルトのトップページがどう表示されているかを参考に解説。ルーティングの機能も。

: URL短縮サービス「TTTオンライン（https://ttt.onl）」公開

URL短縮サービス「TTTオンライン（https://ttt.onl）」を公開。メールやSNSでは使いにくい長いURLを短いURLに変換するサービス。QRコードも。Google URL Shortenerが2019年3月にサービス終了。