SSOLite Spring

A lightweight single sign on library (for Spring)

License	The Apache License, Version 2.0
GroupId	com.github.sahara3
ArtifactId	ssolite-spring
Last Version	1.0.0
Release Date	Apr 16, 2020
Type	jar
Description	SSOLite Spring A lightweight single sign on library (for Spring)
Project URL	https://github.com/sahara3/ssolite
Source Code Management	https://github.com/sahara3/ssolite

Download ssolite-spring

Filename	Size
ssolite-spring-1.0.0.pom
ssolite-spring-1.0.0.jar	29 KB
ssolite-spring-1.0.0-sources.jar	19 KB
ssolite-spring-1.0.0-javadoc.jar	99 KB

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/com.github.sahara3/ssolite-spring/ -->
<dependency>
    <groupId>com.github.sahara3</groupId>
    <artifactId>ssolite-spring</artifactId>
    <version>1.0.0</version>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/com.github.sahara3/ssolite-spring/
implementation 'com.github.sahara3:ssolite-spring:1.0.0'

Gradle Kotlin

// https://jarcasting.com/artifacts/com.github.sahara3/ssolite-spring/
implementation ("com.github.sahara3:ssolite-spring:1.0.0")

Apache Buildr

'com.github.sahara3:ssolite-spring:jar:1.0.0'

Apache Ivy

<dependency org="com.github.sahara3" name="ssolite-spring" rev="1.0.0">
  <artifact name="ssolite-spring" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='com.github.sahara3', module='ssolite-spring', version='1.0.0')
)

Scala SBT

libraryDependencies += "com.github.sahara3" % "ssolite-spring" % "1.0.0"

Leiningen

[com.github.sahara3/ssolite-spring "1.0.0"]

Dependencies

compile (7)

Group / Artifact	Type	Version
com.github.sahara3 : ssolite-core	jar	1.0.0
org.springframework.security : spring-security-core	jar	5.0.12.RELEASE
org.springframework.security : spring-security-web	jar	5.0.12.RELEASE
org.springframework.security : spring-security-config	jar	5.0.12.RELEASE
com.fasterxml.jackson.core : jackson-core	jar	2.9.8
com.fasterxml.jackson.core : jackson-databind	jar	2.9.8
com.fasterxml.jackson.core : jackson-annotations	jar	2.9.0

provided (1)

Group / Artifact	Type	Version
javax.servlet : javax.servlet-api	jar	3.1.0

runtime (3)

Group / Artifact	Type	Version
org.slf4j : slf4j-api	jar	1.7.26
org.springframework : spring-core	jar	5.0.13.RELEASE
org.springframework : spring-web	jar	5.0.13.RELEASE

Project Modules

There are no modules declared in this project.

SSOLite

This is a lightweight Single Sign On library using Spring Security 5.

It consists of a server that performs authentication and a client that uses authenticated information provided by the server. The server does not provide authorization mechanism. Authorization is a client's job.

Samples

Server sample using Spring

'sample-server-spring' is a server sample using Spring. To run it:

$ ./gradlew sample-server-spring:bootRun

You can access this server with http://localhost:8080/. In the login page, you enter the username and password to login.

Client sample using Spring

'sample-client-spring' is a client sample using Spring. To run it:

$ ./gradlew sample-client-spring:bootRun

You can access this server with http://127.0.0.1:8081/. You will see the server login page if the server is running. After entering the correct username and password, you will retern the client page.

This client sample also has local login mechanism. You can access http://127.0.0.1:8081/login to login with the client-local username and password.

Client sample using Struts2

'sample-client-struts2' is a client sample using Struts2. To run it:

$ ./gradlew sample-client-struts2:tomcatRun

You can access this server with http://127.0.0.1:8081/. You will see the server login page if the server is running. After entering the correct username and password, you will retern the client page.

This client sample also has local login mechanism. You can access http://127.0.0.1:8081/login to login with the client-local username and password.

Mechanism

TODO

Server Configuration

To use SSOLite server library for Spring, set some properties in the server's application.properties (or application.yml, etc.).

# Set true on the server application.
ssolite.server.enabled = true

# Default redirecting URL after login.
# 'internal:' indicates the relative path from the context root.
ssolite.server.default-top-page-url = internal:/

# Permitted client URL that is used in the single sign on.
ssolite.server.permitted-domains[0] = http://<host>/sso-login
...

License

Apache License 2.0. See LICENSE file for details.

Versions

Version
1.0.0 Apr 16, 2020