Skip to content

An SDK and a Keycloak plugin for fast integrating with Singpass Single Sign-on auth scheme (modified OpenID-Connect 1.0)

License

Notifications You must be signed in to change notification settings

thoughtworks/inSpac

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

inSpac



Developed by Thoughtworks, Inc.

About

inSpac is the abbreviation for in Singpass Authentication Components, developed and maintained by Thoughtworks, Inc.

inSpac offers an SDK and a Keycloak plugin that can help developers fast integrate OpenID-Connect 1.0 auth scheme into project to interact with Singapore government digital platform -- Singpass.

inSpac is implemented based on the official public documents: For Developers {Login} / Overview

Artifacts & Usage

SDK

SDK test

The SDK is for helping developers fast integrate with authentication scheme of Singpass platform.

To use the SDK, you have to import the SDK jar as a gradle dependency. For example, build.gradle.kts is configured as below.

dependencies {
    implementation(fileTree(mapOf("dir" to "lib", "include" to listOf("*.jar"))))
    // All [.jar] files under [lib] folder are going to be imported as gradle dependencies
    
    // Other dependencies
    }
  1. Download the latest version of SDK artifact (com.thoughtworks.inspac.sdk.jar) at GitHub Releases
  2. Create lib folder under the root directory of project (base on the above gradle configuration), put the SDK under lib folder.

📖 We also offer detailed API documentations for developers' reference: https://thoughtworks.github.io/inSpac/

📦 If you would like to check SDK documents / sources codes, please check sdk folder to get more information.

Keycloak Plugin

Keycloak plugin test

The Keycloak plugin only works on Keycloak. If you would like to use Keycloak as service provider and finish Singpass authentication with it, then this component is helpful.

📦 If you would like to check Keycloak plugin documents / sources codes, please check keycloak-plugin folder to get more information.

Integration Sample

Integration sample test

This is a demo project for demonstrating how to use SDK / Keycloak plugin. If you feel confused about using inSpac, please check the sample folder.

Credits

The project is licensed under MIT.

About

An SDK and a Keycloak plugin for fast integrating with Singpass Single Sign-on auth scheme (modified OpenID-Connect 1.0)

Topics

Resources

License

Stars

Watchers

Forks

Contributors 4

  •  
  •  
  •  
  •