SSOLite Spring Boot Autoconfigure

A lightweight single sign on library (auto-configuration for Spring Boot)

License	The Apache License, Version 2.0
Categories	Spring Boot Container Microservices Auto Application Layer Libs Code Generators config Configuration
GroupId	com.github.sahara3
ArtifactId	ssolite-spring-boot-autoconfigure
Last Version	1.0.0
Release Date	Apr 16, 2020
Type	jar
Description	SSOLite Spring Boot Autoconfigure A lightweight single sign on library (auto-configuration for Spring Boot)
Project URL	https://github.com/sahara3/ssolite
Source Code Management	https://github.com/sahara3/ssolite

Download ssolite-spring-boot-autoconfigure

Filename	Size
ssolite-spring-boot-autoconfigure-1.0.0.pom
ssolite-spring-boot-autoconfigure-1.0.0.jar	6 KB
ssolite-spring-boot-autoconfigure-1.0.0-sources.jar	5 KB
ssolite-spring-boot-autoconfigure-1.0.0-javadoc.jar	30 KB

How to add to project

Apache Maven

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

Gradle Groovy

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

Gradle Kotlin

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

Apache Buildr

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

Apache Ivy

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

Groovy Grape

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

Scala SBT

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

Leiningen

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

Dependencies

provided (1)

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

runtime (8)

Group / Artifact	Type	Version
org.slf4j : slf4j-api	jar	1.7.26
com.github.sahara3 : ssolite-core	jar	1.0.0
com.github.sahara3 : ssolite-spring	jar	1.0.0
org.springframework : spring-core	jar	5.0.13.RELEASE
org.springframework : spring-context	jar	5.0.13.RELEASE
org.springframework.boot : spring-boot	jar	2.0.9.RELEASE
org.springframework.boot : spring-boot-autoconfigure	jar	2.0.9.RELEASE
org.springframework.security : spring-security-config	jar	5.0.12.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