root
/
spring-security
mirror of https://github.com/spring-projects/spring-security.git
1
0
Fork 0
Code Issues Actions 8 Packages Projects Releases Wiki Activity
spring-security/docs/modules/ROOT/pages/servlet/authentication/unpwd/index.adoc

28 lines
1.5 KiB
Plaintext
Raw Normal View History

Start Servlet Authentication Cleanup Issue gh-7628
2019-12-07 00:39:55 +08:00
[[servlet-authentication-unpwd]]
= Username/Password Authentication
Add Figures to Basic Authentication Docs Closes gh-8039
2020-02-29 06:39:41 +08:00
:figures: images/servlet/authentication/unpwd
:icondir: images/icons
Start Servlet Authentication Cleanup Issue gh-7628
2019-12-07 00:39:55 +08:00
One of the most common ways to authenticate a user is by validating a username and password.
Add Figures to Form Log In Docs Closes gh-8035
2020-02-29 01:33:31 +08:00
As such, Spring Security provides comprehensive support for authenticating with a username and password.
Start Servlet Authentication Cleanup Issue gh-7628
2019-12-07 00:39:55 +08:00
Add Figures to Form Log In Docs Closes gh-8035
2020-02-29 01:33:31 +08:00
[[servlet-authentication-unpwd-input]]
Antora mkdir -p docs/modules/ROOT/ mkdir -p docs/modules/ROOT/pages/ git checkout antora-2.x docs/antora.yml git checkout antora-2.x docs/modules/ROOT/nav.adoc mv docs/manual/src/docs/asciidoc/images docs/modules/ROOT/ mv docs/manual/src/docs/asciidoc/_includes/* docs/modules/ROOT/pages/ cp ~/code/rwinch/spring-reference/*antora* ~/code/spring-projects/spring-security/ mv docs/modules/ROOT/pages/about docs/modules/ROOT/pages/overview
2021-07-27 04:48:55 +08:00
== Reading the Username & Password
Update UserDetailsService Docs Closes gh-8048
2020-03-03 01:56:56 +08:00
Add Figures to Form Log In Docs Closes gh-8035
2020-02-29 01:33:31 +08:00
Spring Security provides the following built in mechanisms for reading a username and password from the `HttpServletRequest`:
Start Servlet Authentication Cleanup Issue gh-7628
2019-12-07 00:39:55 +08:00
mkdir -p build/ids find -name "*.adoc" | xargs -I{file} awk -v file={file} '/\[\[/ { gsub("\[|\]", ""); id=$0; gsub("./docs/modules/ROOT/pages/", "", file); gsub("\[|\]", ""); id=$0;getline;text=$0; sub("^=+ ","", text); print file > "build/ids/"id".id"; print text > "build/ids/"id".text" }' {file} find docs/modules -name "*.adoc"|while read adoc_file_to_replace; do echo "Replacing $adoc_file_to_replace" for id_file in build/ids/*.id; do id=$(basename $id_file | sed 's/\.id$//') xref_page=$(cat $id_file) if [[ "$adoc_file_to_replace" -ef "./docs/modules/ROOT/pages/$xref_page" ]] then echo " - Skipping same page refid $id " else sed -i -E "s%<<$id(|,([^,>]+))>>%xref:${xref_page}#${id}[\2]%g" $adoc_file_to_replace fi done done
2021-07-31 05:56:54 +08:00
* xref:servlet/authentication/unpwd/form.adoc#servlet-authentication-form[Form Login]
* xref:servlet/authentication/unpwd/basic.adoc#servlet-authentication-basic[Basic Authentication]
* xref:servlet/authentication/unpwd/digest.adoc#servlet-authentication-digest[Digest Authentication]
Add Figures to Form Log In Docs Closes gh-8035
2020-02-29 01:33:31 +08:00
[[servlet-authentication-unpwd-storage]]
Antora mkdir -p docs/modules/ROOT/ mkdir -p docs/modules/ROOT/pages/ git checkout antora-2.x docs/antora.yml git checkout antora-2.x docs/modules/ROOT/nav.adoc mv docs/manual/src/docs/asciidoc/images docs/modules/ROOT/ mv docs/manual/src/docs/asciidoc/_includes/* docs/modules/ROOT/pages/ cp ~/code/rwinch/spring-reference/*antora* ~/code/spring-projects/spring-security/ mv docs/modules/ROOT/pages/about docs/modules/ROOT/pages/overview
2021-07-27 04:48:55 +08:00
== Storage Mechanisms
Update UserDetailsService Docs Closes gh-8048
2020-03-03 01:56:56 +08:00
Add Figures to Form Log In Docs Closes gh-8035
2020-02-29 01:33:31 +08:00
Each of the supported mechanisms for reading a username and password can leverage any of the supported storage mechanisms:
rg "xref:\S+?#\S+\[\]" docs/modules -l -g "*.adoc" | while read adoc_file_to_replace; do echo "Replacing $adoc_file_to_replace" for id_file in build/ids/*.id; do id=$(basename $id_file | sed 's/\.id$//') xref_page=$(cat $id_file) if [[ "$adoc_file_to_replace" -ef "./docs/modules/ROOT/pages/$xref_page" ]] then echo " - Skipping same page refid $id " else text_file=$(echo $id_file | sed 's/\.id$/.text/') default_text=$(cat $text_file) sed -i -E "s%xref:${xref_page}#${id}\[\]%xref:${xref_page}#${id}[$default_text]%g" $adoc_file_to_replace fi done done
2021-07-31 06:02:44 +08:00
* Simple Storage with xref:servlet/authentication/unpwd/in-memory.adoc#servlet-authentication-inmemory[In-Memory Authentication]
* Relational Databases with xref:servlet/authentication/unpwd/jdbc.adoc#servlet-authentication-jdbc[JDBC Authentication]
* Custom data stores with xref:servlet/authentication/unpwd/user-details-service.adoc#servlet-authentication-userdetailsservice[UserDetailsService]
* LDAP storage with xref:servlet/authentication/unpwd/ldap.adoc#servlet-authentication-ldap[LDAP Authentication]
Add Figures to Form Log In Docs Closes gh-8035
2020-02-29 01:33:31 +08:00