Monday, December 27, 2010

Spring Security 3 - MVC: Using a Simple User-Service Tutorial

In this tutorial we will build a simple Spring MVC 3 application and provide security using Spring Security 3. We will provide a simple configuration. Our users will be authenticated based on Spring's built-in in-memory user-service (that's a lot of dashes). If you need to authenticate based on an existing database and provide a custom provider, please read my other tutorial Spring Security 3 - MVC Integration Tutorial (Part 2) instead.

Note: I suggest reading the following tutorial as well which uses the latest Spring Security 3.1
Spring Security 3.1 - Implement UserDetailsService with Spring Data JPA

What is Spring Security?
Spring Security is a powerful and highly customizable authentication and access-control framework. It is the de-facto standard for securing Spring-based applications

Spring Security is one of the most mature and widely used Spring projects. Founded in 2003 and actively maintained by SpringSource since, today it is used to secure numerous demanding environments including government agencies, military applications and central banks. It is released under an Apache 2.0 license so you can confidently use it in your projects.

Source: Spring Security
We'll build first the Spring MVC part of our application, then add Spring Security.

Let's declare our primary controller first.


This controller declares two mappings:
/main/common - any registered user can access this page
/main/admin - only admins can access this page
Each mapping will resolve to a specific JSP page. The common JSP page is accessible by everyone, while the admin page is accessible only by admins. Right now, everyone has access to these pages because we haven't enabled Spring Security yet.

Here are the JSP pages:



We've finished setting-up the primary controller and the associated JSP views. Now, we add the required XML configurations to enable Spring MVC and Spring Security at the same time.

We start by adding the web.xml:


Notice the url-patterns for the DelegatingFilterProxy and DispatcherServlet. Spring Security is placed at the root-path
Whereas, Spring MVC is placed at a sub-path

We also referenced two important XML configuration files:

spring-security.xml contains configuration related to Spring Security.


The elements are self-documenting. If you're using an IDE, like Eclipse or STS, try pointing your mouse to any of these elements and you will see a short description of the element.

Notice that the bulk of the security configuration is inside the http element. Here's what we observe:

1. We declared the denied page URL in the

2. We provided three URLs with varying permissions. We use Spring Expression Language (SpEL) to specify the role access. For admin only access we specified hasRole('ROLE_ADMIN') and for regular users we use hasRole('ROLE_USER'). To enable SpEL, you need to set use-expressions to true

3. We declared the login URL

4. We declared the login failure URL

5. We declared the URL where the user will be redirected if he logs out

6. We declared the logout URL

7. We declared a default authentication-manager that references an in-memory user-service

8. We declared an in-memory user-service:

This basically declares two users with corresponding passwords and authorities. This user-service is a good way to prototype and test a Spring Security application quickly.

9. We also declared an Md5 password encoder:

When a user enters his password, it's plain string. The password we have in our database (in this case, an in-memory lists) is Md5 encoded. In order for Spring to match the passwords, it's need to encode the plain string to Md5. Once it has been encoded, then it can compare passwords.

Now we need to create a special controller that handles the login and logout requests.


This controller declares two mappings:
/auth/login - shows the login page
/auth/denied - shows the denied access page
Each mapping will resolve to a specific JSP page.

Here are the JSP pages:



That's it. We got a working Spring MVC 3 application that's secured by Spring Security. We've managed to build a simple and quick configuration Spring Security configuration.

To access the common page, enter the following URL:
To access the admin page, enter the following URL:
To login, enter the following URL:
To logout, enter the following URL:
I suggest you read my other tutorial Spring Security 3 - MVC Integration Tutorial (Part 2) for comparison purposes.

The best way to learn further is to try the actual application.

Download the project
You can access the project site at Google's Project Hosting at

You can download the project as a Maven build. Look for the in the Download sections.

You can run the project directly using an embedded server via Maven.
For Tomcat: mvn tomcat:run
For Jetty: mvn jetty:run
StumpleUpon DiggIt! Blinklist Yahoo Furl Technorati Simpy Spurl Reddit Google I'm reading: Spring Security 3 - MVC: Using a Simple User-Service Tutorial ~ Twitter FaceBook

