Spring Security Example Tutorial | DevsDay.ru

IT-блоги Spring Security Example Tutorial

DigitalOcean Community Tutorials 3 августа 2022 г. Pankaj


Spring Security provides ways to perform authentication and authorization in a web application. We can use spring security in any servlet based web application. ## Spring Security [![spring security example tutorial](https://journaldev.nyc3.digitaloceanspaces.com/2014/04/spring-security.jpg)](https://journaldev.nyc3.digitaloceanspaces.com/2014/04/spring-security.jpg) Some of the benefits of using Spring Security are: 1. Proven technology, it's better to use this than reinvent the wheel. Security is something where we need to take extra care, otherwise our application will be vulnerable for attackers. 2. Prevents some of the common attacks such as CSRF, session fixation attacks. 3. Easy to integrate in any web application. We don't need to modify web application configurations, spring automatically injects security filters to the web application. 4. Provides support for authentication by different ways - in-memory, DAO, JDBC, LDAP and many more. 5. Provides option to ignore specific URL patterns, good for serving static HTML, image files. 6. Support for groups and roles. ### Spring Security Example We will create a web application and integrate it with Spring Security. Create a web application using "**Dynamic Web Project**" option in Eclipse, so that our skeleton web application is ready. Make sure to convert it to maven project because we are using Maven for build and deployment. If you are unfamiliar with these steps, please refer [Java Web Application Tutorial](/community/tutorials/java-web-application-tutorial-for-beginners "Java Web Application Tutorial for Beginners"). Once we will have our application secured, final project structure will look like below image. [![Spring Security Example Tutorial](https://journaldev.nyc3.digitaloceanspaces.com/2014/04/Spring-Security-Web-Application-Project-450x425.png)](https://journaldev.nyc3.digitaloceanspaces.com/2014/04/Spring-Security-Web-Application-Project.png) We will look into three spring security authentication methods. 1. **in-memory** 2. **DAO** 3. **JDBC** For JDBC, I am using MySQL database and have following script executed to create the user details tables. ``` CREATE TABLE `Employees` ( `username` varchar(20) NOT NULL DEFAULT '', `password` varchar(20) NOT NULL DEFAULT '', `enabled` tinyint(1) NOT NULL DEFAULT '1', PRIMARY KEY (`username`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8; CREATE TABLE `Roles` ( `username` varchar(20) NOT NULL DEFAULT '', `role` varchar(20) NOT NULL DEFAULT '', PRIMARY KEY (`username`,`role`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8; INSERT INTO `Employees` (`username`, `password`, `enabled`) VALUES ('pankaj', 'pankaj123', 1); INSERT INTO `Roles` (`username`, `role`) VALUES ('pankaj', 'Admin'), ('pankaj', 'CEO'); commit; ``` We would also need to configure JDBC DataSource as JNDI in our servlet container, to learn about this please read [Tomcat JNDI DataSource Example](/community/tutorials/tomcat-datasource-jndi-example-java). ### Spring Security Maven Dependencies Here is our final pom.xml file. ``` 4.0.0 WebappSpringSecurity WebappSpringSecurity 0.0.1-SNAPSHOT war org.springframework.security spring-security-web 3.2.3.RELEASE org.springframework.security spring-security-config 3.2.3.RELEASE org.springframework.security spring-security-taglibs 3.0.5.RELEASE javax.servlet jstl 1.2 compile javax.servlet.jsp jsp-api 2.1 provided javax.servlet javax.servlet-api 3.0.1 provided commons-logging commons-logging 1.1.1 org.springframework spring-jdbc 4.0.2.RELEASE src maven-compiler-plugin 3.1 1.7 1.7 maven-war-plugin 2.3 WebContent false ``` We have following dependencies related to Spring Framework. 1. **spring-jdbc**: This is used for JDBC operations by JDBC authentication method. It requires DataSource setup as JNDI. For complete example of it's usage, please refer [Spring DataSource JNDI Example](/community/tutorials/spring-datasource-jndi-with-tomcat-example) 2. **spring-security-taglibs**: Spring Security tag library, I have used it to display user roles in the JSP page. Most of the times, you won't need it though. 3. **spring-security-config**: It is used for configuring the authentication providers, whether to use JDBC, DAO, LDAP etc. 4. **spring-security-web**: This component integrates the Spring Security to the Servlet API. We need it to plugin our security configuration in web application. Also note that we will be using Servlet API 3.0 feature to add listener and filters through programmatically, that's why servlet api version in dependencies should be 3.0 or higher. ### Spring Security Example View Pages We have JSP and HTML pages in our application. We want to apply authentication in all the pages other than HTML pages. `health.html` ``` Health Check

