Vaadin Simple Security

A library providing simple security support for Vaadin. Doesn't use nor depend on Spring. Perfect for your Vaadin Boot-based projects. Implements ideas behind the Securing Plain Java Applications Vaadin documentation, but doesn't depend on the servlet container security configuration - instead the users are managed directly by the application.

Supports:

• Authentication - Only allow known users to access the app.
• Authorization - Only allow users with appropriate rights to access particular parts of the app.

Provides a demo in-memory user registry. You should store your users into a database table; this library will assist you with providing best practices for storing passwords (hashing+salting).

The library is in Maven Central. To use from your app, add this library as a dependency via Gradle:

dependencies {
    implementation("com.github.mvysny.vaadin-simple-security:vaadin-simple-security:1.0")
}

Please see the Vaadin Simple Security Example Project.

Compatibility matrix:

Version	Supported Vaadin	Required JDK
1.x	24.3+	17+
0.x	23+	11+

Let's Start

We'll start with a very simple in-memory user management. Afterwards, we'll switch to a SQL-based user table.

First, you'll need a login page. We'll implement the login page as a Vaadin Route, which will simply contain the Vaadin LoginForm component. Vaadin's LoginForm enables proper browser username/password autocompletion; PasswordField and TextField do not since the input element is hidden in ShadowDOM.

@Route("login")
@PageTitle("Login")
@AnonymousAllowed
public class LoginRoute extends VerticalLayout implements ComponentEventListener<AbstractLogin.LoginEvent> {
    @NotNull
    private static final Logger log = LoggerFactory.getLogger(LoginRoute.class);

    @NotNull
    private final LoginForm login = new LoginForm();

    public LoginRoute() {
        setSizeFull();
        setJustifyContentMode(JustifyContentMode.CENTER);
        setAlignItems(Alignment.CENTER);

        login.addLoginListener(this);
        final LoginI18n loginI18n = LoginI18n.createDefault();
        loginI18n.setAdditionalInformation("Log in as user/user or admin/admin");
        login.setI18n(loginI18n);
        add(login);
    }

    @Override
    public void onComponentEvent(@NotNull AbstractLogin.LoginEvent loginEvent) {
        try {
            InMemoryLoginService.get().login(loginEvent.getUsername(), loginEvent.getPassword());
        } catch (LoginException ex) {
            log.warn("Login failed", ex);
            login.setError(true);
        }
    }
}

We need to redirect the browser to that login page if there's no user logged in. We will observe the Vaadin navigation, and on every navigation attempt we'll check whether there is user logged in. If not, we'll redirect to the login page.

In order to hook into Vaadin navigation, we'll need to create a custom VaadinServiceInitListener. Follow the Service Init Listener Tutorial to create the init listener and register it to Vaadin. Then, we'll hook into the Vaadin navigation by adding a BeforeEnterListener to all Vaadin UIs:

public class ApplicationServiceInitListener implements VaadinServiceInitListener {
    // Handles authorization - pulls in the currently-logged-in user from given service and checks
    // whether the user can access given route.
    //
    // InMemoryLoginService remembers the currently logged-in user in the Vaadin Session; it
    // retrieves the users from the InMemoryUserRegistry.
    private final SimpleNavigationAccessControl accessControl = SimpleNavigationAccessControl.usingService(InMemoryLoginService::get);
    
    public ApplicationServiceInitListener() {
        // Let's create the users. 
        InMemoryUserRegistry.get().registerUser(new InMemoryUser("user", "user", Set.of("ROLE_USER")));
        InMemoryUserRegistry.get().registerUser(new InMemoryUser("admin", "admin", Set.of("ROLE_USER", "ROLE_ADMIN")));
      accessControl.setLoginView(LoginRoute.class);
    }
    @Override
    public void serviceInit(ServiceInitEvent event) {
        // accessControl observes all navigation: if there's no user logged in then we'll redirect to the LoginView;
        // if the user is not allowed to access given route then we'll throw an exception (in dev mode)
        // or return 404 not found (in production mode).
        event.getSource().addUIInitListener(e -> e.getUI().addBeforeEnterListener(accessControl));
    }
}

SimpleNavigationAccessControl is the main class which enforces security in an application. It is able to redirect to a login page if there's no user logged in; it also checks whether the current user has access to the route being navigated to.

How will SimpleNavigationAccessControl know which user is currently logged in? That's easy - it will retrieve the user from the InMemoryLoginService service. InMemoryLoginService remembers the currently logged-in user in the Vaadin session; when a user attempts to log in, that user is compared against users stored in the InMemoryUserRegistry.

Most often the logged-in user will be stored in the session. We could store the user to the session directly, then we could make the access control retrieve the user from the session as follows:

new SimpleNavigationAccessControl(() -> VaadinSession.getCurrent().getAttribute(SimpleUserWithRoles.class));

However, we are going to need functions that deal with the logins and logouts as well, and it's good to keep everything neatly in a single class responsible for the current user management. Therefore, it's better to have a dedicated session-scoped LoginService service class which not only stores the current user, but also provide helpful functions such as login(username, password) and logout(). That's exactly what the InMemoryLoginService provides.

InMemoryLoginService inherits lots of useful functions from AbstractLoginService, most importantly:

• getCurrentUser() - returns the currently logged-in user.
• logout() - performs logout and redirects to the LoginRoute

