pac4j parent for Lagom

Sonatype helps open source projects to set up Maven repositories on https://oss.sonatype.org/

License	The Apache Software License, Version 2.0
Categories	pac4j Security
GroupId	org.pac4j
ArtifactId	lagom-pac4j-parent
Last Version	2.2.1
Release Date	Nov 9, 2020
Type	pom
Description	pac4j parent for Lagom Sonatype helps open source projects to set up Maven repositories on https://oss.sonatype.org/
Project URL	https://github.com/pac4j/lagom-pac4j
Source Code Management	http://github.com/pac4j/lagom-pac4j.git

Download lagom-pac4j-parent

Filename	Size
lagom-pac4j-parent-2.2.1.pom	7 KB

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/org.pac4j/lagom-pac4j-parent/ -->
<dependency>
    <groupId>org.pac4j</groupId>
    <artifactId>lagom-pac4j-parent</artifactId>
    <version>2.2.1</version>
    <type>pom</type>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/org.pac4j/lagom-pac4j-parent/
implementation 'org.pac4j:lagom-pac4j-parent:2.2.1'

Gradle Kotlin

// https://jarcasting.com/artifacts/org.pac4j/lagom-pac4j-parent/
implementation ("org.pac4j:lagom-pac4j-parent:2.2.1")

Apache Buildr

'org.pac4j:lagom-pac4j-parent:pom:2.2.1'

Apache Ivy

<dependency org="org.pac4j" name="lagom-pac4j-parent" rev="2.2.1">
  <artifact name="lagom-pac4j-parent" type="pom" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='org.pac4j', module='lagom-pac4j-parent', version='2.2.1')
)

Scala SBT

libraryDependencies += "org.pac4j" % "lagom-pac4j-parent" % "2.2.1"

Leiningen

[org.pac4j/lagom-pac4j-parent "2.2.1"]

Dependencies

compile (1)

Group / Artifact	Type	Version
org.pac4j : pac4j-core	jar	3.7.0

provided (2)

Group / Artifact	Type	Version
org.pac4j : pac4j-jwt	jar	3.7.0
com.nimbusds : nimbus-jose-jwt	jar	7.9

test (4)

Group / Artifact	Type	Version
org.junit.jupiter : junit-jupiter-engine	jar	5.3.1
org.assertj : assertj-core	jar	3.11.1
org.pac4j : pac4j-http	jar	3.7.0
com.fasterxml.jackson.core : jackson-annotations	jar	2.9.4

Project Modules

• lagom-pac4j_2.11
• lagom-pac4j_2.12
• lagom-pac4j_2.13

The lagom-pac4j project is an easy and powerful security library for Lagom framework which supports authentication and authorization. It's based on Lagom 1.5/1.6 (and Scala 2.11/2.12/2.13) and the pac4j security engine v3. It's available under the Apache 2 license.

Several versions of the library are available for the different versions of the Lagom framework:

Lagom version	pac4j version	lagom-pac4j version
1.4+	3.6	1.x.y (Java & Scala)
1.[5|6]+	3.7	2.x.y (Java & Scala)

Main concepts and components:

1. A client represents an authentication mechanism. It performs the login process and returns a user profile. An indirect client is for web applications authentication while a direct client is for web services authentication:

▸ OAuth - SAML - CAS - OpenID Connect - HTTP - OpenID - Google App Engine - Kerberos - LDAP - SQL - JWT - MongoDB - CouchDB - IP address - REST API

2. An authorizer is meant to check authorizations on the authenticated user profile(s) or on the current web context:

▸ Roles / permissions - Anonymous / remember-me / (fully) authenticated - Profile type, attribute - CORS - CSRF - Security headers - IP address, HTTP method

3. The SecuredService interface/trait protect methods in Lagom service by checking that the user is authenticated and that the authorizations are valid, according to the clients and authorizers configuration. If the user is not authenticated, the method can be processed with an anonymous profile.

Usage

1) Add the required dependencies

2) Define:

- the security configuration

3) Apply security and get the authenticated user profiles

Demos

Two demo services demonstrate authenticate/authorize by JWT: (Scala/Sbt demo, Java/Maven demo)

Versions

The latest released version is the The next version is under development.

See the release notes. Learn more by browsing the pac4j documentation and the lagom-pac4j Javadoc.

Need help?

If you need commercial support (premium support or new/specific features), contact us at [email protected].

If you have any questions, want to contribute or be notified about the new releases and security fixes, please subscribe to the following mailing lists:

• pac4j-users
• pac4j-developers
• pac4j-announce
• pac4j-security

PAC4J

The security library for Java

Versions

Version
2.2.1 Nov 9, 2020
2.2.0 Nov 3, 2020
2.1.0 Jan 6, 2020
2.0.0 May 3, 2019
1.1.0 Mar 4, 2019
1.0.0 Nov 22, 2018