【EC-CUBE 4】管理画面のログインIDとパスワードが分からないときの対処法

EC-CUBE 4の管理画面にログインできない。ログインIDはすぐ確認できても、パスワードは保存された文字列を見ても分かりません。ここでは、パスワードを思い出せなくなったときに管理画面へ戻る手順を紹介します。

eccube_auth_type: PLAIN

この画面が出ると焦りますが、落ち着いて対処すれば戻れます

なぜパスワードは確認できないのか

EC-CUBEは、パスワードをそのまま保存していません。かといって「暗号化して保存し、必要なときに戻す」わけでもありません。保存しているのは ハッシュ という、元に戻せない形へ変換した値です。

hash_hmac('SHA256', パスワード . ':' . 認証キー, ソルト)

ログイン時は、入力されたパスワードを同じ手順で変換し、保存されている値と一致するかだけを見ています。元のパスワードを取り出す処理はどこにもありません。

全体の流れ

1. 1eccube.yaml の eccube_auth_type を HMAC から PLAIN へ変更する
2. 2データベースの dtb_member で、対象ユーザーの password を仮の文字列（8〜32字）に書き換える。login_id も控えておく
3. 3キャッシュをクリアする
4. 42の IDとパスワードで管理画面にログインする
5. 51を元に戻す（PLAIN → HMAC）
6. 6「設定」→「システム設定」→「メンバー管理」からパスワードを再設定する

1. STEP1

   パスワードの照合方式を平文に切り替える

   app/config/eccube/packages/eccube.yaml を開き、eccube_auth_type の値を HMAC から PLAIN へ変更します。

   ~~~略~~~
       # EC-CUBE parameter
       eccube_database_url: '%env(DATABASE_URL)%'
       eccube_mailer_dsn: '%env(MAILER_DSN)%'
       eccube_admin_route: '%env(ECCUBE_ADMIN_ROUTE)%'
       eccube_user_data_route: '%env(ECCUBE_USER_DATA_ROUTE)%'
       eccube.theme: '%env(ECCUBE_TEMPLATE_CODE)%'
       eccube_theme_code: '%eccube.theme%'
       eccube_auth_magic: '%env(ECCUBE_AUTH_MAGIC)%'
       eccube_auth_type: PLAIN
       eccube_password_hash_algos: SHA256
   ~~~略~~~

   

   eccube.yaml

   値	意味
   HMAC	通常はこちら。パスワードをハッシュ化して照合する。保存された値から元のパスワードは分からない
   PLAIN	保存された値とそのまま突き合わせる。管理はしやすいが安全性が大きく下がるため、実運用では使わない

   PLAIN にしている間は、管理者も一般会員も通常のパスワードではログインできません。作業は手早く済ませてください。

2. STEP2

   データベースのパスワードを書き換える

   phpMyAdmin などで データベース に接続し、dtb_member からログインしたいユーザーを探します。

   

   変更前：ハッシュ化された値が入っている

   

   変更後：仮のパスワードに書き換えた

   該当ユーザーの password を、仮のパスワード（8〜32字）へ書き換えます。上の例では password という文字列にしています。

   ログインIDが分からない場合も、この表で確認できます。login_id の列がそれです。書き換えは不要なので、そのまま控えておいてください。

   元の（ハッシュ化された）値をそのままパスワード欄に入力してもログインできません。文字数が長すぎて入力欄の上限に引っかかることもあります。必ず短い仮パスワードへ書き換えてください。

3. STEP3

   キャッシュをクリアする

   設定ファイルを変更したので、キャッシュ を削除します。IDとパスワードが正しくてもログインできない場合、これが原因のことがあります。

   サーバーに SSH 接続して、次のコマンドを実行します。

   bin/console cache:clear --no-warmup

   SSH接続の方法は以下の記事にまとめています（Xserverの場合）。

   Windows PCからSSH接続する方法（Tera Termを利用） Mac PCからSSH接続する方法
4. STEP4

   ログインして、設定を戻しパスワードを再設定する

   STEP2で決めた仮のパスワードで管理画面にログインします。

   ログインできたら、まず eccube.yaml の eccube_auth_type を PLAIN から HMAC へ戻します。そのうえで「設定」→「システム設定」→「メンバー管理」からパスワードを再設定してください。

   ここを飛ばしてログアウトすると、また入れなくなります。再設定するパスワードは今後ずっと使うものなので、推測されにくい強固なものにしてください。

メンテナンスモードの設定

この手順の途中は、一時的とはいえ安全性が下がり、その間は通常のパスワードでログインできなくなります（一般会員も同じ）。稼働中のサイトでは、先にメンテナンスモードにしておくと安心です。

メンテナンスモードは通常なら管理画面から設定しますが、そもそも管理画面に入れない状況です。その場合は .maintenance という名前のファイル（中身は空でかまいません）を、EC-CUBEのディレクトリ直下に置くことで有効にできます。

通常は管理画面から設定する

管理画面に入れる場合はこちら

.maintenance を置いても有効になる

管理画面に入れないときはこちら

まとめ

• パスワードはハッシュ化されて保存されており、元に戻すことはできない
• そのため、照合方式を一時的に PLAIN へ切り替え、データベースに仮パスワードを直接書く
• ログインIDは dtb_member の login_id で確認できる
• 設定ファイルを変えたらキャッシュを削除する
• ログイン後は必ず HMAC へ戻し、パスワードを再設定する
• 稼働中のサイトなら、先にメンテナンスモードにしておく

EC-CUBEのカスタマイズに関する記事

• カスタマイズのまとめ
• 管理画面のURLを変更する方法
• 独自の定数（パラメータ）を設定・管理する方法
• 【XServer】Windows PCからSSH接続する方法
• 【XServer】Mac PCからSSH接続する方法

この記事に出てきた用語

• EC-CUBEとは？
• ハッシュとは？
• データベースとは？
• phpMyAdminとは？
• YAMLとは？
• キャッシュとは？
• SSHとは？
• パスワード認証とは？