本文へ移動
Wagby11
マニュアルのグループを選ぶ

WAGBY11 MANUAL / 30

パスワードの再設定(CUI)

メールを利用できない場合に、サーバー上のコマンドから仮パスワードを設定してログオンを復旧する手順を説明します。

最終更新日:

その他のツールの小目次へ

1. このページで伝える機能

管理者などのパスワードが分からず、メールによる再設定も利用できない場合は、サーバー上のコマンドで仮パスワードを設定できます。たとえば、データのインポート後に管理者のパスワードが取り込み内容へ変わり、ログオンできなくなった場合に利用します。

この操作は、サーバーのファイルとDB接続設定にアクセスできる運用担当者が行います。メール送信やブラウザーからの操作は不要です。AppSchemaの編集や再生成は行いません。

1人または複数のユーザー、すべての有効ユーザーを対象に資格情報を更新し、次回ログオン時にパスワードを変更する状態にします。ユーザーの作成、有効化、ロールや所属の変更は行いません。

2. 実行前の準備

  1. 対象アプリケーションのREST APIの全インスタンス、DBを更新するジョブ、Web UIを停止します。
  2. 接続先DBのバックアップを取得します。
  3. 対象アプリケーションのインストールフォルダにあるrestapiを、ターミナルまたはコマンドプロンプトで開きます。
  4. 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. 「新しい仮パスワード」へ仮パスワードを入力します。入力内容は画面に表示されません。
  2. 「新しい仮パスワード(確認)」へ同じ値を入力します。
  3. 「変更理由」へ、復旧の目的を1〜1000文字で入力します。パスワードそのものは理由に記載しません。

通常のパスワードと同じ最低強度・再利用禁止のポリシーが適用されます。再利用禁止が有効な場合は、現在のパスワードや、対象になっている過去のパスワードは使えません。方針の説明はパスワードポリシーを参照してください。

3.4 再設定を確定する

次の確認でyを入力すると、再設定を実行します。以下は対象が3人の場合の例です。変更理由は目的に合わせて入力します。

変更理由(1〜1000文字): 管理者アカウントの復旧
対象の全3件のパスワードを再設定しますか [y/N]: y

大文字のYでも確定できます。それ以外を入力するとキャンセルし、データを変更せず終了します。

完了すると、次のメッセージが表示されます。

再設定件数: 3
パスワードを再設定しました。次回ログオン時に変更してください。
REST APIとWeb UIを起動し直してください。

一覧で確認したユーザーだけを更新し、確認後に作成されたユーザーを自動で対象へ加えません。資格情報と履歴、操作記録をまとめて更新し、利用できる未使用のリセットトークンを失効させます。操作記録には、CLIによる再設定であること、OSの実行ユーザー名、変更理由が残ります。パスワードやハッシュ値は出力しません。

3.5 再起動し、ログオンしてパスワードを変更する

  1. REST APIとWeb UIを起動し直します。
  2. 対象ユーザーと、設定した仮パスワードでログオンします。
  3. 案内に従って、利用者本人が新しいパスワードへ変更します。

仮パスワードの有効時間は既存の設定に従います。有効時間を過ぎた場合は、コマンドで別の仮パスワードを設定してやり直してください。

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