Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add guide for configuring case insensitive logins #454

Closed
wants to merge 1 commit into from
Closed

Add guide for configuring case insensitive logins #454

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
13 changes: 13 additions & 0 deletions doc/guides/case_insensitive_login.rdoc
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,13 @@
= Case insensitive logins

If your database schema doesn't support case insensitive logins, you can tell
Rodauth to automatically lowercase login param values during authentication and
persistence via the +normalize_login+ configuration option:

normalize_login(&:downcase)

Of the four database types Rodauth officially supports (PostgreSQL, MySQL,
Microsoft SQL Server, and SQLite), only SQLite does not support a case
insensitive column for storing logins by default. However, other databases could
be configured to not use a case insensitive column for logins by default, in
which case you would want to use this setting.
1 change: 1 addition & 0 deletions www/pages/documentation.erb
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -69,6 +69,7 @@
<li><a href="rdoc/files/doc/guides/admin_activation_rdoc.html">Require account verification by admin</a></li>
<li><a href="rdoc/files/doc/guides/already_authenticated_rdoc.html">Skip login page if already authenticated</a></li>
<li><a href="rdoc/files/doc/guides/alternative_login_rdoc.html">Use a non-email login</a></li>
<li><a href="rdoc/files/doc/guides/case_insensitive_login_rdoc.html">Case insensitive login</a></li>
<li><a href="rdoc/files/doc/guides/change_table_and_column_names_rdoc.html">Change table and column names</a></li>
<li><a href="rdoc/files/doc/guides/create_account_programmatically_rdoc.html">Create an account record programmatically</a></li>
<li><a href="rdoc/files/doc/guides/delay_password_rdoc.html">Set password when verifying account</a></li>
Expand Down