rodauth 2.36.0 → 2.37.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (159) hide show
  1. checksums.yaml +4 -4
  2. data/lib/rodauth/features/base.rb +15 -1
  3. data/lib/rodauth/features/change_login.rb +2 -2
  4. data/lib/rodauth/features/create_account.rb +2 -2
  5. data/lib/rodauth/features/email_auth.rb +1 -1
  6. data/lib/rodauth/features/internal_request.rb +4 -4
  7. data/lib/rodauth/features/json.rb +5 -0
  8. data/lib/rodauth/features/jwt.rb +5 -9
  9. data/lib/rodauth/features/lockout.rb +1 -1
  10. data/lib/rodauth/features/login.rb +1 -1
  11. data/lib/rodauth/features/login_password_requirements_base.rb +13 -0
  12. data/lib/rodauth/features/reset_password.rb +1 -1
  13. data/lib/rodauth/features/two_factor_base.rb +6 -13
  14. data/lib/rodauth/features/verify_account.rb +2 -2
  15. data/lib/rodauth/features/webauthn_autofill.rb +2 -1
  16. data/lib/rodauth/features/webauthn_login.rb +1 -1
  17. data/lib/rodauth/version.rb +1 -1
  18. data/lib/rodauth.rb +6 -2
  19. metadata +3 -258
  20. data/CHANGELOG +0 -521
  21. data/README.rdoc +0 -1555
  22. data/doc/account_expiration.rdoc +0 -41
  23. data/doc/active_sessions.rdoc +0 -56
  24. data/doc/argon2.rdoc +0 -54
  25. data/doc/audit_logging.rdoc +0 -44
  26. data/doc/base.rdoc +0 -123
  27. data/doc/change_login.rdoc +0 -25
  28. data/doc/change_password.rdoc +0 -26
  29. data/doc/change_password_notify.rdoc +0 -14
  30. data/doc/close_account.rdoc +0 -26
  31. data/doc/confirm_password.rdoc +0 -32
  32. data/doc/create_account.rdoc +0 -27
  33. data/doc/disallow_common_passwords.rdoc +0 -17
  34. data/doc/disallow_password_reuse.rdoc +0 -30
  35. data/doc/email_auth.rdoc +0 -55
  36. data/doc/email_base.rdoc +0 -18
  37. data/doc/error_reasons.rdoc +0 -77
  38. data/doc/guides/admin_activation.rdoc +0 -46
  39. data/doc/guides/already_authenticated.rdoc +0 -10
  40. data/doc/guides/alternative_login.rdoc +0 -46
  41. data/doc/guides/change_table_and_column_names.rdoc +0 -19
  42. data/doc/guides/create_account_programmatically.rdoc +0 -38
  43. data/doc/guides/delay_password.rdoc +0 -25
  44. data/doc/guides/email_only.rdoc +0 -16
  45. data/doc/guides/i18n.rdoc +0 -29
  46. data/doc/guides/internals.rdoc +0 -233
  47. data/doc/guides/links.rdoc +0 -12
  48. data/doc/guides/login_return.rdoc +0 -37
  49. data/doc/guides/migrate_password_hash_algorithm.rdoc +0 -15
  50. data/doc/guides/password_column.rdoc +0 -25
  51. data/doc/guides/password_confirmation.rdoc +0 -37
  52. data/doc/guides/password_requirements.rdoc +0 -43
  53. data/doc/guides/paths.rdoc +0 -51
  54. data/doc/guides/query_params.rdoc +0 -9
  55. data/doc/guides/redirects.rdoc +0 -17
  56. data/doc/guides/registration_field.rdoc +0 -68
  57. data/doc/guides/render_confirmation.rdoc +0 -17
  58. data/doc/guides/require_mfa.rdoc +0 -30
  59. data/doc/guides/reset_password_autologin.rdoc +0 -21
  60. data/doc/guides/share_configuration.rdoc +0 -34
  61. data/doc/guides/status_column.rdoc +0 -28
  62. data/doc/guides/totp_or_recovery.rdoc +0 -16
  63. data/doc/http_basic_auth.rdoc +0 -18
  64. data/doc/internal_request.rdoc +0 -539
  65. data/doc/json.rdoc +0 -56
  66. data/doc/jwt.rdoc +0 -52
  67. data/doc/jwt_cors.rdoc +0 -22
  68. data/doc/jwt_refresh.rdoc +0 -58
  69. data/doc/lockout.rdoc +0 -73
  70. data/doc/login.rdoc +0 -39
  71. data/doc/login_password_requirements_base.rdoc +0 -44
  72. data/doc/logout.rdoc +0 -22
  73. data/doc/otp.rdoc +0 -93
  74. data/doc/otp_lockout_email.rdoc +0 -30
  75. data/doc/otp_modify_email.rdoc +0 -19
  76. data/doc/otp_unlock.rdoc +0 -58
  77. data/doc/password_complexity.rdoc +0 -34
  78. data/doc/password_expiration.rdoc +0 -38
  79. data/doc/password_grace_period.rdoc +0 -24
  80. data/doc/password_pepper.rdoc +0 -52
  81. data/doc/path_class_methods.rdoc +0 -10
  82. data/doc/recovery_codes.rdoc +0 -61
  83. data/doc/release_notes/1.0.0.txt +0 -443
  84. data/doc/release_notes/1.1.0.txt +0 -8
  85. data/doc/release_notes/1.10.0.txt +0 -80
  86. data/doc/release_notes/1.11.0.txt +0 -32
  87. data/doc/release_notes/1.12.0.txt +0 -61
  88. data/doc/release_notes/1.13.0.txt +0 -34
  89. data/doc/release_notes/1.14.0.txt +0 -19
  90. data/doc/release_notes/1.15.0.txt +0 -21
  91. data/doc/release_notes/1.16.0.txt +0 -31
  92. data/doc/release_notes/1.17.0.txt +0 -23
  93. data/doc/release_notes/1.18.0.txt +0 -26
  94. data/doc/release_notes/1.19.0.txt +0 -116
  95. data/doc/release_notes/1.2.0.txt +0 -18
  96. data/doc/release_notes/1.20.0.txt +0 -175
  97. data/doc/release_notes/1.21.0.txt +0 -12
  98. data/doc/release_notes/1.22.0.txt +0 -11
  99. data/doc/release_notes/1.23.0.txt +0 -32
  100. data/doc/release_notes/1.3.0.txt +0 -21
  101. data/doc/release_notes/1.4.0.txt +0 -11
  102. data/doc/release_notes/1.5.0.txt +0 -74
  103. data/doc/release_notes/1.6.0.txt +0 -37
  104. data/doc/release_notes/1.7.0.txt +0 -6
  105. data/doc/release_notes/1.8.0.txt +0 -14
  106. data/doc/release_notes/1.9.0.txt +0 -15
  107. data/doc/release_notes/2.0.0.txt +0 -361
  108. data/doc/release_notes/2.1.0.txt +0 -31
  109. data/doc/release_notes/2.10.0.txt +0 -47
  110. data/doc/release_notes/2.11.0.txt +0 -31
  111. data/doc/release_notes/2.12.0.txt +0 -17
  112. data/doc/release_notes/2.13.0.txt +0 -19
  113. data/doc/release_notes/2.14.0.txt +0 -17
  114. data/doc/release_notes/2.15.0.txt +0 -48
  115. data/doc/release_notes/2.16.0.txt +0 -20
  116. data/doc/release_notes/2.17.0.txt +0 -10
  117. data/doc/release_notes/2.18.0.txt +0 -27
  118. data/doc/release_notes/2.19.0.txt +0 -61
  119. data/doc/release_notes/2.2.0.txt +0 -39
  120. data/doc/release_notes/2.20.0.txt +0 -10
  121. data/doc/release_notes/2.21.0.txt +0 -28
  122. data/doc/release_notes/2.22.0.txt +0 -43
  123. data/doc/release_notes/2.23.0.txt +0 -15
  124. data/doc/release_notes/2.24.0.txt +0 -15
  125. data/doc/release_notes/2.25.0.txt +0 -8
  126. data/doc/release_notes/2.26.0.txt +0 -45
  127. data/doc/release_notes/2.27.0.txt +0 -35
  128. data/doc/release_notes/2.28.0.txt +0 -16
  129. data/doc/release_notes/2.29.0.txt +0 -27
  130. data/doc/release_notes/2.3.0.txt +0 -37
  131. data/doc/release_notes/2.30.0.txt +0 -15
  132. data/doc/release_notes/2.31.0.txt +0 -47
  133. data/doc/release_notes/2.32.0.txt +0 -65
  134. data/doc/release_notes/2.33.0.txt +0 -18
  135. data/doc/release_notes/2.34.0.txt +0 -36
  136. data/doc/release_notes/2.35.0.txt +0 -22
  137. data/doc/release_notes/2.36.0.txt +0 -35
  138. data/doc/release_notes/2.4.0.txt +0 -22
  139. data/doc/release_notes/2.5.0.txt +0 -20
  140. data/doc/release_notes/2.6.0.txt +0 -37
  141. data/doc/release_notes/2.7.0.txt +0 -33
  142. data/doc/release_notes/2.8.0.txt +0 -20
  143. data/doc/release_notes/2.9.0.txt +0 -21
  144. data/doc/remember.rdoc +0 -79
  145. data/doc/reset_password.rdoc +0 -66
  146. data/doc/reset_password_notify.rdoc +0 -17
  147. data/doc/session_expiration.rdoc +0 -28
  148. data/doc/single_session.rdoc +0 -37
  149. data/doc/sms_codes.rdoc +0 -138
  150. data/doc/two_factor_base.rdoc +0 -70
  151. data/doc/update_password_hash.rdoc +0 -7
  152. data/doc/verify_account.rdoc +0 -67
  153. data/doc/verify_account_grace_period.rdoc +0 -19
  154. data/doc/verify_login_change.rdoc +0 -59
  155. data/doc/webauthn.rdoc +0 -118
  156. data/doc/webauthn_autofill.rdoc +0 -19
  157. data/doc/webauthn_login.rdoc +0 -16
  158. data/doc/webauthn_modify_email.rdoc +0 -19
  159. data/doc/webauthn_verify_account.rdoc +0 -9
