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

2022/07/09 2023/12/28

CakeDC/Usersのリダイレクト、ユーザ権限管理等の設定解説

　
「CakePHP4のユーザ管理・ログイン認証プラグインCakeDC/Usersのインストール解説」の記事で、CakePHP4で CakeDC/Usersを使ってログイン認証機能を実装し、実際にログインを実施してみました。
では、ログイン時に遷移する画面は、どのファイルで設定しているのでしょうか？
　
今回の記事では、ログイン時、ログアウト時に遷移する画面（リダイレクトする画面）、および、アクセスする際にログイン認証が必要な画面、必要ない画面などを設定する方法を解説します。
　
　

CakeDC/Usersのログイン、ログアウト時のリダイレクト設定

０．「CakeDC/Users」のログイン、ログアウト時の設定ファイル

　
プラグイン「CakeDC/Users」の設定ファイルは下記にあります。
　/vendor/cakedc/users/config/users.php
　
このファイルを直接変更しても設定を変更することはできますが、プラグインのコアファイルとなりますので、一般的にはこのファイルを直接変更することはしません。
（「vendor」フォルダの中身はプラグインのコアファイルとなります。）
　
多くの場合は、このファイル設定を別の場所に複製して、そちらを変更します。
この記事ではその方法を解説しています。
　
　

１．users.phpを作成、編集

　
前項で説明したとおり、まずは設定ファイルを複製します。
　
　/vendor/cakedc/users/config/users.php
を
　/config/users.php
にコピーします。
　
　
本来は「users.php」ファイルを全部丸ごと複製した方がいいと思いますが、今回は実験のために、「users.php」ファイルを新規作成し、下記の内容を記述します。
　

<?php
$config = [
    'Auth' => [
        'AuthenticationComponent' => [
            'load' => true,
            'loginRedirect' => [ // ログイン後
                'plugin'     => 'CakeDC/Users',
                'controller' => 'Users',
                'action'     => 'index',
            ],
            'logoutRedirect' => [ // ログアウト後
                'plugin'     => 'CakeDC/Users',
                'controller' => 'Users',
                'action'     => 'register',
            ],
            'requireIdentity' => false,
        ],
    ],
];
return $config;

<?php

