rodauth 2.31.0 → 2.33.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 34f1a4bc530025482c6550375de67bf9dcbe4ea75ca9f4f775d179805629e115
-  data.tar.gz: 75339b39caf60463c076459e1fc21fd4d2291e4bc756c4cc5107edf7462c0186
+  metadata.gz: 57dd78525df05b6947a84692c0f061b435dc2d07c072f689dcda121c788c59dd
+  data.tar.gz: 984dde3de0dd4329505eaaf04e8a49b8e5c4b8347e8dea454d6aa586ab0f5846
 SHA512:
-  metadata.gz: 9e66e012fca7c52bd25206fd7711921148e8372a249047687e5429074dd9ea64461dcbbda1a0412b16920270814fef9fa5954dda701ae30af66e7a78a7975855
-  data.tar.gz: f7c9ec1aac7150a3fa1b4d2af3e8278f16ef3982d5cd84b6b2984d41b5f5b70f60e9f7c0e099d338055201d820bd099093609b2683086c5a8ec9fdf53dee2e58
+  metadata.gz: 0abb1ad9eedc3f0d23db686ac490483a86ba73c8f5a9e33bd375e5a93b98790a133b2e1da6599bfdd3759f0a56e4c890ac1cbf0f89bf7edc69e8159de7c173ed
+  data.tar.gz: 2d82400b1298b9a372ef8fd4aea5f9e1ba490e6572113a112f15e3dd1a3ed0655d4d934c84d18f61909bc6d0ed54c6bc2e1486f945da14cedbe35f1ea1614c10

data/CHANGELOG

