SSOLite Spring Boot Starter

A lightweight single sign on library (starter for Spring Boot)

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

Download ssolite-spring-boot-starter

Filename	Size
ssolite-spring-boot-starter-1.0.0.pom
ssolite-spring-boot-starter-1.0.0.jar	291 bytes
ssolite-spring-boot-starter-1.0.0-sources.jar	261 bytes
ssolite-spring-boot-starter-1.0.0-javadoc.jar	261 bytes

How to add to project

Apache Maven

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

Gradle Groovy

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

Gradle Kotlin

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

Apache Buildr

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

Apache Ivy

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

Groovy Grape

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

Scala SBT

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

Leiningen

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

Dependencies

compile (3)

Group / Artifact	Type	Version
com.github.sahara3 : ssolite-core	jar	1.0.0
com.github.sahara3 : ssolite-spring	jar	1.0.0
com.github.sahara3 : ssolite-spring-boot-autoconfigure	jar	1.0.0

provided (1)

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

runtime (1)

Group / Artifact	Type	Version
org.slf4j : slf4j-api	jar	1.7.26

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