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 コメントをキャンセル

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

: CakePHP3のアソシエーション機能を使い関連レコードをまとめて削除

CakePHP3でレコードを削除する際に関連するレコードをまとめて削除する機能の解説。フレームワークのメリットを存分に発揮し、コマンドを1行追加するだけで実装可能。

: CakePHP3のCakeDC/UsersのUserHelperでログアウトやreCAPTCHAをカスタマイズ

CakeDC謹製Usersプラグインの紹介。UserHelperを利用し、ログアウトのリンクや権限があるときのみ表示されるリンク、プロフィールページへのリンク、reCAPTCHAの設置方法などを解説。

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

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

: CakePHP3でCookieを保存、呼び出し、削除の操作・CakePHP3.7対応

CakePHP3.7でCookieを保存、取り出し、削除する方法を解説。CakePHP3でのCookieの取り扱いはバージョンごとに変更されるため、環境に合わせた方法を探す必要がある。

: CakePHP 2.3　デバッグキット（DebugKit）超初心者向けフォロー講座

CakePHP初心者に向けてデバッグキット（DebugKit）のインストール方法、はまりポイントを解説。

: CakePHP 2.3　テーブルの項目を演算した結果を条件として抽出する方法

アソシエーション（連携）している先のテーブルの項目で演算をする場合の考え方と注意点をサンプルソースを用いて説明しています。分かってしまえば簡単です。

: VirtualBoxにCakePHP3を設置。必要なCentOS、Apache、PHP、MySQL、Composerをインストールし設定する

VirtualBoxにCentOS、Apache、MySQL、PHPをインストールするところから初めてCakePHP3の開発環境を構築する手順を詳細解説。この記事1つで全ての設定が完了する。

: CakePHP3のfriendsofcake/searchでブックマークチュートリアルのタグ検索を実装

CakePHP3のCookbookにあるブックマークチュートリアル。ここで紹介されているタグで検索する処理を検索プラグイン「friendsofcake/search」で実現する方法を解説しました。

: CakePHP3のプラグイン「CakeDC/Users」を日本語化・翻訳ファイルもダウンロード可

CakePHP3のユーザ管理、ログイン認証プラグインである「CakeDC/Users」のメッセージを日本語にする手順の解説とともに、日本語の翻訳ファイルを提供。ファイルを設置すれば日本語になる！