Over a million developers have joined DZone.

Secure Your Vertx 3 App With Pac4j

DZone's Guide to

Secure Your Vertx 3 App With Pac4j

The new vertx-pac4j version 2 is out, and can be used to secure Vertx 3 apps! Here's a brief overview of v2.0, and four steps to secure webapps.

· Web Dev Zone ·
Free Resource

Learn how error monitoring with Sentry closes the gap between the product team and your customers. With Sentry, you can focus on what you do best: building and scaling software that makes your users’ lives better.

I'm proud to announce the release of vertx-pac4j v2.0 (https://github.com/pac4j/vertx-pac4j) based on pac4j v1.8 (https://github.com/pac4j/pac4j) for any Vert.x 3 web application. It's now a full security library, easy and powerful, which supports authentication and authorization, but also application logout and advanced features like CSRF protection.

It supports most authentication mechanisms: OAuth (Facebook, Twitter, Google, Yahoo...), CAS, HTTP (form, basic auth...), OpenID, SAML, Google App Engine, OpenID Connect, JWT, LDAP, RDBMS, MongoDB, and Stormpath and authorization checks (role/permission, CSRF token...)

In four easy steps, secure your webapp:

1) Add the dependencies on the library (vertx-pac4j library) and on the required authentication mechanisms (the pac4j-oauth module for Facebook for example)

2) Define the authentication mechanisms (clients) and authorizers (to check authorizations). For example: Facebook authentication and ROLE_ADMIN

FacebookClient facebookClient = new FacebookClient("mykey", "mysecret");
Config config = new Config("http://localhost:9000/callback", facebookClient);
config.addAuthorizer("admin", new RequireAnyRoleAuthorizer("ROLE_ADMIN"));

3) Define the callback handler for Facebook authentication:

CallbackHandler callbackHandler = new CallbackHandler(vertx, config);

4) Secure the /facebook/index.html url to require the user to be authenticated and perform a Facebook authentication if he is not:

Pac4jAuthProvider authProvider = new Pac4jAuthProvider();
Pac4jAuthHandlerOptions options = new Pac4jAuthHandlerOptions()
  .handler(new RequiresAuthenticationHandler(vertx, config, authProvider, options));

and/or to require the user to have the ROLE_ADMIN:

Pac4jAuthHandlerOptions options = new Pac4jAuthHandlerOptions()

Read the documentation: https://github.com/pac4j/vertx-pac4j and try the demo: https://github.com/pac4j/vertx-pac4j-demo

What’s the best way to boost the efficiency of your product team and ship with confidence? Check out this ebook to learn how Sentry's real-time error monitoring helps developers stay in their workflow to fix bugs before the user even knows there’s a problem.

vertx ,security

Opinions expressed by DZone contributors are their own.

{{ parent.title || parent.header.title}}

{{ parent.tldr }}

{{ parent.urlSource.name }}