And just like that, we now have the full authentication chain implemented!

To recap:

• InMemoryUserRegistry holds a list of users (usernames, passwords and roles) in memory. Later on we'll store the users in a SQL database, but in-memory will work for now.
• InMemoryLoginService holds the currently logged-in user in Vaadin session, and provides login()/logout() functions. Uses InMemoryUserRegistry when logging in.
• SimpleNavigationAccessControl checks access to Vaadin routes (performs authorization). Retrieves the currently-logged-in user from the InMemoryLoginService.

Authorization

We use the Role-Based Access Control (RBAC). Every user in the app is assigned a set of roles - a set of duties it is expected to perform in the app. Every Vaadin route then declares roles allowed to see that particular view; only users which are assigned at least one of the roles declared on the view are then allowed to visit that view.

For example, the following route may only be accessed by users that contain the admin role.

@Route("admin")
@RolesAllowed("ROLE_ADMIN")
public class AdminPage extends VerticalLayout {}

We previously registered SimpleNavigationAccessControl to observe all routes as they are navigated to. SimpleNavigationAccessControl will use AnnotatedViewAccessChecker to read the annotations present on the route and will make a decision whether to allow access or not.

Please see the Access Annotations Vaadin documentation on what kind of authorization annotations are available.

Users stored in SQL

We recommend to use jdbi-orm or JOOQ to access the database, however you can of course use your favourite library.

An example of such a service follows:

public final class MyLoginService extends AbstractLoginService<User> {
    private MyLoginService() {}
    
    public void login(@NotNull String username, @NotNull String password) throws LoginException {
        final User user = User.dao.findByUsername(username); // load the user from the database
        if (user == null) {
            throw new FailedLoginException("Invalid username or password");
        }
        if (!user.passwordMatches(password)) {
            throw new FailedLoginException("Invalid username or password");
        }
        login(user);
    }

    @Override
    protected @NotNull SimpleUserWithRoles toUserWithRoles(@NotNull User user) {
        return new SimpleUserWithRoles(user.getUsername(), user.getRoleSet());
    }

    @NotNull
    public static MyLoginService get() {
        return get(MyLoginService.class, MyLoginService::new);
    }
}

MyLoginService inherits lots of useful functions from AbstractLoginService, most importantly:

• getCurrentUser() - returns the currently logged-in user.
• logout() - performs logout and redirects to the LoginRoute

We can now instantiate SimpleNavigationAccessControl simply:

SimpleNavigationAccessControl accessControl = SimpleNavigationAccessControl.usingService(MyLoginService::get);

The User entity represents a user stored in a database table. It implements HasPassword which takes care of password hashing+salting, and of password verification.

@Table("users")
public final class User implements Entity<Long>, HasPassword {
    private Long id;
    @NotNull
    private String username;
    @NotNull
    private String hashedPassword;
    @NotNull
    private String roles;
    
    // getters+setters omitted for brevity
    // equals, hashCode, toString() omitted for brevity

    public Set<String> getRoleSet() {
        final String r = getRoles();
        return r == null ? Set.of() : Set.of(r.split(","));
    }

    public static class UserDao extends Dao<User, Long> {
        public UserDao() {
            super(User.class);
        }

        @Nullable
        public User findByUsername(String username) {
            return findSingleBy("username = :username", q -> q.bind("username", username));
        }
    }

    public static final UserDao dao = new UserDao();
}

The SQL DDL for the users table is as follows:

create table users (
  id bigint auto_increment primary key not null,
  username varchar(100) not null,
  hashedPassword varchar(200) not null,
  roles varchar(400) not null
);
create unique index on users(username);

To create the users in the database, simply call

final User admin = new User();
admin.setUsername("admin");
admin.setPassword("admin");
admin.setRoles("ROLE_ADMIN,ROLE_USER");
admin.save();
final User user = new User();
user.setUsername("user");
user.setPassword("user");
user.setRoles("ROLE_USER");
user.save();

Please see the Vaadin Simple Security Example Application for a full example.

Other Authentication mechanisms

There are many security frameworks already present in Java. However, while attempting to support all authentication/authorization schemes those frameworks have became highly abstract and hard to understand. And rightly so: the authentication schemes are wildly variant:

• Authentication using username + password:
  • Against a local SQL database of users
  • Against a LDAP/AD server
• Client-side x509 certificates
• Kerberos-provided security token (client-to-server tickets):
  • Authentication via NTLM/SPNEGO/Windows login via a NTLM servlet filter (the Waffle library)
• SAML-based solutions which are anything but simple
• Oauth2
• Other means: smart cards, fingerprints, ...
• All that while supporting SSO, or using the Servlet container-provided authentication mechanism (the ServletContext.login() method).

It is impossible to create an API convering all those cases without going abstraction-crazy. That's why we deliberately avoid to use an all-encompassing library like Apache Shiro or Spring Security with insanely complex APIs. We also don't provide our own authentication API (since it would either be incomplete or complex). In this case, the best abstraction is no abstraction at all.

However, if need be, we may add support for most used combinations (e.g. username+password via LDAP). A standalone library will then be created.

Your best bet is to implement your own MyLoginService and offer a login() function which could for example authenticate the user against an LDAP server.

Alternatively, you can try to configure the servlet container security instead, follow the Securing Plain Java App tutorial and not use this library.