Angular 8 + Spring Boot: JWT Authentication with Spring Security example

In this tutorial, I will show you how to build a full stack Angular 8 + Spring Boot JWT Authentication example. The back-end server uses Spring Boot with Spring Security for JWT authentication and Spring Data JPA for interacting with database. The front-end will be built using Angular 8 with HttpInterceptor & Form validation.

Related Posts:
Angular 8 + Spring Boot + MySQL/PostgreSQL CRUD example
Angular 8 + Spring Boot + MongoDB CRUD example
Spring Boot, MongoDB: JWT Authentication with Spring Security

JWT (JSON Web Token)

JWT is popular for Authentication and Information Exchange. Server encodes data into a JSON Web Token and send it to the Client. The Client saves the JWT, then every Request from Client to protected routes or resources should be attached that JWT (commonly at header). The Server will validate that JWT and return the Response.

in-depth-introduction-jwt-token-based-authentication

The big advantage of JWT (Token-based Authentication) is that we store the Token on Client side: Local Storage for Browser, Keychain for IOS and SharedPreferences for Android… So we don’t need to build another backend project that supports Native Apps or an additional Authentication module for Native App users.

There are three important parts of a JWT: Header, Payload, Signature. Together they are combined to a standard structure: header.payload.signature.

The Client typically attact JWT in Authorization header with Bearer prefix:

Authorization: Bearer [header].[payload].[signature]

For more details, you can visit:
In-depth Introduction to JWT-JSON Web Token

Angular 8 Spring Boot Authentication example

It will be a full stack, with Spring Boot for back-end and Angular 8 for front-end. The system is secured by Spring Security with JWT Authentication.

  • User can signup new account, login with username & password.
  • Authorization by the role of the User (admin, moderator, user)

Screenshots

Here are UI screenshots of our system.

– Anyone can access a public page before logging in:

angular-8-spring-boot-jwt-authentication-public

– New user signups:

angular-8-spring-boot-jwt-authentication-signup

– After signup is successful, User can login:

angular-8-spring-boot-jwt-authentication-login

-Loggedin User can access Profile page/ User page:

angular-8-spring-boot-jwt-authentication-profile

angular-8-spring-boot-jwt-authentication-user

– This is UI for admin:

angular-8-spring-boot-jwt-authentication-admin

– If a User who doesn’t have Admin role tries to access Admin/Moderator Board page:

angular-8-spring-boot-jwt-authentication-unauthorized

Demo

This is full Angular 8 + Spring Boot JWT authentication demo (with form validation, check signup username/email duplicates, test authorization with 3 roles: Admin, Moderator, User):

Flow for User Registration and User Login

The diagram shows flow for User Registration process and User Login process.

spring-boot-authentication-jwt-spring-security-flow

I think it’s not too difficult to understand. We have 2 endpoints for authentication:

  • api/auth/signup for User Registration
  • api/auth/signin for User Login

If Client wants to send request to protected data/endpoints, a legal JWT must be added to HTTP Authorization Header.

Spring Boot & Spring Security for Back-end

Overview

Our Spring Boot Application can be summarized in the diagram below:

spring-boot-authentication-spring-security-architecture

Let me explain it.

Spring Security

WebSecurityConfigurerAdapter is the crux of our security implementation. It provides HttpSecurity configurations to configure cors, csrf, session management, rules for protected resources. We can also extend and customize the default configuration that contains the elements below.

UserDetailsService interface has a method to load User by username and returns a UserDetails object that Spring Security can use for authentication and validation.

UserDetails contains necessary information (such as: username, password, authorities) to build an Authentication object.

UsernamePasswordAuthenticationToken gets {username, password} from login Request, AuthenticationManager will use it to authenticate a login account.

AuthenticationManager has a DaoAuthenticationProvider (with help of UserDetailsService & PasswordEncoder) to validate UsernamePasswordAuthenticationToken object. If successful, AuthenticationManager returns a fully populated Authentication object (including granted authorities).

OncePerRequestFilter makes a single execution for each request to our API. It provides a doFilterInternal() method that we will implement parsing & validating JWT, loading User details (using UserDetailsService), checking Authorizaion (using UsernamePasswordAuthenticationToken).

AuthenticationEntryPoint will catch unauthorized error and return a 401 when Clients access protected resources without authentication.

Repository contains UserRepository & RoleRepository to work with Database, will be imported into Controller.

Controller receives and handles request after it was filtered by OncePerRequestFilter.

