Chula SSO

A standalone chula-sso-mock based on chula-sso

Being used in development by Piyaphat Pinyo

Please feel free to use https://sso.piyaphat.com

Usage

Docker images are available on the GitHub Packages.

1. Install docker
2. Download the image: docker pull ghcr.io/remove158/chula-sso:latest
3. Run: docker run -p 8080:8080 ghcr.io/remove158/chula-sso:latest

Preview

Configuration

The configuration is done by the following environment variables. (see docker run on how to set it)

Name	Environment Variable	Default
DeeAppId	DEE_APP_ID	test
DeeAppSecret	DEE_APP_SECRET	test
Port	PORT	8080

Endpoint

GET /login

• Request

curl --request GET \
  --url 'https://sso.piyaphat.com/login?service=https://www.google.com'

• Response 302 Found

// (on-success) 302 Location: https://www.google.com?ticket=86966dc5-2049-428f-88fe-2d78a5985d38

• Response 400 Bad Request

{
    "error": "Key: 'GetLoginRequest.Service' Error:Field validation for 'Service' failed on the 'required' tag"
}

GET, POST /serviceValidation

• Request

curl --request POST \
  --url 'https://sso.piyaphat.com/serviceValidation' \
  --header 'DeeAppId: test' \
  --header 'DeeAppSecret: test' \
  --header 'DeeTicket: 1b50cf0d-ceed-46da-a672-4c61060ece8d'

• Response 200 (application/json)

{
    "uid": "14c6c69f-21ca-4999-999c-423dde2515ad",
    "username": "6200000021",
    "gecos": "Prayut Chan-Angkhan, ENG",
    "disable": false,
    "roles": ["student"],
    "firstname": "Prayut",
    "firstnameth": "Prayut",
    "lastname": "Chan-Angkhan",
    "lastnameth": "Chan-Angkhan",
    "ouid": "6200000021",
    "email": "6200000021@student.chula.ac.th"
}

• Response 401 Unauthorized

{
    "error": "ticket not found"
}

Diagram

Login

sequenceDiagram
    Client->>SSO: GET: /login?service=https://www.google.com
    alt provide service
        SSO->>Client: 302 Found
    else didn't provide service
        SSO->>Client: 400 Bad Request
    end

Loading