@@ -1,70 +0,0 @@
1
- = Documentation for Two Factor Base Feature
2
-
3
- The two_factor_base feature implements shared functionality for the other
4
- multifactor authentication features.
5
-
6
- To handle multiple and potentially different multifactor authentication setups
7
- per user, this feature implements disambiguation pages for multifactor
8
- authentication and manage. If only a single multifactor authentication is
9
- available to setup, the manage page will redirect to the appropriate page.
10
- Likewise, if only a single multifactor authentication method is available,
11
- the authentication page will redirect to the appropriate page. Otherwise,
12
- the authentication and manage pages will show links to the available pages.
13
- Additionally, there is a separate page for disabling all multifactor
14
- authentication methods and reverting to single factor authentication,
15
- so users do not have to disable each multifactor authentication method
16
- individually.
17
-
18
- == Auth Value Methods
19
-
20
- two_factor_already_authenticated_error_flash :: The flash error to show if going to a multifactor authentication page when already multifactor authenticated.
21
- two_factor_already_authenticated_error_status :: The response status to use if going to a multifactor authentication page when already multifactor authenticated, 403 by default.
22
- two_factor_already_authenticated_redirect :: Where to redirect if going to a multifactor authentication page when already multifactor authenticated.
23
- two_factor_auth_notice_flash :: The flash notice to show after a successful multifactor authentication.
24
- two_factor_auth_page_title :: The page title to use on the page linking to other multifactor authentication pages.
25
- two_factor_auth_redirect :: Where to redirect after a successful multifactor authentication.
26
- two_factor_auth_redirect_session_key :: The key in the session hash storing the location to redirect to after successful multifactor authentication.
27
- two_factor_auth_required_redirect :: Where to redirect if going to a page requiring multifactor authentication when not multifactor authenticated (the multifactor auth page by default).
28
- two_factor_auth_return_to_requested_location? :: Whether to redirect to the originally requested location after successful multifactor authentication when +require_two_factor_authenticated+ was used, false by default.
29
- two_factor_auth_route :: The route to the multifactor authentication page. Defaults to +multifactor-auth+.
30
- two_factor_disable_additional_form_tags :: HTML fragment containing additional form tags when disabling all multifactor authentication.
31
- two_factor_disable_button :: Text to use for button on the form to disable all multifactor authentication.
32
- two_factor_disable_error_flash :: The flash error to show if unable to disable all multifactor authentication.
33
- two_factor_disable_link_text :: The text to use for the link to disable all multifactor authentication from the multifactor manage page.
34
- two_factor_disable_notice_flash :: The flash notice to show after a successfully disabling all multifactor authentication.
35
- two_factor_disable_page_title :: The page title to use on the page for disabling all multifactor authentication.
36
- two_factor_disable_redirect :: Where to redirect after a successfully disabling all multifactor authentication.
37
- two_factor_disable_route :: The route to the page to disable all multifactor authentication. Defaults to +multifactor-disable+.
38
- two_factor_manage_page_title :: The page title to use on the page linking to other multifactor setup and remove pages.
39
- two_factor_manage_route :: The route to the page to manage multifactor authentication. Defaults to +multifactor-manage+.
40
- two_factor_modifications_require_password? :: Whether modifications to multifactor authentication require the inputing the user's password.
41
- two_factor_need_authentication_error_flash :: The flash error to show if going to a page that requires multifactor authentication when not authenticated.
42
- two_factor_need_authentication_error_status :: The response status to use if going to a page that requires multifactor authentication when not authenticated, 401 by default.
43
- two_factor_need_setup_redirect :: Where to redirect if going to a multifactor authentication page when multifactor authentication has not been setup (the multifactor manage page by default).
44
- two_factor_not_setup_error_flash :: The flash error to show if going to a multifactor authentication page when multifactor authentication has not been setup.
45
- two_factor_not_setup_error_status :: The response status to use if going to a multifactor authentication page when multifactor authentication has not been setup, 403 by default.
46
- two_factor_remove_heading :: The HTML to use above the remove links on the multifactor manage page.
47
- two_factor_setup_heading :: The HTML to use above the setup links on the multifactor manage page.
48
- two_factor_setup_session_key :: The session key used for storing whether multifactor authentication has been setup for the current account.
49
-
50
- == Auth Methods
51
-
52
- after_two_factor_authentication :: Any actions to take after successful multifactor authentication.
53
- after_two_factor_disable :: Any actions to take after successful disabling of all multifactor authentication.
54
- before_two_factor_auth_route :: Run arbitrary code before handling the multifactor auth route.
55
- before_two_factor_disable :: Any actions to take before disabling of all multifactor authentication.
56
- before_two_factor_disable_route :: Run arbitrary code before handling the multifactor disable route.
57
- before_two_factor_manage_route :: Run arbitrary code before handling the multifactor manage route.
58
- 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.
59
- 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).
60
- two_factor_auth_view :: The HTML to use for the page linking to other multifactor authentication pages.
61
- two_factor_authenticated? :: Whether the current session has already been multifactor authenticated.
62
- two_factor_disable_response :: Return a response after successfully disabling multifactor authentication. By default, redirects to +two_factor_disable_redirect+.
63
- two_factor_disable_view :: The HTML to use for the page for disabling all multifactor authentication.
64
- two_factor_manage_view :: The HTML to use for the page linking to other multifactor setup and remove pages.
65
- two_factor_remove :: Any action to take to remove multifactor authentication, called when closing accounts.
66
- two_factor_remove_auth_failures :: Any action to take to remove multifactor authentication failures, called after a successful multifactor authentication.
67
- two_factor_remove_links :: An array of entries for remove links to show on the multifactor manage page. Each entry is an array of three elements, sort order (integer), link href, and link text.
68
- two_factor_remove_session :: What actions to take to remove multifactor authentication status from the session, called when disabling multifactor authentication when authenticated using the factor being removed.
69
- two_factor_setup_links :: An array of entries for setup links to show on the multifactor manage page. Each entry is an array of three elements, sort order (integer), link href, and link text.
70
- two_factor_update_session(type) :: How to update the session to reflect a successful multifactor authentication.
@@ -1,7 +0,0 @@
1
- = Documentation for Update Password Hash Feature
2
-
3
- The update password hash feature updates the hash for the password whenever
4
- the hash cost changes. For example, if you have a cost of 8, and later
5
- increase the cost to 10, anytime the user authenticates correctly with
6
- their password, their password hash will change from one that uses a cost
7
- of 8 to one that uses a cost of 10.
@@ -1,67 +0,0 @@
1
- = Documentation for Verify Account Feature
2
-
3
- The verify account feature implements account verification after account
4
- creation. After account creation, users are sent an email containing
5
- a link to verify the account. Users cannot login to the account until
6
- after verifying the account. Depends on the login and create account features.
7
-
8
- == Auth Value Methods
9
-
10
- attempt_to_create_unverified_account_error_flash :: The flash error message to show when attempting to create an account awaiting verification.
11
- attempt_to_login_to_unverified_account_error_flash :: The flash error message to show when attempting to login to an account awaiting verification.
12
- no_matching_verify_account_key_error_flash :: The flash error message to show when an invalid verify account key is used.
13
- resend_verify_account_page_title :: The page title to use on page requesting resending the verify account email.
14
- verify_account_additional_form_tags :: HTML fragment containing additional form tags to use on the verify account form.
15
- verify_account_autologin? :: Whether to autologin the user after successful account verification, true by default.
16
- verify_account_button :: The text to use for the verify account button.
17
- verify_account_email_last_sent_column :: The email last sent column in the +verify_account_table+. Set to nil to always send a verify account email when requested.
18
- verify_account_email_recently_sent_error_flash :: The flash error to show if not sending verify account email because one has been sent recently.
19
- verify_account_email_recently_sent_redirect :: Where to redirect if not sending verify account email because one has been sent recently.
20
- verify_account_email_sent_notice_flash :: The flash notice to set after sending the verify account email.
21
- verify_account_email_sent_redirect :: Where to redirect after sending the verify account email.
22
- verify_account_email_subject :: The subject to use for the verify account email.
23
- verify_account_error_flash :: The flash error to show if no matching key is submitted when verifying an account.
24
- verify_account_id_column :: The id column in the +verify_account_table+, should be a foreign key referencing the accounts table.
25
- verify_account_key_column :: The verify account key/token column in the +verify_account_table+.
26
- verify_account_key_param :: The parameter name to use for the verify account key.
27
- verify_account_notice_flash :: The flash notice to show after verifying the account.
28
- verify_account_page_title :: The page title to use on the verify account form.
29
- verify_account_redirect :: Where to redirect after verifying the account.
30
- verify_account_resend_additional_form_tags :: HTML fragment containing additional form tags to use on the page requesting resending the verify account email.
31
- verify_account_resend_button :: The text to use for the verify account resend button.
32
- verify_account_resend_error_flash :: The flash error to show if unable to resend a verify account email.
33
- verify_account_resend_explanatory_text :: The text to display above the button to resend the verify account email.
34
- verify_account_resend_link_text :: The text to use for a link to the page to request the account verification email be resent.
35
- verify_account_resend_route :: The route to the verify account resend action. Defaults to +verify-account-resend+.
36
- verify_account_route :: The route to the verify account action. Defaults to +verify-account+.
37
- verify_account_session_key :: The key in the session to hold the verify account key temporarily.
38
- verify_account_set_password? :: Whether to ask for a password to be set on the verify account form. True by default. If set to false, will ask for password when creating the account instead of when verifying.
39
- verify_account_skip_resend_email_within :: The number of seconds before sending another verify account email, if +verify_account_email_last_sent_column+ is set.
40
- verify_account_table :: The name of the verify account keys table.
41
-
42
- == Auth Methods
43
-
44
- account_from_verify_account_key(key) :: Retrieve the account using the given verify account key, or return nil if no account matches.
45
- after_verify_account :: Run arbitrary code after verifying the account.
46
- after_verify_account_email_resend :: Run arbitrary code after resending a verify account email.
47
- allow_resending_verify_account_email? :: Whether to allow sending the verify account email for the account, true by default only if the account has not been verified.
48
- before_verify_account :: Run arbitrary code before verifying the account.
49
- before_verify_account_email_resend :: Run arbitrary code before resending a verify account email.
50
- before_verify_account_resend_route :: Run arbitrary code before handling a verify account resend route.
51
- before_verify_account_route :: Run arbitrary code before handling a verify account route.
52
- create_verify_account_email :: A Mail::Message for the verify account email.
53
- create_verify_account_key :: Add the verify account key data to the database.
54
- get_verify_account_email_last_sent :: Get the last time a verify account email is sent, or nil if there is no last sent time.
55
- get_verify_account_key(id) :: Get the verify account key for the given account id from the database.
56
- remove_verify_account_key :: Remove the verify account key for the current account, run after successful account verification.
57
- resend_verify_account_view :: The HTML to use for page requesting resending the verify account email.
58
- send_verify_account_email :: Send the verify account email.
59
- set_verify_account_email_last_sent :: Set the last time a verify account email is sent.
60
- verify_account :: Verify the account by changing the status from unverified to open.
61
- verify_account_email_body :: The body to use for the verify account email.
62
- verify_account_email_link :: The link to the verify account form in the verify account email.
63
- verify_account_email_sent_response :: Return a response after successfully sending an verify account email. By default, redirects to +verify_account_email_sent_redirect+.
64
- verify_account_key_insert_hash :: The hash to insert into the +verify_account_table+.
65
- verify_account_key_value :: The value of the verify account key.
66
- verify_account_response :: Return a response after successfully verifying an account. By default, redirects to +verify_account_redirect+.
67
- verify_account_view :: The HTML to use for the verify account form.
@@ -1,19 +0,0 @@
1
- = Documentation for Verify Account Grace Period Feature
2
-
3
- The verify account grace period feature allows users to login for
4
- a given period of time (1 day by default) before their account is
5
- verified. Depends on the verify account feature. This switches
6
- the +verify_account_set_password?+ to false so that user can login
7
- with a password during the grace period.
8
-
9
- == Auth Value Methods
10
-
11
- unverified_account_session_key :: The session key set if the logged in account has not been unverified.
12
- unverified_change_login_error_flash :: The flash error to show when an unverified accounts accesses a change login route.
13
- unverified_change_login_redirect :: Where to redirect when an unverified accounts accesses a change login route.
14
- verification_requested_at_column :: The column in the +verify_account_table+ table that holds the verification requested timestamp.
15
- verify_account_grace_period :: The amount of seconds after an account creation that a user will be able to login without verifying (86400 by default).
16
-
17
- == Auth Methods
18
-
19
- account_in_unverified_grace_period? :: Whether the current account is in an unverified grace period.
@@ -1,59 +0,0 @@
1
- = Documentation for Verify Login Change Feature
2
-
3
- The verify login change feature implements verification of login
4
- changes. With this feature, login changes do not take effect
5
- until after the user has verified the new login. Until the new
6
- login has been verified, the old login continues to work.
7
-
8
- Any time you use the verify account and change login features together,
9
- you should probably use this, otherwise it is trivial for users to work
10
- around account verification by creating an account with an email address
11
- they control, and the changing the login to an email address they don't
12
- control. Depends on the change login and email base features.
13
-
14
- == Auth Value Methods
15
-
16
- no_matching_verify_login_change_key_error_flash :: The flash error message to show when an invalid verify login change key is used.
17
- change_login_needs_verification_notice_flash :: The flash notice to show after changing a login when using this feature, if +change_login_notice_flash+ is not overridden.
18
- verify_login_change_additional_form_tags :: HTML fragment containing additional form tags to use on the verify login change form.
19
- verify_login_change_autologin? :: Whether to autologin the user after successful login change verification, false by default.
20
- verify_login_change_button :: The text to use for the verify login change button.
21
- verify_login_change_deadline_column :: The column name in the +verify_login_change_table+ storing the deadline after which the token will be ignored.
22
- verify_login_change_deadline_interval :: The amount of time for which to allow users to verify login changes, 1 day by default.
23
- verify_login_change_duplicate_account_error_flash :: The flash error message to show when attempting to verify a login change when the login is already taken.
24
- verify_login_change_duplicate_account_redirect :: Where to redirect if not changing a login during verification because the new login is already taken.
25
- verify_login_change_email_subject :: The subject to use for the verify login change email.
26
- verify_login_change_error_flash :: The flash error to show if no matching key is submitted when verifying login change.
27
- verify_login_change_id_column :: The id column in the +verify_login_change_table+, should be a foreign key referencing the accounts table.
28
- verify_login_change_key_column :: The verify login change key/token column in the +verify_login_change_table+.
29
- verify_login_change_key_param :: The parameter name to use for the verify login change key.
30
- verify_login_change_login_column :: The login column in the +verify_login_change_table+, containing the new login.
31
- verify_login_change_notice_flash :: The flash notice to show after verifying the login change.
32
- verify_login_change_page_title :: The page title to use on the verify login change form.
33
- verify_login_change_redirect :: Where to redirect after verifying the login change.
34
- verify_login_change_route :: The route to the verify login change action. Defaults to +verify-login-change+.
35
- verify_login_change_session_key :: The key in the session to hold the verify login change key temporarily.
36
- verify_login_change_table :: The name of the verify login change keys table.
37
-
38
- == Auth Methods
39
-
40
- account_from_verify_login_change_key(key) :: Retrieve the account using the given verify account key, or return nil if no account matches. Should also override verify_login_change_new_login if overriding this method.
41
- after_verify_login_change :: Run arbitrary code after verifying the login change.
42
- after_verify_login_change_email :: Run arbitrary code after sending verify login change email.
43
- before_verify_login_change :: Run arbitrary code before verifying the login change.
44
- before_verify_login_change_email :: Run arbitrary code before sending verify login change email.
45
- before_verify_login_change_route :: Run arbitrary code before handling a verify login change route.
46
- create_verify_login_change_email(login) :: A Mail::Message for the verify login change email.
47
- create_verify_login_change_key(login) :: Add the verify login change key data to the database.
48
- get_verify_login_change_login_and_key(id) :: Get the verify login change login and key for the given account id from the database.
49
- remove_verify_login_change_key :: Remove the verify login change key for the current account, run after successful login change verification.
50
- send_verify_login_change_email(login) :: Send the verify login change email.
51
- verify_login_change :: Change the login for the given account to the new login.
52
- verify_login_change_email_body :: The body to use for the verify login change email.
53
- verify_login_change_email_link :: The link to the verify login change form in the verify login change email.
54
- verify_login_change_key_insert_hash(login) :: The hash to insert into the +verify_login_change_table+.
55
- verify_login_change_key_value :: The value of the verify login change key.
56
- verify_login_change_new_login :: The new login to use when the login change is verified.
57
- verify_login_change_old_login :: The old login to display in the verify login change email.
58
- verify_login_change_response :: Return a response after successfully verifying a login change. By default, redirects to +verify_login_change_redirect+.
59
- verify_login_change_view :: The HTML to use for the verify login change form.
data/doc/webauthn.rdoc DELETED
@@ -1,118 +0,0 @@
1
- = Documentation for WebAuthn Feature
2
-
3
- The webauthn feature implements multifactor authentication via WebAuthn.
4
- It supports registering WebAuthn authenticators, using them for
5
- multifactor authentication, and removing WebAuthn authenticators.
6
- This feature supports multiple WebAuthn authenticators per user,
7
- and users are encouraged to have multiple WebAuthn authenticators
8
- so that they have a backup if one is not available.
9
-
10
- WebAuthn authentication requires javascript to work in
11
- browsers, for the browser to communicate with the authenticator.
12
- This feature offers routes that return the appropriate javascript.
13
- However, the javascript works by setting a hidden form field and
14
- using normal form submission. This allows testing the feature
15
- without using javascript. See Rodauth's tests for how testing
16
- without javascript works.
17
-
18
- The webauthn feature requires the webauthn gem.
19
-
20
- == Auth Value Methods
21
-
22
- authenticated_webauthn_id_session_key :: The session key used for storing which WebAuthn ID was used during authentication.
23
- webauthn_attestation :: The value of the WebAuthn attestation option when registering a new WebAuthn authenticator.
24
- webauthn_auth_additional_form_tags :: HTML fragment containing additional form tags when authenticating via WebAuthn.
25
- webauthn_auth_button :: Text to use for button on the form to authenticate via WebAuthn.
26
- webauthn_auth_challenge_hmac_param :: The parameter name for the HMAC of the WebAuthn challenge during authentication.
27
- webauthn_auth_challenge_param :: The parameter name for the WebAuthn challenge during authentication.
28
- webauthn_auth_error_flash :: The flash error to show if unable to authenticate via WebAuthn.
29
- webauthn_auth_js :: The javascript code to execute on the page to authenticate via WebAuthn.
30
- webauthn_auth_js_route :: The route to the webauthn auth javascript file.
31
- webauthn_auth_link_text :: The text to use for the link from the multifactor auth page.
32
- webauthn_auth_page_title :: The page title to use on the page for authenticating via WebAuthn.
33
- webauthn_auth_param :: The parameter name for the WebAuthn authentication data.
34
- webauthn_auth_route :: The route to the webauthn auth action.
35
- webauthn_auth_timeout :: The number of milliseconds to wait when authenticating using a WebAuthn authenticator.
36
- webauthn_authenticator_selection :: The value of the WebAuthn authenticatorSelection option when registering a new WebAuthn authenticator.
37
- webauthn_duplicate_webauthn_id_message :: The error message to when there is an attempt to insert a duplicate WebAuthn authenticator.
38
- webauthn_extensions :: The value of the WebAuthn extensions option when registering a new WebAuthn authenticator or authenticating via WebAuthn.
39
- webauthn_invalid_auth_param_message :: The error message to show when invalid or missing WebAuthn authentication data is provided.
40
- webauthn_invalid_remove_param_message :: The error message to show when invalid WebAuthn ID is provided when removing a WebAuthn authenticator.
41
- webauthn_invalid_setup_param_message :: The error message to show when invalid or missing WebAuthn registration data is provided.
42
- webauthn_invalid_sign_count_message :: The error message to when there is an attempt to authenticate with WebAuthn authenticator with an invalid sign count.
43
- webauthn_js_host :: The protocol and domain if using a separate host for the WebAuthn setup and auth javascript files.
44
- webauthn_keys_account_id_column :: The column in the +webauthn_keys_table+ containing the account id.
45
- webauthn_keys_last_use_column :: The column in the +webauthn_keys_table+ containing the last time the WebAuthn credential was used.
46
- webauthn_keys_public_key_column :: The column in the +webauthn_keys_table+ containing the public key for the WebAuthn credential.
47
- webauthn_keys_sign_count_column :: The column in the +webauthn_keys_table+ containing the sign count for the WebAuthn credential.
48
- webauthn_keys_table :: The table name containing the WebAuthn public keys.
49
- webauthn_keys_webauthn_id_column :: The column in the +webauthn_keys_table+ containing the WebAuthn ID for the WebAuthn credential.
50
- webauthn_not_setup_error_flash :: The flash error to show if going to the WebAuthn authentication page without having registered a WebAuthn authenticator.
51
- webauthn_not_setup_error_status :: The status code to use if going to the WebAuthn authentication page without having registered a WebAuthn authenticator.
52
- webauthn_origin :: The origin to use when verifying a WebAuthn authenticator.
53
- webauthn_remove_additional_form_tags :: HTML fragment containing additional form tags when removing an existing WebAuthn authenticator.
54
- webauthn_remove_button :: Text to use for button on the form to remove an existing WebAuthn authenticator.
55
- webauthn_remove_error_flash :: The flash error to show if unable to remove an existing WebAuthn authenticator.
56
- webauthn_remove_link_text :: The text to use for the remove link from the multifactor manage page.
57
- webauthn_remove_notice_flash :: The flash notice to show after removing an existing WebAuthn authenticator.
58
- webauthn_remove_page_title :: The page title to use on the page for removing an existing WebAuthn authenticator.
59
- webauthn_remove_param :: The parameter name for the WebAuthn ID to remove.
60
- webauthn_remove_redirect :: Where to redirect after successfully removing an existing WebAuthn authenticator.
61
- webauthn_remove_route :: The route to the webauthn remove action.
62
- webauthn_rp_id :: The relying party ID to use when registering a WebAuthn authenticator or authenticating via WebAuthn.
63
- webauthn_rp_name :: The relying party name to use when registering a WebAuthn authenticator.
64
- webauthn_setup_additional_form_tags :: HTML fragment containing additional form tags when registering a new WebAuthn authenticator.
65
- webauthn_setup_button :: Text to use for button on the form to register a new WebAuthn authenticator.
66
- webauthn_setup_challenge_hmac_param :: The parameter name for the HMAC of the WebAuthn challenge during registration.
67
- webauthn_setup_challenge_param :: The parameter name for the WebAuthn challenge during registration.
68
- webauthn_setup_error_flash :: The flash error to show if unable to register a new WebAuthn authenticator.
69
- webauthn_setup_js :: The javascript code to execute on the page to register a new WebAuthn credential.
70
- webauthn_setup_js_route :: The route to the webauthn setup javascript file.
71
- webauthn_setup_link_text :: The text to use for the setup link from the multifactor manage page.
72
- webauthn_setup_notice_flash :: The flash notice to show after registering a new WebAuthn authenticator.
73
- webauthn_setup_page_title :: The page title to use on the page for registering a new WebAuthn authenticator.
74
- webauthn_setup_param :: The parameter name for the WebAuthn registration data.
75
- webauthn_setup_redirect :: Where to redirect after successfully registering a new WebAuthn authenticator.
76
- webauthn_setup_timeout :: The number of milliseconds to wait when registering a new WebAuthn authenticator.
77
- webauthn_setup_route :: The route to the webauthn setup action.
78
- webauthn_user_ids_account_id_column :: The column in the +webauthn_user_ids_table+ containing the account id.
79
- webauthn_user_ids_table :: The table name containing the WebAuthn user IDs.
80
- webauthn_user_ids_webauthn_id_column :: The column in the +webauthn_user_ids_table+ containing the accounts WebAuthn user ID.
81
- webauthn_user_verification :: The value of the WebAuthn userVerification option when registering a new WebAuthn authenticator.
82
-
83
- == Auth Methods
84
-
85
- account_webauthn_ids :: An array of WebAuthn IDs for registered WebAuthn credentials for the current account.
86
- account_webauthn_usage :: A hash mapping WebAuthn IDs to the time of their last use for registered WebAuthn credentials for the current account.
87
- account_webauthn_user_id :: The WebAuthn User ID for the current account.
88
- add_webauthn_credential(webauthn_credential) :: Register the given WebAuthn credential to current account.
89
- after_webauthn_auth_failure :: Any actions to take after a WebAuthn authentication failure.
90
- after_webauthn_remove :: Any actions to take after removing an existing WebAuthn authenticator.
91
- after_webauthn_setup :: Any actions to take after registering a new WebAuthn authenticator.
92
- authenticated_webauthn_id :: The WebAuthn ID for the credential used to authenticate via WebAuthn for the current session.
93
- before_webauthn_auth :: Any actions to take before authenticating via WebAuthn.
94
- before_webauthn_auth_js_route :: Run arbitrary code before handling a webauthn auth javascript route.
95
- before_webauthn_auth_route :: Run arbitrary code before handling a webauthn auth route.
96
- before_webauthn_remove :: Any actions to take before removing an existing WebAuthn authenticator.
97
- before_webauthn_remove_route :: Run arbitrary code before handling a webauthn remove route.
98
- before_webauthn_setup :: Any actions to take before registering a new WebAuthn authenticator.
99
- before_webauthn_setup_js_route :: Run arbitrary code before handling a webauthn setup javascript route.
100
- before_webauthn_setup_route :: Run arbitrary code before handling a webauthn setup route.
101
- handle_webauthn_sign_count_verification_error :: What actions to take if there is an invalid sign count when authenticating. The default results in an error, but overriding without calling super will result in successful WebAuthn authentication.
102
- new_webauthn_credential :: WebAuthn credential options to provide to the client during WebAuthn registration.
103
- remove_all_webauthn_keys_and_user_ids :: Remove all WebAuthn credentials and the WebAuthn user ID from the current account.
104
- remove_webauthn_key(webauthn_id) :: Remove the WebAuthn credential with the given WebAuthn ID from the current account.
105
- valid_new_webauthn_credential?(webauthn_credential) :: Check wheck the WebAuthn credential provided by the client during registration is valid.
106
- valid_webauthn_credential_auth?(webauthn_credential) :: Check wheck the WebAuthn credential provided by the client during authentication is valid.
107
- webauthn_auth_js_path :: The path to the WebAuthn authentication javascript.
108
- webauthn_auth_view :: The HTML to use for the page for authenticating via WebAuthn.
109
- webauthn_credential_options_for_get :: WebAuthn credential options to provide to the client during WebAuthn authentication.
110
- webauthn_key_insert_hash(webauthn_credential) :: The hash to insert into the +webauthn_keys_table+.
111
- webauthn_remove_authenticated_session :: Remove the authenticated WebAuthn ID, used when removing the WebAuthn credential with the ID after authenticating with it.
112
- webauthn_remove_response :: Return a response after successfully removing a WebAuthn authenticator. By default, redirects to +webauthn_remove_redirect+.
113
- webauthn_remove_view :: The HTML to use for the page for removing an existing WebAuthn authenticator.
114
- webauthn_setup_js_path :: The path to the WebAuthn registration javascript.
115
- webauthn_setup_response :: Return a response after successfully setting up a WebAuthn authenticator. By default, redirects to +webauthn_setup_redirect+.
116
- webauthn_setup_view :: The HTML to use for the page for registering a new WebAuthn authenticator.
117
- webauthn_update_session(webauthn_id) :: Set the authenticated WebAuthn ID after authenticating via WebAuthn.
118
- webauthn_user_name :: The user name to use when registering a new WebAuthn credential, the user's email by default.
@@ -1,19 +0,0 @@
1
- = Documentation for WebAuthn Autofill Feature
2
-
3
- The webauthn_autofill feature enables autofill UI (aka "conditional mediation")
4
- for WebAuthn credentials, logging the user in on selection. It depends on the
5
- webauthn_login feature.
6
-
7
- This feature allows generating WebAuthn credential options and submitting a
8
- WebAuthn login request without providing a login, which can be used
9
- independently from the autofill UI.
10
-
11
- == Auth Value Methods
12
-
13
- webauthn_autofill_js :: The javascript code to execute on the login page to enable autofill UI.
14
- webauthn_autofill_js_route :: The route to the webauthn autofill javascript file.
15
- webauthn_invalid_webauthn_id_message :: The error message to show when provided WebAuthn ID wasn't found in the database.
16
-
17
- == Auth Methods
18
-
19
- before_webauthn_autofill_js_route :: Run arbitrary code before handling a webauthn autofill javascript route.
@@ -1,16 +0,0 @@
1
- = Documentation for WebAuthn Login Feature
2
-
3
- The webauthn_login feature implements passwordless authentication via
4
- WebAuthn. It depends on the login and webauthn features.
5
-
6
- == Auth Value Methods
7
-
8
- webauthn_login_user_verification_additional_factor? :: Whether passwordless login via WebAuthn should consider user verification as 2nd factor when using multifactor authentication, false by default. Setting this to true means that the app trusts the user verification done by the authenticator is strong enough to be considered an additional factor.
9
- webauthn_login_error_flash :: The flash error to show if there is a failure during passwordless login via WebAuthn.
10
- webauthn_login_failure_redirect :: Whether to redirect if there is a failure during passwordless login via WebAuthn.
11
- webauthn_login_route :: The route to the webauthn login action.
12
-
13
- == Auth Methods
14
-
15
- before_webauthn_login :: Any actions to take before passwordless login via WebAuthn.
16
- before_webauthn_login_route :: Run arbitrary code before handling a webauthn login route.
@@ -1,19 +0,0 @@
1
- = Documentation for WebAuthn Modify Email Feature
2
-
3
- The webauthn_modify_email feature emails users when a WebAuthn authenticator is added to or removed from their account.
4
-
5
- The webauthn_modify_email feature depends on the webauthn and email_base features.
6
-
7
- == Auth Value Methods
8
-
9
- webauthn_authenticator_added_email_body :: Body to use for the email notifying user that a WebAuthn authenticator has been added to their account.
10
- webauthn_authenticator_added_email_subject :: Subject to use for the email notifying user that a WebAuthn authenticator has been added to their account.
11
- webauthn_authenticator_removed_email_body :: Body to use for the email notifying user that a WebAuthn authenticator has been removed from their account.
12
- webauthn_authenticator_removed_email_subject :: Subject to use for the email notifying user that a WebAuthn authenticator has been removed from their account.
13
-
14
- == Auth Methods
15
-
16
- create_webauthn_authenticator_added_email :: A Mail::Message for the email notifying user that a WebAuthn authenticator has been added to their account.
17
- create_webauthn_authenticator_removed_email :: A Mail::Message for the email notifying user that a WebAuthn authenticator has been removed from their account.
18
- send_webauthn_authenticator_added_email :: Send the email notifying user that a WebAuthn authenticator has been added to their account.
19
- send_webauthn_authenticator_removed_email :: Send the email notifying user that a WebAuthn authenticator has been removed from their account.
@@ -1,9 +0,0 @@
1
- = Documentation for WebAuthn Verify Account Feature
2
-
3
- The webauthn_verify_account feature implements setting up an WebAuthn authenticator
4
- during the account verification process, and making such setup
5
- a requirement for account verification. By default, it disables
6
- asking for a password during account creation and verification,
7
- allowing for completely passwordless designs, where the only
8
- authentication option is WebAuthn. It depends on the verify_account
9
- and webauthn features.