$config = [

'Auth' => [

'AuthenticationComponent' => [

'load' => true,

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

'plugin' => 'CakeDC/Users',

'controller' => 'Users',

'action' => 'index',

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

'plugin' => 'CakeDC/Users',

'controller' => 'Users',

'action' => 'register',

'requireIdentity' => false,

];

return $config;

　
上記の内容は「/vendor/cakedc/users/config/users.php」の 150行目付近にあるものを少し改変しています。
　
　
上記の設定は、ログインしたときのリダイレクト先を下記の URL（ユーザ一覧画面）としています。
　http://example.com/users/index
　
ログアウトしたときのリダイレクト先を下記の URL（ユーザ登録画面）としています。
　http://example.com/register
　
　

２．bootstrap.phpに「users.php」を読み込む設定

　
続いて、前項で設置した「users.php」を読み込む設定を記述します。
　
編集するファイルは下記になります。
/src/Application.php
　
下記の 5行目の記述を追加します。

        // CakeDC/Usersのプラグインのロード
        $this->addPlugin(\CakeDC\Users\Plugin::class);

        // CakeDC/Usersの設定ファイル読み込み
        Configure::write('Users.config', ['users']);

// CakeDC/Usersのプラグインのロード

$this->addPlugin(\CakeDC\Users\Plugin::class);

// CakeDC/Usersの設定ファイル読み込み

Configure::write('Users.config', ['users']);

　
追記する場所は「CakePHP4のユーザ管理・ログイン認証プラグインCakeDC/Usersのインストール解説」で、CakeDC/Usersをインストールしたときに追記した、2行目のプラグインをロードする「$this->addPlugin(....」に続けて記述をします。
　
　
これで、ログインしたとき、および、ログアウトしたときのリダイレクト先の設定は完了です。
　
　
「/vendor/cakedc/users/config/users.php」に記載してあるその他の変更したい項目がある場合は、「/config/users.php」にコピペして値を変更するとその値が適用されます。
「/config/users.php」に記載していない項目は、「/vendor/cakedc/users/config/users.php」に記載してある設定が適用されます。
「/vendor/cakedc/users/config/users.php」にも記載が無い項目は、プログラム上のデフォルト値が適用されます。
　
　

CakeDC/Usersのログイン権限の設定

　
前項では、ログイン時、ログアウト時のリダイレクト先の設定の解説をしましたが、続けて、ログインが必要なページ、ログインが不要なページを設定します。
　
具体的には、下記のような設定を行います。
・ログインしていなくてもアクセスできるページ
・ログインしているユーザがアクセスできるページ
・admin（管理者権限）でログインしているときにアクセスできるページ
　
この設定を間違えると、だれもログイン、ログアウトができなくなったり、だれでもユーザ一覧を見ることができるようになったりしますので、慎重な設定が求められます。
　
　
また、この設定の検証を行うために、最初に作成した「admin」以外の一般ユーザのアカウントを作成しておいてください。
　
　

０．「CakeDC/Users」のログイン要・不要の設定ファイル

　
プラグイン「CakeDC/Users」のログイン要・不要の設定ファイルは下記になります。
　/vendor/cakedc/users/config/permissions.php
　
先の「users.php」と同様、この「permissions.php」に記載してある内容を変更する場合は、別の場所に複製してそちらを変更します。
　
　

１．permissions.phpを作成、編集

　
前項と同様に、まずは設定ファイルを複製します。
　
　/vendor/cakedc/users/config/permissions.php
を
　/config/permissions.php
にコピーします。
　
　
本来は「permissions.php」ファイルを全部丸ごと複製した方がいいと思いますが、今回は実験のために、「permissions.php」ファイルを新規作成し、下記の内容を記述します。
　

<?php
return [
    'CakeDC/Auth.permissions' => [
        //all bypass
        [
            'prefix' => false,
            'plugin' => 'CakeDC/Users',
            'controller' => 'Users',
            'action' => [
                // LoginTrait
                'socialLogin',
                'login',
                'logout',
                'socialEmail',
                'verify',
                // RegisterTrait
                'register',
                'validateEmail',
                // PasswordManagementTrait used in RegisterTrait
                'changePassword',
                'resetPassword',
                'requestResetPassword',
                // UserValidationTrait used in PasswordManagementTrait
                'resendTokenValidation',
                'linkSocial',
                //U2F actions
                'u2f',
                'u2fRegister',
                'u2fRegisterFinish',
                'u2fAuthenticate',
                'u2fAuthenticateFinish',
                'webauthn2fa',
                'webauthn2faRegister',
                'webauthn2faRegisterOptions',
                'webauthn2faAuthenticate',
                'webauthn2faAuthenticateOptions',
            ],
            'bypassAuth' => true,
        ],

        //admin role allowed to all the things
        [
            'role' => 'admin',
            'prefix' => '*',
            'extension' => '*',
            'plugin' => '*',
            'controller' => '*',
            'action' => '*',
        ],

        //specific actions allowed for the all roles in Users plugin
        [
            'role' => '*',
            'plugin' => 'CakeDC/Users',
            'controller' => 'Users',
            'action' => [
                'profile', 
                'logout', 
                'linkSocial', 
                'callbackLinkSocial',

                'index',
                'add',
            ],
        ],

    ]
];

<?php

return [

'CakeDC/Auth.permissions' => [

//all bypass

[

'prefix' => false,

'plugin' => 'CakeDC/Users',

'controller' => 'Users',

'action' => [

// LoginTrait

'socialLogin',

'login',

'logout',

'socialEmail',

'verify',

// RegisterTrait

'register',

'validateEmail',

// PasswordManagementTrait used in RegisterTrait

'changePassword',

'resetPassword',

'requestResetPassword',

// UserValidationTrait used in PasswordManagementTrait

'resendTokenValidation',

'linkSocial',

//U2F actions

'u2f',

'u2fRegister',

'u2fRegisterFinish',

'u2fAuthenticate',

'u2fAuthenticateFinish',

'webauthn2fa',

'webauthn2faRegister',

'webauthn2faRegisterOptions',

'webauthn2faAuthenticate',

'webauthn2faAuthenticateOptions',

'bypassAuth' => true,

//admin role allowed to all the things

[

'role' => 'admin',

'prefix' => '*',

'extension' => '*',

'plugin' => '*',

'controller' => '*',

'action' => '*',

//specific actions allowed for the all roles in Users plugin

[

'role' => '*',

'plugin' => 'CakeDC/Users',

'controller' => 'Users',

'action' => [

'profile',

'logout',

'linkSocial',

'callbackLinkSocial',

'index',

'add',

]

];

　
上記の内容は「/vendor/cakedc/users/config/permissions.php」の 52行目付近、100行目付近、109行目にあるものです。
　
それを元に、上記の 62、63行目に「index」「add」を追加しています。
　
　
先に紹介した「users.php」の設定は、設定を読み込む「Configure::write(....」の設定が必要でしたが、「permissions.php」は設置するだけで記述した内容が反映されます。
　
　

permissions.phpの設定方法

　
前項の「permissions.php」の 5行目からの「all bypass」と書かれている箇所が、ログイン認証なしにアクセスが可能なページになります。
39行目の「'bypassAuth' => true」を指定することで、その設定になります。
　
「CakeDC/Users」の Ver. 9より古いバージョンでは、各コントローラーに設定を記述していましたが、Ver. 9以降では「permissions.php」でまとめて管理する方法に変更されました。
詳細は下記を参照してください。
https://www.cakedc.com/rochamarcelo/2020/02/03/cakedc-users-9-x-easy-migration-from-authcomponent
　
　
また、41行目からの「admin role allowed to all the things」と書かれている箇所が、「スーパーユーザ権限（admin権限）」の認証した場合にアクセスできるページの設定です。
権限は 43行目の「role」で指定し、「スーパーユーザ権限（admin権限）」の場合は「'role' => 'admin'」と指定します。
　
また、「admin権限」の場合は全ての項目が「*」となっていますが、これは「すべてのページに対してアクセスを許可する」という設定になっていることを表しています。
　
　
また、51行目からの「specific actions allowed for the all roles in Users plugin」と書かれている箇所が、「一般ユーザ権限（user権限）」の認証した場合にアクセスできるページの設定です。
53行目の「role」は「*」となっていますが、これは認証された全ての権限でアクセス可能、と言う意味です。
デフォルトの設定では「admin権限」と「user権限」しかありませんので、「*」は「user権限」と言う意味になります。
　
62行目に追加した設定によって、先の「users.php」に、ログインしたときのリダイレクト先として設定した下記の URLに一般ユーザがアクセスできるという設定をしています。
　http://example.com/users/index
　
　

「redirect」パラメータでログイン時のリダイレクトページを指定する方法

　
ログイン時のリダイレクトページは「users.php」に記述すると説明しましたが、「redirect」パラメータを使用することで、ログイン時にリダイレクトする URLを指定することもできます。
　
　
CakeDC/Usersのリダイレクトは、下記の仕様になっています。

認証が必要なページにアクセスをした時に、認証していない場合は「?redirect=http%3A%2F%2Fexample.com%2F」のようにリダイレクト先を指定するパラメータが追加された URLのログイン画面に遷移する
「redirect」パラメータが付いた状態でログイン認証を実行すると「redirect」で指定されているページにリダイレクトする
「redirect」がない場合は、「users.php」のリダイレクト設定に従ってリダイレクトをする

　
　
そのため、例えば、
　　http://example.com/
にアクセスします。でも、認証が必要なページのため
　　http://example.com/login?redirect=http%3A%2F%2Fexample.com%2F
にリダイレクトします。この場合、ログイン認証を通過すると
　　http://example.com/
に遷移します。
　
この記事で解説をした設定の場合は「users.php」の設定で「http://example.com/users/index/」にリダイレクトをする設定になっていますが、「redirect」のパラメータが付いていれば、ログイン後は「http://example.com/」にリダイレクトします。
　
基本的なリダイレクト先は「users.php」に指定しておき、クリックするリンクごとにリダイレクト先を指定したい場合は「redirect」パラメータで指定することもできるようになっています。
　
　

CakePHP4のCakeDC/Usersの関連記事

　
CakePHP4の CakeDC/Usersを使うために、基本となるインストールの方法から入力画面のテンプレートのカスタマイズや、リダイレクトの設定など、CakeDC/Usersに関する記事を下記に書いています。
あわせて参考にしてみてください。
　CakePHP4のユーザ管理・ログイン認証プラグインCakeDC/Usersのインストール解説
　 CakePHP4のCakeDC/Usersの画面、メール本文テンプレートのカスタマイズ方法解説
　 CakePHP4のCakeDC/Usersのログイン時のリダイレクトとユーザ権限管理の設定解説
　
　
また、この記事を書くうえで参考にした記事は下記になります。
　
https://github.com/CakeDC/users/blob/600ea02a2053d51d55380cbb6122fb8a447d7f05/Docs/Documentation/Installation.md
　
https://github.com/CakeDC/users/blob/0c510044adffcbe66bff407b1cdbdd9f87d2476b/Docs/Documentation/Configuration.md
　
　

- CakePHP 3.x 4.x CakePHP4

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

Message コメントをキャンセル

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

: CakePHPのバリデーションを入力値・項目の条件によって変える方法を解説

入力された値によってバリデーション（入力チェック）の内容を切り替える。その処理をCakePHPで実装する方法を解説。条件ごとに unset関数を使ってバリデーションを削除する、という方法を採る。

: CakePHP3のOGPはHTMLヘルパーの$this->Html->meta()を使って設定

CakePHP3でOGPを設定する方法を解説。metaタグを編集するHTMLヘルパーを利用してOGPのタグを編集する。また、エレメントとして分割することでメンテナンス性も向上させる。

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

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

: CakePHP3で /Layout/defult.ctpにある titleタグ、h1タグを編集する方法

CakePHP3でtitleタグ、h1タグのテキストをデフォルトから変更する方法を解説。テンプレートファイルに「$this->assign()」でテキストを指定して「/Layout/defult.ctp」で受け取る。

: CakePHP3でassociatedを使って関連データをまとめて保存する方法（hasOne、hasMany、belongsTo）

CakePHP3で関連データをまとめて保存する方法。hasOne、hasMany、belongsTo等の関連データはassociatedを追加することでまとめて保存することができます。

: Google Analytics APIを CakePHP3で動かしてレポートデータを取得する方法の解説

CakePHP3で Google Analytics APIからレポートデータを取得する処理の解説。PHPのサンプルソースをCakePHP3で動くように改造。加えて、ディメンションやメトリックスを条件に設定する方法なども。

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

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

: CakePHP3で値を入力直後にバリデーションする方法解説

CakePHP3でバリデーションの実行を保存する時から入力情報を受け取るときに変更する処理の解説。CakePHP3ではnewEntity()の処理でバリデートするため1行追加で対応可能。

: CakePHP3で保存前にバリデーション結果を取得する2つの方法

CakePHP3でデータベースに値を保存する前にバリデーションを行い、その結果によって処理を振り分ける方法について解説。「$topic->errors()」と「$topic->hasErrors()」の2つの方法がある。

: CakePHP3のCakeDC/Usersでログインユーザの所有レコードのみ更新、削除する権限管理の設定方法

CakePHP3のユーザ管理、ログイン認証プラグイン「CakeDC/Users」の権限管理を行う方法やアクセスできるコントローラー、アクションを設定、所有権を持つレコードのみ更新できる設定方法を解説。

PREV: CakePHP4のCakeDC/Usersの画面、メール本文テンプレートのカスタマイズ方法解説
NEXT: CakePHP4で定数の設定と呼び出し方法の解説（defineとConfigure）

日	月	火	水	木	金	土
			1	2	3	4
5	6	7	8	9	10	11
12	13	14	15	16	17	18
19	20	21	22	23	24	25
26	27	28	29	30	31

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

CakeDC/Usersのリダイレクト、ユーザ権限管理等の設定解説

CakeDC/Usersのログイン、ログアウト時のリダイレクト設定

０．「CakeDC/Users」のログイン、ログアウト時の設定ファイル

１．users.phpを作成、編集

２．bootstrap.phpに「users.php」を読み込む設定

CakeDC/Usersのログイン権限の設定

０．「CakeDC/Users」のログイン要・不要の設定ファイル

１．permissions.phpを作成、編集

permissions.phpの設定方法

「redirect」パラメータでログイン時のリダイレクトページを指定する方法

CakePHP4のCakeDC/Usersの関連記事

CakePHP4の関連記事

GoogleAdwords

GoogleAdwords

Message コメントをキャンセル

関連記事

CakePHPのバリデーションを入力値・項目の条件によって変える方法を解説

CakePHP3のOGPはHTMLヘルパーの$this->Html->meta()を使って設定

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

CakePHP3で /Layout/defult.ctpにある titleタグ、h1タグを編集する方法

CakePHP3でassociatedを使って関連データをまとめて保存する方法（hasOne、hasMany、belongsTo）

Google Analytics APIを CakePHP3で動かしてレポートデータを取得する方法の解説

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

CakePHP3で値を入力直後にバリデーションする方法解説

CakePHP3で保存前にバリデーション結果を取得する2つの方法

CakePHP3のCakeDC/Usersでログインユーザの所有レコードのみ更新、削除する権限管理の設定方法

WordPress投稿にPHPを記述するショートコードの使い方add_shortcode

コピーコンテンツ対策.htaccessで直リンク禁止しリダイレクトで対応

評価点投票プラグイン10個を比較！WordPressで口コミサイトを構築

BackWPupでバックアップ・リストア（復元）の具体的手順

コンパクトキーボード・KEK-EA9AU・FKB1420の魅力