AuthController handles signup/login requests

TestController has accessing protected resource methods with role based validations.

Technology

To implement the server with concept above, we will use:
– Java 8
– Spring Boot 2.1.8.RELEASE (with Spring Security, Spring Web, Spring Data)
– jjwt 0.9.1
– PostgreSQL/MySQL
– Maven 3.6.1

Project Structure

The structure of Spring Boot back-end project is pretty complicated:

spring-boot-authentication-spring-security-project-structure

You can see that there are 5 packages:

security: we configure Spring Security & implement Security Objects here.

  • WebSecurityConfig extends WebSecurityConfigurerAdapter
  • UserDetailsServiceImpl implements UserDetailsService
  • UserDetailsImpl implements UserDetails
  • AuthEntryPointJwt implements AuthenticationEntryPoint
  • AuthTokenFilter extends OncePerRequestFilter
  • JwtUtils provides methods for generating, parsing, validating JWT

controllers handle signup/login requests & authorized requests.

  • AuthController: @PostMapping(‘/signin’), @PostMapping(‘/signup’)
  • TestController: @GetMapping(‘/api/test/all’), @GetMapping(‘/api/test/[role]’)

repository has intefaces that extend Spring Data JPA JpaRepository to interact with Database.

  • UserRepository extends JpaRepository
  • RoleRepository extends JpaRepository

models defines two main models for Authentication (User) & Authorization (Role). They have many-to-many relationship.

  • User: id, username, email, password, roles
  • Role: id, name

payload defines classes for Request and Response objects

We also have application.properties for configuring Spring Datasource, Spring Data JPA and App properties (such as JWT Secret string or Token expiration time).

Implementation

You can find step by step to implement this Spring Boot – Spring Security App in the post:
Secure Spring Boot App with Spring Security & JWT Authentication

And this is for working with MongoDB:
Spring Boot, MongoDB: JWT Authentication with Spring Security

Angular 8 for Front-end

Overview

Our Angular 8 App can be summarized in component diagram below:

angular-8-jwt-authentication-overview

Let’s try to understand it right now.

– The App component is a container using Router. It gets user token & user information from Browser Session Storage via token-storage.service. Then the navbar now can display based on the user login state & roles.

Login & Register components have form for submission data (with support of Form Validation). They use token-storage.service for checking state and auth.service for sending signin/signup requests.

auth.service uses Angular HttpClient ($http service) to make authentication requests.
โ€“ every HTTP request by $http service will be inspected and transformed before being sent by auth-interceptor.

Home component is public for all visitor.

Profile component get user data from Session Storage.

BoardUser, BoardModerator, BoardAdmin components will be displayed depending on roles from Session Storage. In these components, we use user.service to get protected resources from API.

Technology

– Angular 8
– RxJS 6

Project Structure

This is the folder structure of our Angular front-end project:

angular-8-jwt-authentication-project-structure

You can understand it properly without any explanation because we’ve looked at the overview before.

Implementation

You can find step by step to implement this Angular 8 App in the post:
Angular 8 JWT Authentication with HttpInterceptor and Router

Newer version: Angular 10 JWT Authentication example with Web Api

Further Reading

Conclusion

Now we have an overview of Angular 8 Spring Boot Authentication example using JWT, Spring Security, Angular HttpInterceptor along with flow for signup/login actions.

We also take a look at Spring Boot server architecture for JWT Authentication using Spring Sercurity & Spring Data JPA, as well as Angular project structure for building a front-end app working with JWT.

Next tutorials will show you more details about how to implement this interesting system:
– Back-end:

– Front-end:

You will want to know how to run both projects in one place:
How to Integrate Angular with Spring Boot Rest API

Happy learning, see you again!