Service is up and running!!

``` `index.jsp` ``` <%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%> <%@ taglib uri="https://java.sun.com/jsp/jstl/core" prefix="c" %> <%@ taglib uri="https://www.springframework.org/security/tags" prefix="sec" %> Home Page

Home Page

Hello
Roles:

``` I have included `index.jsp` as `welcome-file` in the application deployment descriptor. Spring Security takes care of CSRF attack, so when we are submitting form for logout, we are sending the CSRF token back to server to delete it. The CSRF object set by Spring Security component is **\_csrf** and we are using it's property name and token value to pass along in the logout request. Let's look at the Spring Security configurations now. ### Spring Security Example UserDetailsService DAO Implementation Since we will be using DAO based authentication also, we need to implement `UserDetailsService` interface and provide the implementation for `loadUserByUsername()` method. Ideally we should be using some resource to validate the user, but for simplicity I am just doing basic validation. `AppUserDetailsServiceDAO.java` ``` package com.journaldev.webapp.spring.dao; import java.util.Collection; import java.util.List; import org.apache.commons.logging.Log; import org.apache.commons.logging.LogFactory; import org.springframework.security.core.GrantedAuthority; import org.springframework.security.core.authority.SimpleGrantedAuthority; import org.springframework.security.core.userdetails.UserDetails; import org.springframework.security.core.userdetails.UserDetailsService; import org.springframework.security.core.userdetails.UsernameNotFoundException; public class AppUserDetailsServiceDAO implements UserDetailsService { protected final Log logger = LogFactory.getLog(getClass()); @Override public UserDetails loadUserByUsername(final String username) throws UsernameNotFoundException { logger.info("loadUserByUsername username="+username); if(!username.equals("pankaj")){ throw new UsernameNotFoundException(username + " not found"); } //creating dummy user details, should do JDBC operations return new UserDetails() { private static final long serialVersionUID = 2059202961588104658L; @Override public boolean isEnabled() { return true; } @Override public boolean isCredentialsNonExpired() { return true; } @Override public boolean isAccountNonLocked() { return true; } @Override public boolean isAccountNonExpired() { return true; } @Override public String getUsername() { return username; } @Override public String getPassword() { return "pankaj123"; } @Override public Collection getAuthorities() { List auths = new java.util.ArrayList(); auths.add(new SimpleGrantedAuthority("admin")); return auths; } }; } } ``` Notice that I am creating anonymous inner class of `UserDetails` and returning it. You can create an implementation class for it and then instantiate and return it. Usually that is the way to go in actual applications. ### Spring Security Example WebSecurityConfigurer implementation We can implement `WebSecurityConfigurer` interface or we can extend the base implementation class `WebSecurityConfigurerAdapter` and override the methods. `SecurityConfig.java` ``` package com.journaldev.webapp.spring.security; import javax.naming.Context; import javax.naming.InitialContext; import javax.sql.DataSource; import org.springframework.context.annotation.Configuration; import org.springframework.security.config.annotation.authentication.builders.AuthenticationManagerBuilder; import org.springframework.security.config.annotation.web.builders.WebSecurity; import org.springframework.security.config.annotation.web.configuration.EnableWebSecurity; import org.springframework.security.config.annotation.web.configuration.WebSecurityConfigurerAdapter; import com.journaldev.webapp.spring.dao.AppUserDetailsServiceDAO; @Configuration @EnableWebSecurity public class SecurityConfig extends WebSecurityConfigurerAdapter { @Override public void configure(AuthenticationManagerBuilder auth) throws Exception { // in-memory authentication // auth.inMemoryAuthentication().withUser("pankaj").password("pankaj123").roles("USER"); // using custom UserDetailsService DAO // auth.userDetailsService(new AppUserDetailsServiceDAO()); // using JDBC Context ctx = new InitialContext(); DataSource ds = (DataSource) ctx .lookup("java:/comp/env/jdbc/MyLocalDB"); final String findUserQuery = "select username,password,enabled " + "from Employees " + "where username = ?"; final String findRoles = "select username,role " + "from Roles " + "where username = ?"; auth.jdbcAuthentication().dataSource(ds) .usersByUsernameQuery(findUserQuery) .authoritiesByUsernameQuery(findRoles); } @Override public void configure(WebSecurity web) throws Exception { web .ignoring() // Spring Security should completely ignore URLs ending with .html .antMatchers("/*.html"); } } ``` Notice that we are ignoring all HTML files by overriding `configure(WebSecurity web)` method. The code shows how to plugin JDBC authentication. We need to configure it by providing DataSource. Since we are using custom tables, we are also required to provide the select queries to get the user details and it's roles. Configuring in-memory and DAO based authentication is easy, they are commented in above code. You can uncomment them to use them, make sure to have only one configuration at a time. `@Configuration` and `@EnableWebSecurity` annotations are required, so that spring framework know that this class will be used for spring security configuration. Spring Security Configuration is using [Builder Pattern](/community/tutorials/builder-design-pattern-in-java "Builder Design Pattern in Java") and based on the authenticate method, some of the methods won't be available later on. For example, `auth.userDetailsService()` returns the instance of `UserDetailsService` and then we can't have any other options, such as we can't set DataSource after it. ### Integrating Spring Security Web with Servlet API The last part is to integrate our Spring Security configuration class to the Servlet API. This can be done easily by extending `AbstractSecurityWebApplicationInitializer` class and passing the Security configuration class in the super class constructor. `SecurityWebApplicationInitializer.java` ``` package com.journaldev.webapp.spring.security; import org.springframework.security.web.context.AbstractSecurityWebApplicationInitializer; public class SecurityWebApplicationInitializer extends AbstractSecurityWebApplicationInitializer { public SecurityWebApplicationInitializer() { super(SecurityConfig.class); } } ``` When our context startup, it uses ServletContext to add [ContextLoaderListener listener](/community/tutorials/servletcontextlistener-servlet-listener-example "Servlet Listener Example – ServletContextListener, HttpSessionListener and ServletRequestListener") and register our configuration class as [Servlet Filter](/community/tutorials/java-servlet-filter-example-tutorial "Java Servlet Filter Example Tutorial"). Note that this will work only in Servlet-3 complaint servlet containers. So if you are using Apache Tomcat, make sure it's version is 7.0 or higher. Our project is ready, just deploy it in your favorite servlet container. I am using Apache Tomcat-7 for running this application. Below images show the response in various scenarios. #### Accessing HTML Page without Security [![Spring Security ignore](https://journaldev.nyc3.digitaloceanspaces.com/2014/04/Spring-Security-ignore-450x163.png)](https://journaldev.nyc3.digitaloceanspaces.com/2014/04/Spring-Security-ignore.png) #### Authentication Failed for Bad Credentials [![Spring Security Example Bad Credentials](https://journaldev.nyc3.digitaloceanspaces.com/2014/04/Spring-Security-Bad-Credentials-450x292.png)](https://journaldev.nyc3.digitaloceanspaces.com/2014/04/Spring-Security-Bad-Credentials.png) #### Home Page with Spring Security JDBC Authentication [![Spring Security JDBC](https://journaldev.nyc3.digitaloceanspaces.com/2014/04/Spring-Security-JDBC-450x283.png)](https://journaldev.nyc3.digitaloceanspaces.com/2014/04/Spring-Security-JDBC.png) #### Home Page with Spring Security UserDetailsService DAO Authentication [![Spring Security DAO](https://journaldev.nyc3.digitaloceanspaces.com/2014/04/Spring-Security-DAO-450x277.png)](https://journaldev.nyc3.digitaloceanspaces.com/2014/04/Spring-Security-DAO.png) #### Home Page with Spring Security In-Memory Authentication [![Spring Security Example In Memory](https://journaldev.nyc3.digitaloceanspaces.com/2014/04/Spring-Security-InMemory-450x264.png)](https://journaldev.nyc3.digitaloceanspaces.com/2014/04/Spring-Security-InMemory.png) #### Logout Page [![Spring Security Form Logout](https://journaldev.nyc3.digitaloceanspaces.com/2014/04/Spring-Security-Form-Logout-450x256.png)](https://journaldev.nyc3.digitaloceanspaces.com/2014/04/Spring-Security-Form-Logout.png) If you want to use Servlet Container that doesn't support Servlet Specs 3, then you would need to register `DispatcherServlet` through deployment descriptor. See JavaDoc of `WebApplicationInitializer` for more details. That's all for Spring Security example tutorial and it's integration in Servlet Based Web Application. Please download the sample project from below link and play around with it to learn more. [Download Spring Servlet Security Project](https://journaldev.nyc3.digitaloceanspaces.com/spring/WebappSpringSecurity.zip)

Источник: DigitalOcean Community Tutorials

Наш сайт является информационным посредником. Сообщить о нарушении авторских прав.