Logo Questions Linux Laravel Mysql Ubuntu Git Menu
 

What's the "principal" in Spring Security?

I'm really new to Spring and Spring Security. I was reading about Spring Security and it came out the concept of principal, which should be the current logged user. But what if we have more than one current logged user? So, my question is, what exactly is then the principal in spring security?

I've read for example this tutorial:

http://www.mkyong.com/spring-security/get-current-logged-in-username-in-spring-security/

and they seem to take into account that there's just one current logged user, which isn't often the case.

How do I retrieve a specific user? And how do I differentiate between users that are doing requests?

like image 677
nbro Avatar asked May 28 '16 12:05

nbro


People also ask

What is principal in Java security?

This interface represents the abstract notion of a principal, which can be used to represent any entity, such as an individual, a corporation, and a login id.

What is principal in authentication?

A principal in computer security is an entity that can be authenticated by a computer system or network. It is referred to as a security principal in Java and Microsoft literature.

What is principal in HTTP request?

b) User Principal - The web server or application server authenticates the user and puts the user name in the special UserPrincipal HTTP header. The Java call is request. getUserPrincipal().

What is principal in UsernamePasswordAuthenticationToken?

The UsernamePasswordAuthenticationToken is an implementation of interface Authentication which extends the interface Principal . Principal is defined in the JSE java. security . UsernamePasswordAuthenticationToken is a concept in Spring Security which implements the Principal interface.


2 Answers

The principal is the currently logged in user. However, you retrieve it through the security context which is bound to the current thread and as such it's also bound to the current request and its session.

SecurityContextHolder.getContext() internally obtains the current SecurityContext implementation through a ThreadLocal variable. Because a request is bound to a single thread this will get you the context of the current request.

To simplify you could say that the security context is in the session and contains user/principal and roles/authorities.

How do I retrieve a specific user?

You don't. All APIs are designed to allow access to the user & session of the current request. Let user A be one of 100 currently authenticated users. If A issues a request against your server it will allocate one thread to process that request. If you then do SecurityContextHolder.getContext().getAuthentication() you do so in the context of this thread. By default from within that thread you don't have access to the context of user B which is processed by a different thread.

And how do I differentiate between users that are doing requests?

You don't have to, that's what the Servlet container does for you.

like image 188
Marcel Stör Avatar answered Sep 17 '22 19:09

Marcel Stör


Principal is just an old interface from Java SE 6.

As all interfaces without default implementation it simple defines some methods which are required to be implemented by the class which will implement that interface.

Those methods are

boolean  equals(Object another)           Compares this principal to the specified object.  String   getName()           Returns the name of this principal.  int      hashCode()           Returns a hashcode for this principal.  String   toString()           Returns a string representation of this principal. 

As the Java Doc states :

This interface represents the abstract notion of a principal, which can be used to represent any entity, such as an individual, a corporation, and a login id.

In simple terms it is just used so that the implementer will have to implement this interface in a way that he makes an entity uniquely distingueed between other entities. Also the getName() will have to return a value by which one specific entity is uniquely identified and does not collide with other entities. So if the Principal which is used is of type UserDetails then the getName() of Principal returns the UserName of UserDetails.

If we see the implementation that Spring uses for AbstractAuthenticationToken.class :

public String getName() {         if (this.getPrincipal() instanceof UserDetails) {             return ((UserDetails)this.getPrincipal()).getUsername();         } else if (this.getPrincipal() instanceof AuthenticatedPrincipal) {             return ((AuthenticatedPrincipal)this.getPrincipal()).getName();         } else if (this.getPrincipal() instanceof Principal) {             return ((Principal)this.getPrincipal()).getName();         } else {             return this.getPrincipal() == null ? "" : this.getPrincipal().toString();         }     } 

Also is important to mention:

abstract class AbstractAuthenticationToken implements Authentication and

interface Authentication extends Principal

Principal Interface also ensures that the implementer will implement equals() and hashCode() which makes much sense because the entity of Principal that represents an Organization or a Company or a Person must have some way of being compared with other entities.

like image 21
Panagiotis Bougioukos Avatar answered Sep 19 '22 19:09

Panagiotis Bougioukos