57 thoughts to “Angular 8 + Spring Boot: JWT Authentication with Spring Security example”

      1. thanks a lot bezkoder… i liked your source code…its running as mentioned in the tutorials…
        do you have anything good with search like amazon???

          1. Also, file upload, save it to file system, keep the reference in db and then fetch and show using angular & spring boot ๐Ÿ™‚

  1. Hi bezkoder,
    Your tutorial really help a lot. I just want to ask about the database design because I don’t think if I made it correctly. It always says “error”: “Unsupported Media Type”,
    Could help me with this.

      1. Thank you for replying on my need bezkoder. I just want to see how to design the database clearly with a UI like dbeaver or sql management studio because I’m confused because I always work on frontend.Could you help me with this,like sending screenshots or snippets? (Database design for the 3 tables)

  2. I like the app, but by no means do I register constantly I get the following message: “Signup failed!
    Error: Role is not found. “The roll table is populated.
    Thanks

  3. Bonjour,
    j’ai obtient le problรจme suivant
    Access to XMLHttpRequest at ‘http://localhost:8080/api/auth/signin’ from origin ‘http://localhost:4200’ has been blocked by CORS policy: Response to preflight request doesn’t pass access control check: It does not have HTTP ok status.

    Malgrรฉ que j’ai ajoutรฉ au niveau de l’api rest le code suivant;@CrossOrigin(origins = “http://localhost:4200” ,allowedHeaders = “*”,allowCredentials = “true”)
    Quelqu’un peut m’aider?

    1. Hi, the server you used configures CORS for port 8081, so you have to run this Angular client with command: ng serve --port 8081 instead.

  4. Hi, Very good tutorial about this topic. Congrats.

    Where I can find source code? Is there any GitHub repo? Thx

    1. Hi, you can find github source code for backend and frontend in the tutorials I mentioned in Conclusion section ๐Ÿ™‚

  5. Hi BezKoder,
    You are great man. Its save a lot of time to the base project. I have followed your tutorials. It gives me a clear picture that how can I make more secure my application with Angular 8. I have subscribed to your youtube channel and I see a lot of good content over there. Good job man.

  6. ERROR 11876 — [nio-8080-exec-7] c.b.s.security.jwt.AuthEntryPointJwt : Unauthorized error: Full authentication is required to access this resource

    what might be wrong?

    1. Hi, maybe the HTTP request Header was wrong.
      Notice that you need to modify the code in app/_helpers/auth.interceptor.js to work with Spring Boot Server:

      authReq = req.clone({ headers: req.headers.set(TOKEN_HEADER_KEY, 'Bearer ' + token) });
      
  7. is it possible to change my jwt token in a specific interval using access token and refresh token (with remember me feature ) concept in this existing project.

  8. When i try to open user board i will get Unauthorized error: Full authentication is required to access this resource.
    This user has role ROLE_USER

  9. Hello, I have a little problem with Swagger Integration. If I go to http://localhost:8080/swagger-ui.html , my console show this problem:
    javax.servlet.ServletException: Circular view path [error]: would dispatch back to the current handler URL [/error] again. Check your ViewResolver setup!

    Any suggestion please? thanks

  10. Hii.. How to change the role of the user from user to admin.
    Admin can chance a user role as admin.. How it is possible?

  11. hi guys In Angular when i register with username, email, password So i want to set role for account but not defaut . How can I do it?

  12. Hi,

    The JWT token that I receive in UI, is not the full token That I receive on calling the REST api through POSTMAN.
    For example :
    POSTMAN token : “accessToken”: “eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJzb20iLCJpYXQiOjE1OTY5ODI5MTQsImV4cCI6MTU5NzA2OTMxNH0.Vx7915pjE96cJ9KQ_kAOtfgnmysED5wPYCkIR6582nDvxuBjWF3yo34ZajIxosI6kCimS1kZ5NauO8MLsv0MwQ”

    Token in UI : eyJhbGciOiJIUzUxMiJ9 … ZkoK_Y00wEmYwCvzQRJQ

    How to display the full token in UI.

    1. Hi, you can change these lines of code:

      {{ currentUser.accessToken.substring(0, 20) }} ...
      {{ currentUser.accessToken.substr(currentUser.accessToken.length - 20) }}
      

      to: {{ currentUser.accessToken }}

  13. Hi,

    Imagine this application in a production environment. Apache for Frontend (Angular) and Wildfly for Backend (Springboot). My doubt is who makes the api REST calls to Backend, browser or Web Server (Apache)? Do you know some article to go deeper into the subject?

    Congrats and thanks by the post.

    Cheers.

  14. Hi,
    Can you please help me:
    I run your project and it still ok. But I found on my eclipse log that:
    io.jsonwebtoken.SignatureException: JWT signature does not match locally computed signature. JWT validity cannot be asserted and should not be trusted.
    It has this error. Can you help me fix this

  15. Good morning, when i try to delete a user by his id
    it shows me this error msg: Cannot delete or update a parent row: a foreign key constraint fails..
    any solutions pls ?

Leave a Reply

Your email address will not be published. Required fields are marked *