WAGBY11 MANUAL / 30
パスワードの再設定(CUI)
メールを利用できない場合に、サーバー上のコマンドから仮パスワードを設定してログオンを復旧する手順を説明します。
最終更新日:
1. このページで伝える機能
管理者などのパスワードが分からず、メールによる再設定も利用できない場合は、サーバー上のコマンドで仮パスワードを設定できます。たとえば、データのインポート後に管理者のパスワードが取り込み内容へ変わり、ログオンできなくなった場合に利用します。
この操作は、サーバーのファイルとDB接続設定にアクセスできる運用担当者が行います。メール送信やブラウザーからの操作は不要です。AppSchemaの編集や再生成は行いません。
1人または複数のユーザー、すべての有効ユーザーを対象に資格情報を更新し、次回ログオン時にパスワードを変更する状態にします。ユーザーの作成、有効化、ロールや所属の変更は行いません。
2. 実行前の準備
- 対象アプリケーションのREST APIの全インスタンス、DBを更新するジョブ、Web UIを停止します。
- 接続先DBのバックアップを取得します。
- 対象アプリケーションのインストールフォルダにある
restapiを、ターミナルまたはコマンドプロンプトで開きます。 bin/password-reset.sh(Windowsはbin\password-reset.bat)があることを確認します。
通常のREST API起動時と同じDB接続設定を使用します。複数のアプリケーションを管理している場合は、どのrestapiフォルダを開いているかを確認してください。
コマンドは、既存のソースから実行用JARをビルドしてから起動します。製品を実行できるJava環境とビルド環境が必要です。初回などは、入力待ちになるまで時間がかかることがあります。
3. 操作方法
3.1 コマンドを実行する
以下は、利用者IDがadminのユーザーを再設定する例です。別のユーザーを対象にする場合は、adminをその利用者IDに置き換えます。表示名ではなく利用者IDを指定してください。
macOS・Linux
./bin/password-reset.sh --user admin
Windows
.\bin\password-reset.bat --user admin
複数のユーザーを指定する
--usersの後へ、利用者IDを空白で区切って並べます。カンマでは区切りません。
./bin/password-reset.sh --users admin staff01 staff02
Windowsでは.\bin\password-reset.bat --users admin staff01 staff02を実行します。--user admin --user staff01のように--userを繰り返す指定もできます。同じIDを複数回指定しても、1回だけ処理します。
すべての有効ユーザーを対象にする
./bin/password-reset.sh --all
Windowsでは.\bin\password-reset.bat --allを実行します。無効なアカウントとanonymousアカウントは除外し、理由を表示します。--allと--user・--usersは併用できません。
パスワードはコマンドの引数に追加せず、起動後の入力欄へ入力します。パイプやリダイレクトを使わず、対話できる端末で実行してください。
3.2 接続先と対象ユーザーを確認する
作業フォルダ、接続先DB、対象ユーザーの利用者ID・有効状態・資格情報の状態が表示されます。対象一覧と件数を確認してから、入力を進めます。全ユーザー指定では、除外したユーザーのID・理由・件数も表示します。
資格情報の状態には、通常の状態を表すACTIVE、パスワードの期限切れを表すPASSWORD_EXPIRED、仮パスワードの期限切れを表すRESET_PASSWORD_EXPIREDなどが表示されます。資格情報が未作成の場合はCREDENTIAL_NOT_SETです。既存の有効ユーザーであれば、未作成の資格情報も設定できます。
3.3 仮パスワードと変更理由を入力する
- 「新しい仮パスワード」へ仮パスワードを入力します。入力内容は画面に表示されません。
- 「新しい仮パスワード(確認)」へ同じ値を入力します。
- 「変更理由」へ、復旧の目的を1〜1000文字で入力します。パスワードそのものは理由に記載しません。
通常のパスワードと同じ最低強度・再利用禁止のポリシーが適用されます。再利用禁止が有効な場合は、現在のパスワードや、対象になっている過去のパスワードは使えません。方針の説明はパスワードポリシーを参照してください。
3.4 再設定を確定する
次の確認でyを入力すると、再設定を実行します。以下は対象が3人の場合の例です。変更理由は目的に合わせて入力します。
変更理由(1〜1000文字): 管理者アカウントの復旧
対象の全3件のパスワードを再設定しますか [y/N]: y
大文字のYでも確定できます。それ以外を入力するとキャンセルし、データを変更せず終了します。
完了すると、次のメッセージが表示されます。
再設定件数: 3
パスワードを再設定しました。次回ログオン時に変更してください。
REST APIとWeb UIを起動し直してください。
一覧で確認したユーザーだけを更新し、確認後に作成されたユーザーを自動で対象へ加えません。資格情報と履歴、操作記録をまとめて更新し、利用できる未使用のリセットトークンを失効させます。操作記録には、CLIによる再設定であること、OSの実行ユーザー名、変更理由が残ります。パスワードやハッシュ値は出力しません。
3.5 再起動し、ログオンしてパスワードを変更する
- REST APIとWeb UIを起動し直します。
- 対象ユーザーと、設定した仮パスワードでログオンします。
- 案内に従って、利用者本人が新しいパスワードへ変更します。
仮パスワードの有効時間は既存の設定に従います。有効時間を過ぎた場合は、コマンドで別の仮パスワードを設定してやり直してください。
4. うまくいかない場合
| 表示・状況 | 確認すること |
|---|---|
| 対象アカウントが見つからない | 接続先DBと利用者IDを確認します。このコマンドではユーザーを新規作成しません。 |
| 無効なアカウント・anonymousアカウント | このコマンドの対象外です。アカウントの有効状態は変更しません。 |
| パスワードの確認が一致しない | 再実行し、同じ仮パスワードを2回入力します。 |
| 最低強度や再利用禁止のエラー | 全員の変更を取り消します。表示された利用者IDを確認し、全員のポリシーを満たす別の仮パスワードで再実行します。 |
| 対話端末が必要と表示される | パイプやリダイレクトを外し、ターミナルやコマンドプロンプトから直接実行します。 |
| ビルドのエラー | 表示されたビルド結果を確認し、Java・ビルド環境やソースの問題を解消してから再実行します。 |
| DBへの接続やテーブル定義のエラー | 接続設定と、REST APIやDB更新ジョブの停止状態を確認します。H2では、指定したDBが既に存在する必要があります。 |
| 再設定後も管理画面を操作できない | ログオンできるかを確認し、アカウントとロールを確認します。権限不足はパスワードの再設定では解消しません。 |
コマンドの終了コードは、成功が0、エラーが1、使い方の誤り・非対話実行・キャンセルが2です。
使い方だけを確認するには、次を実行します。この場合、DBへ接続しません。
./bin/password-reset.sh --help
Windowsでは.\bin\password-reset.bat --helpを実行します。
5. 参考資料
- REST API:パスワード管理
restapi/docs/md/32_password_management.md