@@ -1,3 +1,39 @@
+=== 2.33.0 (2023-12-21)
+
+* Expire SMS confirm code after 24 hours by default (jeremyevans)
+
+* Do not accidentally confirm SMS phone number on successful authentication of other second factor (Bertg) (#376, #377)
+
+* Return error response instead of 404 response for requests to valid pages with missing tokens (janko) (#375)
+
+* Do not override existing primary key value in the cached account when inserting a new account (janko) (#372)
+
+=== 2.32.0 (2023-10-23)
+
+* Remove use of Base64 in argon2 feature (jeremyevans)
+
+* Add sms_needs_confirmation_notice_flash configuration method, supporting different flash notice for successful submission (jeremyevans)
+
+* Support *_response configuration methods for overriding common notice flash/redirect handling in many features (HoneyryderChuck, jeremyevans) (#369)
+
+* Support hmac_secret rotation in the otp feature (jeremyevans) (#365)
+
+* Support hmac_secret rotation in the email_base feature (jeremyevans) (#365)
+
+* Support hmac_secret rotation in the webauthn feature (jeremyevans) (#365)
+
+* Support hmac_secret rotation in the jwt_refresh feature (jeremyevans) (#365)
+
+* Support hmac_secret rotation in the single_session feature (jeremyevans) (#365)
+
+* Support hmac_secret rotation in the remember feature (jeremyevans) (#365)
+
+* Support hmac_secret rotation via hmac_old_secret configuration method in the active_sessions feature (jeremyevans) (#365)
+
+* Support argon2 secret rotation via argon2_old_secret configuration method and the update_password_hash feature (jeremyevans) (#365)
+
+* Support jwt secret rotation via jwt_old_secret configuration method, if using jwt 2.4+ (jeremyevans) (#365)
+
 === 2.31.0 (2023-08-22)
 
 * Make clear_session work correctly for internal requests (janko) (#359)

data/README.rdoc

@@ -1323,7 +1323,7 @@ application to call Rodauth methods.
 
 If you're using the remember feature with +extend_remember_deadline?+ set to
 true, you'll want to load roda's middleware plugin with
-+forward_response_headers: true+ option, so that +Set-Cookie+ header changes
+<tt>forward_response_headers: true</tt> option, so that +Set-Cookie+ header changes
 from the +load_memory+ call in the route block are propagated when the request
 is forwarded to the main app.
 

data/doc/argon2.rdoc

@@ -2,10 +2,13 @@
 
 The argon2 feature adds the ability to replace the bcrypt password hash
 algorithm with argon2 (specifically, argon2id).  Argon2 is an alternative to
-bcrypt that offers the ability to be memory-hard.  However, if you are storing
-password hashes in a table that the database user does not have access to
-(the recommended way to use Rodauth), argon2 does not offer significant
-security advantages over bcrypt.
+bcrypt that offers the ability to be memory-hard.  However, argon2 is weaker
+than bcrypt for interactive login environments (e.g. password check times
+under a second), so for the vast majority of web applications, using the
+argon2 feature will weaken the application's security.  You should not use
+the argon2 feature unless the usage of argon2 is required or you are a
+cryptographer and understand why argon2 would be better than bcrypt for your
+application.
 
 If you are using this feature with Rodauth's database authentication functions,
 you need to make sure that the database authentication functions are configured
@@ -32,7 +35,7 @@ In this example, +DB+ should be your Sequel::Database object:
 
 The argon2 feature provides the ability to allow for a gradual migration
 from transitioning from bcrypt to argon2 and vice-versa, if you are using the
-update_password_hash.
+update_password_hash feature.
 
 Argon2 is more configurable than bcrypt in terms of password hash cost
 speficiation.  Instead of specifying the password_hash_cost value as
@@ -46,5 +49,6 @@ memory.
 
 == Auth Value Methods
 
+argon2_old_secret :: The previous secret key used as input at hashing time, used for argon2_secret rotation.  In order to rotate the argon2_secret, you must also use the update_password_hash feature, and rotation will not be finished until all users have logged in using the new secret.
 argon2_secret :: A secret key used as input at hashing time, folded into the value of the hash.
 use_argon2? :: Whether to use the argon2 password hash algorithm for new passwords (true by default). The only reason to set this to false is if you have existing passwords using argon2 that you want to support, but want to use bcrypt for new passwords.

data/doc/base.rdoc

@@ -43,6 +43,7 @@ field_error_attributes(field) :: The attributes to use for the input field tags
 flash_error_key :: The flash key to use for error messages (default: +:error+ or <tt>'error'</tt> depending on session support for symbols).
 flash_notice_key :: The flash key to use for notice messages (default: +:notice+ or <tt>'notice'</tt> depending on session support for symbols).
 formatted_field_error(field, error) :: HTML to use for error messages for the field (parameter name), if the field has an error.  By default, uses a span tag for the error message.
+hmac_old_secret :: This sets the previous secret used for Rodauth's HMACs, to allow for secret rotation.
 hook_action(hook_type, action) :: Arbitrary action to take on all hook processing, with hook type being +:before+ or +:after+, and action being symbol for related action.
 input_field_error_class :: The CSS class to use for input fields with errors. Can be a space separated string for multiple CSS classes.
 input_field_error_message_class :: The CSS class to use for error messages. Can be a space separated string for multiple CSS classes.

data/doc/change_login.rdoc

@@ -21,4 +21,5 @@ after_change_login :: Run arbitrary code after successful login change.
 before_change_login :: Run arbitrary code before changing a login.
 before_change_login_route :: Run arbitrary code before handling a change login route.
 change_login(login) :: Change the users login to the given login, or return nil/false if the login cannot be changed to the given login.
+change_login_response :: Return a response after a successful login change. By default, redirects to +change_login_redirect+.
 change_login_view :: The HTML to use for the change login form.

data/doc/change_password.rdoc

@@ -22,4 +22,5 @@ new_password_param :: The parameter name to use for new passwords.
 after_change_password :: Run arbitrary code after successful password change.
 before_change_password :: Run arbitrary code before changing the password for an account.
 before_change_password_route :: Run arbitrary code before handling a change password route.
+change_password_response :: Return a response after a successful password change. By default, redirects to +change_password_redirect+.
 change_password_view :: The HTML to use for the change password form.

data/doc/close_account.rdoc

@@ -21,5 +21,6 @@ after_close_account :: Run arbitrary code after closing the account.
 before_close_account :: Run arbitrary code before closing an account.
 before_close_account_route :: Run arbitrary code before handling a close account route.
 close_account :: Close the account, by default setting the account status to closed.
+close_account_response :: Return a response after successfully closing the account . By default, redirects to +close_account_redirect+.
 close_account_view :: The HTML to use for the close account form.
 delete_account :: If +delete_account_on_close?+ is true, delete the account when closing it.

data/doc/confirm_password.rdoc

@@ -28,4 +28,5 @@ after_confirm_password :: Run arbitrary code after successful confirmation of pa
 before_confirm_password :: Run arbitrary code before setting that the password has been confirmed.
 before_confirm_password_route :: Run arbitrary code before handling the password confirmation route.
 confirm_password :: Update the session to reflect the password has been confirmed.
+confirm_password_response :: Return a response after successful password confirmation. By default, redirects to +confirm_password_redirect+.
 confirm_password_view :: The HTML to use for the confirm password form.

data/doc/create_account.rdoc

@@ -20,6 +20,7 @@ before_create_account :: Run arbitrary code before creating the account.
 before_create_account_route :: Run arbitrary code before handling a create account route.
 create_account_autologin? :: Whether to autologin the user upon successful account creation, true by default unless verifying accounts.
 create_account_link_text :: The text to use for a link to the create account form.
+create_account_response :: Return a response after successful account creation. By default, redirects to +create_account_redirect+.
 create_account_view :: The HTML to use for the create account form.
 new_account(login) :: Instantiate a new account hash for the given login, without saving it.
 save_account :: Insert the account into the database, or return nil/false if that was not successful.

data/doc/email_auth.rdoc

@@ -43,6 +43,7 @@ create_email_auth_email :: A Mail::Message for the email auth email.
 create_email_auth_key :: Add the email auth key data to the database.
 email_auth_email_body :: The body to use for the email auth email.
 email_auth_email_link :: The link to the email auth form in the email auth email.
+email_auth_email_sent_response :: Return a response after successfully sending an email auth email. By default, redirects to +email_auth_email_sent_redirect+.
 email_auth_key_insert_hash :: The hash to insert into the +email_auth_table+.
 email_auth_key_value :: The email auth key for the current account.
 email_auth_request_form :: The HTML to use for a form to request an email auth email, shown on the login page after the user submits their login, if +force_email_auth?+ is false and email authentication is not the only possible for of authentication for the user.

data/doc/jwt.rdoc

@@ -38,6 +38,7 @@ jwt_algorithm :: The JWT algorithm to use, +HS256+ by default.
 jwt_authorization_ignore :: A regexp matched against the Authorization header, which skips JWT processing if it matches.  By default, HTTP Basic and Digest authentication are ignored.
 jwt_authorization_remove :: A regexp to remove from the Authorization header before processing the JWT.  By default, a Bearer prefix is removed.
 jwt_decode_opts :: An optional hash to pass to +JWT.decode+. Can be used to set JWT verifiers.
+jwt_old_secret :: The previous JWT secret used, to support JWT secret rotation (only supported when using jwt 2.4+).  Access to this should be protected the same as a session secret.
 jwt_secret :: The JWT secret to use.  Access to this should be protected the same as a session secret.
 jwt_session_key :: A key to nest the session hash under in the JWT payload.  nil by default, for no nesting.
 jwt_symbolize_deeply? :: Whether to symbolize the session hash deeply.  false by default.

data/doc/lockout.rdoc

@@ -46,14 +46,14 @@ unlock_account_skip_resend_email_within :: The number of seconds before sending
 
 == Auth Methods
 
-account_from_unlock_key(key) :: Retrieve the account using the given verify account key, or return nil if no account matches. 
+account_from_unlock_key(key) :: Retrieve the account using the given verify account key, or return nil if no account matches.
 after_account_lockout :: Run arbitrary code after an account has been locked out.
 after_unlock_account :: Run arbitrary code after a successful account unlock.
 after_unlock_account_request :: Run arbitrary code after a successful account unlock request.
 before_unlock_account :: Run arbitrary code before unlocking an account.
 before_unlock_account_request :: Run arbitrary code before sending an account unlock email.
 before_unlock_account_request_route :: Run arbitrary code before handling an account unlock request route.
-before_unlock_account_route :: Run arbitrary code before handling an unlock account route. 
+before_unlock_account_route :: Run arbitrary code before handling an unlock account route.
 clear_invalid_login_attempts :: Clear any stored login failures or lockouts for the current account.
 create_unlock_account_email :: A Mail::Message for the account unlock email to send.
 generate_unlock_account_key :: A random string to use for a new unlock account key.
@@ -67,5 +67,7 @@ unlock_account :: Unlock the account.
 unlock_account_email_body :: The body to use for the unlock account email.
 unlock_account_email_link :: The link to the unlock account form to include in the unlock account email.
 unlock_account_key :: The unlock account key for the current account.
+unlock_account_request_response :: Return a response after successfully requesting an account unlock. By default, redirects to +unlock_account_request_redirect+.
 unlock_account_request_view :: The HTML to use for the unlock account request form.
+unlock_account_response :: Return a response after successfully unlocking an account. By default, redirects to +unlock_account_redirect+.
 unlock_account_view :: The HTML to use for the unlock account form.

data/doc/login.rdoc

@@ -33,6 +33,7 @@ use_multi_phase_login? :: Whether to ask for login first, and only ask for passw
 == Auth Methods
 
 before_login_route :: Run arbitrary code before handling a login route.
-login_view :: The HTML to use for the login form.
+login_response :: Return a response after a successful login. By default, redirects to +login_redirect+ (or the requested location if +login_return_to_requested_location?+ is true).
 login_return_to_requested_location_path :: If +login_return_to_requested_location?+ is true, the path to use as the requested location.  By default, uses the full path of the request for GET requests, and is nil for non-GET requests (in which case the default +login_redirect+ will be used).
+login_view :: The HTML to use for the login form.
 multi_phase_login_view :: The HTML to use for the login form after login has been entered when using multi phase login.

data/doc/logout.rdoc

@@ -18,4 +18,5 @@ after_logout :: Run arbitrary code after logout.
 before_logout :: Run arbitrary code before logout.
 before_logout_route :: Run arbitrary code before handling a logout route.
 logout :: Log the user out, by default clearing the session.
+logout_response :: Return a response after a successful logout. By default, redirects to +logout_redirect+.
 logout_view :: The HTML to use for the logout form.

data/doc/otp.rdoc

@@ -71,6 +71,7 @@ otp :: The object used for verifying OTP authentication attempts.
 otp_add_key(secret) :: Add an OTP key for the current account with the given secret.
 otp_auth_view :: The HTML to use for the OTP authentication form.
 otp_available? :: Whether OTP authentication is ready for use.
+otp_disable_response :: Return a response after successfully disabling OTP . By default, redirects to +otp_disable_redirect+.
 otp_disable_view :: The HTML to use for the OTP disable form.
 otp_exists? :: Whether the current account has setup OTP.
 otp_key :: The stored OTP secret for the account.
@@ -83,8 +84,10 @@ otp_qr_code :: The QR code containing the otp_provisioning_uri, by default an SV
 otp_record_authentication_failure :: Record an OTP authentication failure.
 otp_remove :: Removes all stored OTP data for the current account.
 otp_remove_auth_failures :: Removes OTP authentication failures for the current account, used after successful multifactor authentication.
+otp_setup_response :: Return a response after successful OTP setup. By default, redirects to +otp_setup_redirect+.
 otp_setup_view :: The HTML to use for the form to setup OTP authentication.
 otp_tmp_key(secret) :: Set the secret to use for the temporary OTP key, during OTP setup.
 otp_update_last_use :: Update the last time OTP authentication was successful for the account.  Return true if the authentication should be allowed, or false if it should not be allowed because the last authentication was too recent and indicates the possible reuse of a TOTP authentication code.
+otp_valid_code_for_old_secret :: Called when valid OTP authentication is performed using hmac_old_secret.  This indicates the OTP needs to be rotated before support for the previous hmac secret value is removed.  You can use this to track users who need their OTP rotated, and take appropriate action.
 otp_valid_code?(auth_code) :: Whether the given code is the currently valid OTP auth code for the account.
 otp_valid_key?(secret) :: Whether the given secret is a valid OTP secret.

data/doc/release_notes/2.32.0.txt

@@ -0,0 +1,65 @@
+= New Features
+
+* Rodauth now supports secret rotation using the following
+  configuration methods:
+
+  * hmac_old_secret
+  * argon2_old_secret (argon2 feature)
+  * jwt_old_secret (jwt feature)
+
+  You can use these methods to specify the previous secret when
+  rotating secrets.  Note that full secret rotation (where you can
+  remove use of the old secret) may not be simple.  Here are some
+  cases that require additional work:
+
+  * Rotating the argon2 secret requires the use of the
+    update_password_hash feature.  You cannot remove the use of
+    argon2_old_secret unless every user who created a password under
+    the old secret has logged in after the new secret was added.
+    Removing the old secret before a user has logged in after the new
+    secret was added will invalidate the password for the user. Thus,
+    full rotation of the argon2 secret requires invalidating passwords
+    for inactive accounts.
+
+  * Full rotating of the hmac secret when using the remember feature
+    requires that all remember cookies created under the previous
+    secret has been removed.  By default, remember cookies expire in
+    2 weeks, but it is possible to set them much longer.
+
+  * Full rotation of the hmac secret when using the verify_account
+    feature requires invalidating old verify account links, since
+    verify account links do not have a deadline.  However, after old
+    verify account links have been invalidated, a user can request a
+    new verify account link, which will work.
+
+  * Full rotation of the hmac secret when using the otp feature
+    requires disabling otp and reenabling otp.  The
+    otp_valid_code_for_old_secret configuration method has been added,
+    which can be used to handle cases where a user successfully
+    authenticated via TOTP using the old secret.  This can be used
+    to direct them to a page to remove the TOTP authenticator and
+    then setup a new TOTP authenicator.
+
+* Many *_response configuration methods have been added, which allow
+  users to override Rodauth's default behavior in successful cases of
+  setting a flash notice and then redirecting.  Note that using these
+  configuration methods correctly requires that they halt request
+  processing.  You cannot just have them return a response body.  You
+  can use the return_response method to set the response body and
+  halt processing.
+
+* An sms_needs_confirmation_notice_flash configuration method has been
+  added, for setting the flash notice when setting up SMS
+  authentication.  By default, it uses the
+  sms_needs_confirmation_error_flash value.
+
+= Other Improvements
+
+* The argon2 feature no longer uses the Base64 constant.  Previously,
+  it uses the library without attempting to require the base64 library,
+  which would break if the base64 library was not already required.
+
+* Rodauth's documentation now recommends against the use of the argon2
+  feature, because for typical interactive login uses (targetting
+  sub-200ms response times), argon2 provides significantly worse
+  security than bcrypt.

data/doc/release_notes/2.33.0.txt

@@ -0,0 +1,18 @@
+= Improvements
+
+* Rodauth no longer accidentally confirms an SMS number upon valid
+  authentication by an alternative second factor.
+
+* Rodauth now automatically expires SMS confirmation codes after 24
+  hours by default.  You can use the sms_confirm_deadline
+  configuration method to adjust the deadline.  Previously, if an
+  invalid SMS number was submitted, or the SMS confirm code was never
+  received, it was not possible to continue SMS setup without
+  administrative intervention.
+
+* Rodauth no longer overwrites existing primary key values when
+  inserting new accounts. This fixes cases such as setting account
+  primary key values to UUIDs before inserting.
+
+* When submitting a request to a valid endpoint with a missing token,
+  Rodauth now returns an error response instead of a 404 response.

data/doc/remember.rdoc

@@ -74,5 +74,6 @@ logged_in_via_remember_key? :: Whether the current session was logged in via a r
 remembered_session_id :: The session_id which is validly remembered, if any.
 remember_key_value :: The current value of the remember key/token.
 remember_login :: Set the cookie containing the remember token, so that future sessions will be autologged in.
+remember_response :: Return a response after successfully changing remember settings. By default, redirects to +remember_redirect+.
 remember_view :: The HTML to use for the change remember settings form.
 remove_remember_key(id_value=account_id) :: Delete the related remember key from the database.

data/doc/reset_password.rdoc

@@ -56,9 +56,11 @@ login_failed_reset_password_request_form :: The HTML to use for a form to reques
 remove_reset_password_key :: Remove the reset password key for the current account, run after successful password reset.
 reset_password_email_body :: The body to use for the reset password request email.
 reset_password_email_link :: The link to the reset password form in the reset password request email.
+reset_password_email_sent_response :: Return a response after successfully sending a password reset email. By default, redirects to +reset_password_email_sent_redirect+.
 reset_password_key_insert_hash :: The hash to insert into the +reset_password_table+.
 reset_password_key_value :: The reset password key for the current account.
 reset_password_request_view :: The HTML to use for the reset password request form.
+reset_password_response :: Return a response after successfully resetting a password. By default, redirects to +reset_password_redirect+.
 reset_password_view :: The HTML to use for the reset password form.
 send_reset_password_email :: Send the reset password request email.
 set_reset_password_email_last_sent :: Set the last time a reset password request email is sent.

data/doc/sms_codes.rdoc

@@ -41,6 +41,7 @@ sms_codes_table :: The name of the table storing SMS code data.
 sms_confirm_additional_form_tags :: HTML fragment containing additional form tags when confirming SMS setup.
 sms_confirm_button :: Text to use for button on the form to confirm SMS setup.
 sms_confirm_code_length :: The length of SMS confirmation codes, 12 by default, as there is no lockout. 
+sms_confirm_deadline :: The number of seconds before an SMS confirmation code expires (86400 seconds by default).
 sms_confirm_notice_flash :: The flash notice to show when SMS authentication setup has been confirmed.
 sms_confirm_page_title :: The page title to use on the form to authenticate via SMS code.
 sms_confirm_redirect :: Where to redirect after SMS authentication setup has been confirmed.
@@ -63,6 +64,7 @@ sms_invalid_phone_message :: The error message to show when an invalid SMS phone
 sms_issued_at_column :: The column in the +sms_codes_table+ containing the time the SMS code was issued.
 sms_lockout_error_flash :: The flash error to show when SMS authentication has been locked out due to repeated failures.
 sms_lockout_redirect :: Where to redirect after SMS authentication has been locked out.
+sms_needs_confirmation_notice_flash :: The flash notice to show on SMS authentication pages when SMS authentication setup needs confirmation (uses +sms_needs_confirmation_error_flash+ by default).
 sms_needs_confirmation_error_flash :: The flash error to show on SMS authentication pages when SMS authentication setup needs confirmation.
 sms_needs_confirmation_error_status :: The response status to use on SMS authentication pages when SMS authentication setup needs confirmation, 403 by default.
 sms_needs_confirmation_redirect :: Where to redirect after SMS setup, when confirmation is required.
@@ -109,19 +111,24 @@ sms_available? :: Whether SMS authentication is ready for use.
 sms_code_issued_at :: The timestamp the current SMS code was issued at.
 sms_code_match?(code) :: Whether there is an active SMS authentication code for the current account and the given code matches it.
 sms_confirm_message(code) :: The SMS message to use for the given confirmation code.
+sms_confirm_response :: Return a response after successfully confirming SMS code during SMS setup. By default, redirects to +sms_confirm_redirect+.
 sms_confirm_view :: The HTML to use for the form to authenticate via SMS code.
 sms_confirmation_match?(code) :: Whether there is an active SMS confirmation code for the current account and the given code matches it.
 sms_current_auth? :: Whether there is a active SMS authentication code for the current account.
 sms_disable :: Action to take to disable SMS authentication for the account.
+sms_disable_response :: Return a response after successfully disabling SMS. By default, redirects to +sms_disable_redirect+.
 sms_disable_view :: The HTML to use for the form to disable SMS authentication.
 sms_failures :: The number of SMS authentication failures since the last successfully SMS authentication for this account.
 sms_locked_out? :: Whether SMS authentication has been locked out for the current account.
 sms_needs_confirmation? :: Whether SMS authentication has been setup but not confirmed for the current account.
+sms_needs_confirmation_response :: Return a response after successfully providing SMS number during SMS setup. By default, redirects to +sms_needs_confirmation_redirect+.
 sms_new_auth_code :: A new SMS authentication code that can be used for the account.
 sms_new_confirm_code :: A new SMS confirmation code that can be used for the account.
 sms_normalize_phone(phone) :: A normalized version of the given phone number, by default removing everything except 0-9.
 sms_record_failure :: Record an SMS authentication failure for the current account.
+sms_remove_expired_confirm_code :: Remove an expired SMS confirm code, allowing setup of a new sms confirm code.
 sms_remove_failures :: Reset the SMS authentication failure counter for the current account, used after a successful multifactor authentication.
+sms_request_response :: Return a response after a successful SMS request during SMS authentication. By default, redirects to +sms_auth_redirect+.
 sms_request_view :: The HTML to use for the form to request an SMS authentication code.
 sms_send(phone, message) :: Send the given message to the given phone number via SMS.  By default a NotImplementedError is raised, this is the only method that must be overridden. 
 sms_set_code(code) :: Set the SMS authentication code for the current account to the given code.  The code can be nil to specify that no SMS authentication code is currently valid.

data/doc/two_factor_base.rdoc

@@ -56,8 +56,10 @@ before_two_factor_disable :: Any actions to take before disabling of all multifa
 before_two_factor_disable_route :: Run arbitrary code before handling the multifactor disable route.
 before_two_factor_manage_route :: Run arbitrary code before handling the multifactor manage route.
 two_factor_auth_links :: An array of entries for links to show on the multifactor auth page.  Each entry is an array of three elements, sort order (integer), link href, and link text.
+two_factor_auth_response :: Return a response after successful multifactor authentication. By default, redirects to +two_factor_auth_redirect+  (or the requested location if +two_factor_auth_return_to_requested_location?+ is true).
 two_factor_auth_view :: The HTML to use for the page linking to other multifactor authentication pages.
 two_factor_authenticated? :: Whether the current session has already been multifactor authenticated.
+two_factor_disable_response :: Return a response after successfully disabling multifactor authentication. By default, redirects to +two_factor_disable_redirect+.
 two_factor_disable_view :: The HTML to use for the page for disabling all multifactor authentication.
 two_factor_manage_view :: The HTML to use for the page linking to other multifactor setup and remove pages.
 two_factor_remove :: Any action to take to remove multifactor authentication, called when closing accounts.

data/doc/verify_account.rdoc

@@ -60,6 +60,8 @@ set_verify_account_email_last_sent :: Set the last time a verify account email i
 verify_account :: Verify the account by changing the status from unverified to open.
 verify_account_email_body :: The body to use for the verify account email.
 verify_account_email_link :: The link to the verify account form in the verify account email.
+verify_account_email_sent_response :: Return a response after successfully sending an verify account email. By default, redirects to +verify_account_email_sent_redirect+.
 verify_account_key_insert_hash :: The hash to insert into the +verify_account_table+.
 verify_account_key_value :: The value of the verify account key.
+verify_account_response :: Return a response after successfully verifying an account. By default, redirects to +verify_account_redirect+.
 verify_account_view :: The HTML to use for the verify account form.

data/doc/verify_login_change.rdoc

@@ -55,4 +55,5 @@ verify_login_change_key_insert_hash(login) :: The hash to insert into the +verif
 verify_login_change_key_value :: The value of the verify login change key.
 verify_login_change_new_login :: The new login to use when the login change is verified.
 verify_login_change_old_login :: The old login to display in the verify login change email.
+verify_login_change_response :: Return a response after successfully verifying a login change. By default, redirects to +verify_login_change_redirect+.
 verify_login_change_view :: The HTML to use for the verify login change form.

data/doc/webauthn.rdoc

@@ -109,8 +109,10 @@ webauthn_auth_view :: The HTML to use for the page for authenticating via WebAut
 webauthn_credential_options_for_get :: WebAuthn credential options to provide to the client during WebAuthn authentication.
 webauthn_key_insert_hash(webauthn_credential) :: The hash to insert into the +webauthn_keys_table+.
 webauthn_remove_authenticated_session :: Remove the authenticated WebAuthn ID, used when removing the WebAuthn credential with the ID after authenticating with it.
+webauthn_remove_response :: Return a response after successfully removing a WebAuthn authenticator. By default, redirects to +webauthn_remove_redirect+.
 webauthn_remove_view :: The HTML to use for the page for removing an existing WebAuthn authenticator.
 webauthn_setup_js_path :: The path to the WebAuthn registration javascript.
+webauthn_setup_response :: Return a response after successfully setting up a WebAuthn authenticator. By default, redirects to +webauthn_setup_redirect+.
 webauthn_setup_view :: The HTML to use for the page for registering a new WebAuthn authenticator.
 webauthn_update_session(webauthn_id) :: Set the authenticated WebAuthn ID after authenticating via WebAuthn.
 webauthn_user_name :: The user name to use when registering a new WebAuthn credential, the user's email by default.

data/lib/rodauth/features/active_sessions.rb

@@ -40,7 +40,7 @@ module Rodauth
 
       remove_inactive_sessions
       ds = active_sessions_ds.
-        where(active_sessions_session_id_column => compute_hmac(session_id))
+        where(active_sessions_session_id_column => compute_hmacs(session_id))
 
       if update_current_session?
         ds.update(active_sessions_update_hash) == 1
@@ -83,7 +83,7 @@ module Rodauth
 
     def remove_current_session
       if session_id = session[session_id_session_key]
-        remove_active_session(compute_hmac(session_id))
+        remove_active_session(compute_hmacs(session_id))
       end
     end
 
@@ -119,7 +119,7 @@ module Rodauth
         key = generate_active_sessions_key
         set_session_value(session_id_session_key, key)
         active_sessions_ds.
-          where(active_sessions_session_id_column => compute_hmac(prev_key)).
+          where(active_sessions_session_id_column => compute_hmacs(prev_key)).
           update(active_sessions_session_id_column => compute_hmac(key))
       end
     end
@@ -150,7 +150,13 @@ module Rodauth
     end
 
     def active_sessions_update_hash
-      {active_sessions_last_use_column => Sequel::CURRENT_TIMESTAMP}
+      h = {active_sessions_last_use_column => Sequel::CURRENT_TIMESTAMP}
+
+      if hmac_secret_rotation?
+        h[active_sessions_session_id_column] = compute_hmac(session[session_id_session_key])
+      end
+
+      h
     end
 
     def session_inactivity_deadline_condition

data/lib/rodauth/features/argon2.rb

@@ -12,6 +12,7 @@ module Rodauth
   Feature.define(:argon2, :Argon2) do
     depends :login_password_requirements_base
 
+    auth_value_method :argon2_old_secret, nil
     auth_value_method :argon2_secret, nil
     auth_value_method :use_argon2?, true
 
@@ -53,16 +54,19 @@ module Rodauth
 
     def password_hash_using_salt(password, salt)
       return super unless argon2_hash_algorithm?(salt)
+      argon2_password_hash_using_salt_and_secret(password, salt, argon2_secret)
+    end
 
+    def argon2_password_hash_using_salt_and_secret(password, salt, secret)
       argon2_params = Hash[extract_password_hash_cost(salt)]
-      argon2_params[argon2_salt_option] = Base64.decode64(salt.split('$').last)
-      argon2_params[:secret] = argon2_secret
+      argon2_params[argon2_salt_option] = salt.split('$').last.unpack("m")[0]
+      argon2_params[:secret] = secret
       ::Argon2::Password.new(argon2_params).create(password)
     end
 
     if Argon2::VERSION >= '2.1'
       def extract_password_hash_cost(hash)
-        return super unless argon2_hash_algorithm?(hash )
+        return super unless argon2_hash_algorithm?(hash)
 
         /\A\$argon2id\$v=\d+\$m=(\d+),t=(\d+),p=(\d+)/ =~ hash
         { t_cost: $2.to_i, m_cost: Math.log2($1.to_i).to_i, p_cost: $3.to_i }
@@ -70,7 +74,7 @@ module Rodauth
 
       if ENV['RACK_ENV'] == 'test'
         def argon2_hash_cost
-          { t_cost: 1, m_cost: 3, p_cost: 1 }
+          { t_cost: 1, m_cost: 5, p_cost: 1 }
         end
       # :nocov:
       else
@@ -88,7 +92,7 @@ module Rodauth
 
       if ENV['RACK_ENV'] == 'test'
         def argon2_hash_cost
-          { t_cost: 1, m_cost: 3 }
+          { t_cost: 1, m_cost: 5 }
         end
       else
         def argon2_hash_cost
@@ -103,7 +107,23 @@ module Rodauth
     end
 
     def argon2_password_hash_match?(hash, password)
-      ::Argon2::Password.verify_password(password, hash, argon2_secret)
+      ret = ::Argon2::Password.verify_password(password, hash, argon2_secret)
+
+      if ret == false && argon2_old_secret != argon2_secret && (ret = ::Argon2::Password.verify_password(password, hash, argon2_old_secret))
+        @update_password_hash = true
+      end
+
+      ret
+    end
+
+    def database_function_password_match?(name, hash_id, password, salt)
+      return true if super
+
+      if use_argon2? && argon2_hash_algorithm?(salt) && argon2_old_secret != argon2_secret && (ret = db.get(Sequel.function(function_name(name), hash_id, argon2_password_hash_using_salt_and_secret(password, salt, argon2_old_secret))))
+        @update_password_hash = true
+      end
+
+      !!ret
     end
   end
 end

data/lib/rodauth/features/base.rb

@@ -27,6 +27,7 @@ module Rodauth
     auth_value_method :convert_token_id_to_integer?, nil
     flash_key :flash_error_key, :error
     flash_key :flash_notice_key, :notice
+    auth_value_method :hmac_old_secret, nil
     auth_value_method :hmac_secret, nil
     translatable_method :input_field_label_suffix, ''
     auth_value_method :input_field_error_class, 'error is-invalid'
@@ -242,9 +243,24 @@ module Rodauth
 
     # Return urlsafe base64 HMAC for data, assumes hmac_secret is set.
     def compute_hmac(data)
-      s = [compute_raw_hmac(data)].pack('m').chomp!("=\n")
-      s.tr!('+/', '-_')
-      s
+      _process_raw_hmac(compute_raw_hmac(data))
+    end
+
+    # Return urlsafe base64 HMAC for data using hmac_old_secret, assumes hmac_old_secret is set.
+    def compute_old_hmac(data)
+      _process_raw_hmac(compute_raw_hmac_with_secret(data, hmac_old_secret))
+    end
+
+    # Return array of hmacs.  Array has two strings if hmac_old_secret
+    # is set, or one string otherwise.
+    def compute_hmacs(data)
+      hmacs = [compute_hmac(data)]
+
+      if hmac_old_secret
+        hmacs << compute_old_hmac(data)
+      end
+
+      hmacs
     end
 
     def account_id
@@ -515,6 +531,13 @@ module Rodauth
       yield
     end
 
+    def _process_raw_hmac(hmac)
+      s = [hmac].pack('m')
+      s.chomp!("=\n")
+      s.tr!('+/', '-_')
+      s
+    end
+
     def database_function_password_match?(name, hash_id, password, salt)
       db.get(Sequel.function(function_name(name), hash_id, password_hash_using_salt(password, salt)))
     end
@@ -711,10 +734,17 @@ module Rodauth
       ds.first
     end
 
+    def hmac_secret_rotation?
+      hmac_secret && hmac_old_secret && hmac_secret != hmac_old_secret
+    end
+
     def compute_raw_hmac(data)
       raise ArgumentError, "hmac_secret not set" unless hmac_secret
+      compute_raw_hmac_with_secret(data, hmac_secret)
+    end
 
-      OpenSSL::HMAC.digest(OpenSSL::Digest::SHA256.new, hmac_secret, data)
+    def compute_raw_hmac_with_secret(data, secret)
+      OpenSSL::HMAC.digest(OpenSSL::Digest::SHA256.new, secret, data)
     end
 
     def _field_attributes(field)
@@ -822,6 +852,11 @@ module Rodauth
       false
     end
 
+    def require_response(meth)
+      send(meth)
+      raise RuntimeError, "#{meth.to_s.sub(/\A_/, '')} overridden without returning a response (should use redirect or request.halt). This is a bug in your Rodauth configuration, not a bug in Rodauth itself."
+    end
+
     def set_session_value(key, value)
       session[key] = value
     end