Subscribe by reader Subscribe by email Share


  1. I have uploaded a new tutorial using Spring Security 3.1 (see

    1. Rajib( 4, 2012 at 10:55 PM

      Hi krams, it's definitely a very useful tutorial. This really helped me when I tried the service provider initiated SSO between my sample application and an IDP (e.g. Google).

      However I have a different requirement where I have to do an Identity Provider initiated SSO. I would really appreciate if you can give me the steps for the same.

      The high level requirement is:

      >> I have to first login to the identity provider (e.g. google).

      >> After successful login, I land up on the home page of the IDP (e.g. google), where I have the link to my sample application which is protected by spring-security.

      >> On click of the link it will go to the requested page of the sample application directly, as I am already authenticated by IDP

      >> I have to return few user attributes from identity provider (e.g. google) to the sample application.

    2. Great Article Cyber Security Projects projects for cse Networking Security Projects JavaScript Training in Chennai JavaScript Training in Chennai The Angular Training covers a wide range of topics including Components, Angular Directives, Angular Services, Pipes, security fundamentals, Routing, and Angular programmability. The new Angular TRaining will lay the foundation you need to specialise in Single Page Application developer. Angular Training

  2. can't run it with Spring Security 3.1... I'm getting some strange error at spring-security.xml ( entry):

    Multiple annotations found at this line:
    - The classes from the spring-security-web jar (or one of its dependencies) are not available. You need these to use
    - Configuration problem: The classes from the spring-security-web jar (or one of its dependencies) are not available. You need these to use

  3. @Anonymous, you're following the Spring Security 3.1 tutorial, right? I suggest doing a mvn clean to cleanup your project's workspace. Then try building the project again.

  4. ty, I will try it.

  5. well, I tried to adapt Spring Security 3.1 - Implement UserDetailsService with Spring Data JPA (Part 1) tutorial to this one, but I still get this error at spring-security.xml

    it's probably something obvious, but I'm just starting to play with spring :|

    1. I see the same error in spring-security.xml.

  6. this is kinda helpful

  7. hi,
    Thanks for this nice tutorial.
    while trying to run it from eclipse its showing some error,
    its working fine when run from command prompt. please assist me,
    I m trying to run it in debug mode of eclipse.

  8. Hi,
    I have a questions Kram plz help.

    1. if I have two roles say R1 and R2 and hierarchy says R1>R2 and on a object i granted R1 access permission and R2 denied permission .But the final result coming is denied permission. ? Why not the access Permission as R1>R2 .Am i predicting something Wrong.

  9. This comment has been removed by the author.

  10. Hi,

    How do I display images using this application? I tried adding security:intercept-url pattern="/*" access="permitAll" in spring- security.xml but still I am unable to see any image.

    Please advise on this ASAP. It would be a great help.

  11. I have a question Krams. I am completely new to Spring , so if this question sounds really dumb to you please let me know. Why have you use 2 controllers here? 1. Main Contriller , 2. Login Logout controller. Can not Main controller handle login, logout and denied page redirection. Thanks for reply.

  12. I have read your blog its very attractive and impressive. I like it your blog.

    Spring online training Spring online training Spring Hibernate online training Spring Hibernate online training Java online training

    spring training in chennai spring hibernate training in chennai

  13. amid business close down hours and over weekends, once the consistent procedure of picking to deal with your CCTV is finished. Complete Home CCTV Systems

  14. Hey, that’s really a good post on pets for sale in Delhi, i really like your blog as the information is very useful if you are a pet lover. Well, there is one more site for the same service you should check it for more detail.

  15. Thanks for sharing this information and this is really useful to me. Keep updating this information.

    Best Industrial Training in Noida
    Best Industrial Training in Noida

  16. Nice looking sites and great work. Pretty nice information. it has a better understanding. thanks for spending time on it.

    Best BCA Colleges in Noida

  17. great article considering security threats with CCTV systems

  18. Good Post! Thank you so much for sharing this pretty post, it was so good to read and useful to improve my knowledge as updated one, keep blogging.

    core java training in Electronic City

    Hibernate Training in electronic city

    spring training in electronic city

    java j2ee training in electronic city


  19. This is quite educational arrange. It has famous breeding about what I rarity to vouch.
    Colossal proverb. This trumpet is a famous tone to nab to troths. Congratulations on a career well achieved.
    This arrange is synchronous s informative impolite festivity to pity. I appreciated what you ok extremely here.

    Selenium interview questions and answers
    Selenium Online training
    Selenium training in Pune
    selenium training in USA
    selenium training in chennai

  20. Thanks for one marvelous posting! I enjoyed reading it; you are a great author. I will make sure to bookmark your blog and may come back someday. I want to encourage that you continue your great posts.Real Time Experts training center bangalore

  21. Thank you for your post. This is excellent information. It is amazing and wonderful to visit your site.Prathima Infotech training center bangalore

  22. Snapdeal Winner List here came up with an Offer where you can win Snapdeal prize list 2020 by just playing a game & win prizes.
    Snapdeal winner name2020 also check the Snapdeal lucky draw2020

  23. Thanks for sharing the great usefull blog
    Shopclues lucky draw 2020| Shopclues winner 2020|Get to Know Shopclues Lucky Draw Winner 2020. Call Shopclues Helpline Phone Number+91-9835565523 for Shopclues Online Shopping Lucky Draw.
    Shopclues online lucky draw winner
    Shopclues winner 2020
    shopclues car lucky draw

  24. Having read this I believed it was extremely informative. I appreciate you taking the time and effort to put this information together.Snapdeal winner 2020 | Dear customer, you can complain here If you get to call and SMS regarding Snapdeal lucky draw, Mahindra xuv 500, lucky draw contest, contact us at to know the actual Snapdeal prize winners 2020.
    Snapdeal winner 2020
    Snapdeal lucky draw winner 2020
    Snapdeal lucky draw contest 2020
    snapdeal winner prizes 2020

  25. Thanks for the informative article About Selenium.This is one of the best resources I have found in quite some time. Nicely written and great info. I really cannot thank you enough for sharing.
    Java training in chennai | Java training in annanagar | Java training in omr | Java training in porur | Java training in tambaram | Java training in velachery

  26. Sometime few such blogs become very helpful while getting relevant and new information related to your targeted area. As I found this blog and appreciate the information delivered to my database.
    Php projects with source code
    Online examination system in php
    Student management system in php
    Php projects for students
    Free source code for academic
    Academic projects provider in nashik
    Academic project free download

  27. Thank you for sharing such a beautiful information with us. I hope you will share more info about keep sharing. mvc online training