今日のひとこと Challange IT For Future

Fess 15.10でローカルユーザーのパスキーを設定する

Fess 読了 3分
目次
  1. HTTPSの公開URLに合わせて設定する
  2. パスワードでログインしてから登録する
  3. 複数ノードとバックアップを確認する
  4. 関連PR

Fess 15.10の開発ブランチに、ローカルユーザー向けのWebAuthnパスキーログインが入りました。パスキーに対応したブラウザーで、登録済みのパスキーか従来のパスワードを選んでログインできます。

HTTPSの公開URLに合わせて設定する

初期値は passkey.enabled=false、passkey.rp.name=Fess で、passkey.rp.id と passkey.origins は空です。対応ビルドの fess_config.properties に以下を設定してFessを再起動します。例では、利用者がブラウザーで開くURLは https://fess.example.com です。

passkey.enabled=true
passkey.rp.id=example.com
passkey.rp.name=Fess
passkey.origins=https://fess.example.com

passkey.rp.id はパスキーを紐づけるドメインです。後で変更すると登録済みのパスキーは使えなくなります。passkey.origins には利用者が開くオリジンをカンマ区切りで指定し、非標準ポートがある場合はポートも含めます。RP IDが空、またはオリジンが空か不正な場合は警告が出て機能が無効のままになります。

パスワードでログインしてから登録する

ローカルユーザーでログインし、プロフィールのパスキー欄から現在のパスワードを再入力して登録します。LDAPやSSOのアカウントは連携先で認証情報を管理します。ローカルユーザーでも同じ名前とパスワードをLDAPが受け付ける場合は登録できません。標準テーマと管理コンソールのログイン画面が対応し、外部テーマでは対応ビルドが必要です。

複数ノードとバックアップを確認する

チャレンジはHTTPセッションに保存され、有効時間は5分で一度だけ使えます。複数ノードではOpenSearchによる共有セッション(FESS_SESSION_STORE=opensearch)か、ロードバランサーで同じセッションを同じノードへ送る設定を使います。利用者がパスキーを削除するか管理者がリセットすると、対象ユーザーの別セッションは次回の確認時に終了します。確認間隔の初期値は60秒です。

既定のパスキー用インデックス fess_user.passkey は機能が無効でも起動時に作られます。インデックス作成権限を制限している環境ではアップグレード前に配布のマッピングから用意します。通常の fess_user.bulk バックアップにはパスキーが含まれないため、このバックアップから復元した場合は利用者が再登録します。

関連PR

fess #3795、fess #3800、fess #3801、fess #3803、fess-themes #105、fess-parent #97