GAuth

GAuth는 학교 OAuth 서비스로, 교내 프로젝트나 서비스를 만들 때 필요한 학생들의 정보를 쉽게 얻을 수 있습니다.
서비스 사용자는 로그인 및 회원가입을 간편하게 진행할 수 있습니다.

Description

교내 프로젝트나 서비스가 생길 때마다 학생들은 항상 반복적인 회원가입 작업으로 불편함을 겪습니다.
또 매년 바뀌는 학번들로 서비스의 GSM 학생 데이터들을 유지보수하기에 불편함이 생깁니다.
따라서 교내에 OAuth를 도입하면 손쉽게 학생들의 정보를 조회할 수 있어 용이합니다.
학생들은 이용하는 교내 서비스마다 하나의 GAuth 계정으로 간편하게 로그인합니다.

How to Clone?

 git clone https://github.com/GSM-MSG/GAuth-BackEnd.git

How to use?

GAuth 서비스

GAuth 서비스에서 회원가입, 로그인을 진행합니다.
sidebar에서 서비스 등록 탭을 눌러 서비스 등록 페이지로 이동합니다.
서비스 등록 페이지에서 {서비스 이름, redirectURI, 서비스 사이트 URL}을 입력하여 서비스를 등록합니다.

OAuth

https://gauth.co.kr/login?client_id=(clientID)&redirect_uri=(redirectURI) 에 유저가 접속합니다. (OAuth 로그인 페이지)
로그인 성공 시 정보주는 동의를 받고 (redirectURI)?code=(code) 로 리다이렉트됩니다.
리다이렉트된 곳(클라이언트 서버)에서 받은 코드를 써서 https://server.gauth.co.kr/ 에 POST method로 body에 code, clientId, clientSecret을 담아서 보내면 유저정보를 받을 수 있습니다

자세한 설명은 여기를 참고하세요

Contributing

버그 제보: 이슈 트래커에 제보할 버그를 작성합니다.
기능 제안: 이슈 트래커에 제안하고 싶은 기능을 작성합니다.
코드 기여: GitHub에서 코드를 Fork하고, Pull Request를 보냅니다.

Open API Docs

Base URL 임시 대체 안내

기간 24/04/12 ~

변경 전

GauthServerURL: https://server.gauth.co.kr

ResourceServerURL: https://open.gauth.co.kr

변경 후

GauthServerURL: https://port-0-gauth-backend-85phb42bluutn9a7.sel5.cloudtype.app

ResourceServerURL: https://port-0-gauth-resource-server-71t02clq411q18.sel4.cloudtype.app

POST: code 발급

request URL: https://server.gauth.co.kr/oauth/code

code의 유효기간은 15이며 한 번 사용할 시 폐기됩니다.

Request

{
    "body":{
        "email": String,
        "password": String
    }
}

Response

{
    "code": String
}

Error

{
    "400": "Mismatch Password",
    "404": "User Not Found..",
    "500": "Internal Server Error"
}

POST: token 발급

request URL: https://server.gauth.co.kr/oauth/token

Request

{
    "body":{
       "code": String,
       "clientId": String,
       "clientSecret": String,
       "redirectUri": String
    }
}

Response

{
   "accessToken": String,
   "refreshToken": String
}

Error

{
   "400": "Mismatch Client Secret",
   "401": "Invalid Token",
   "404": "Not Found Client by ClientId",
   "500": "Internal Server Error"
}

PATCH: token 재발급

request URL: https://server.gauth.co.kr/oauth/token

Request

{
    "header":{
       "refreshToken": Bearer {RefreshToken}
    }
}

Response

{
   "accessToken": String,
   "refreshToken": String
}

Error

{
   "401": "Invalid Token",
   "404": "Not Found User by Token",
   "500": "Internal Server Error"
}

GET: User Info

request URL: https://open.gauth.co.kr/user

선생님, 혹은 졸업생은 grade, classNum, num이 null로 옵니다!

Request

{
    "header":{
       "Authorization": "Bearer {AccessToken}"
    }
}

Response

{
   "email": String,
   "name": String?,
   "grade": Int?, // 학년
   "classNum": Int?, // 반
   "num": Int?, // 번호
   "gender": "MALE" | "FEMALE",
   "profileUrl": String?,
   "role": "ROLE_STUDENT" | "ROLE_TEACHER" | "ROLE_GRADUATE"
}

Error

{
   "400": "Mismatch ClientSecret",
   "401": "Invalid Token",
   "404": "Not Found Client",
   "500": "Internal Server Error"
}