bywang/github-auth-service repository overview

⁠Github Auth Service

This project aims to generate access_token for github oAuth APIs. The access_token is created from code which created by github after you logging with github in your website, according to oAuth2.0 Authorization Code Flow⁠

⁠Why need me?

Github authentication API doesn't support oAuth2.0 Implicit Flow⁠. Given you have a Single page Application, you want to call Github API in browser-side, you need a backedend service to protect the client_secret and then generate access_token.

⁠Workflow

oAuth code -> github-auth-service -> access_token

access_token can be saved in your frontend and call Github API directly in browser side.

⁠Set up in local

export GITHUB_CLIENT_ID=xxxxxxxxxxx 
export GITHUB_CLIENT_SECRET=xxxxxxxxxxx
yarn install
yarn start

⁠Deploy using docker

export GITHUB_CLIENT_ID=xxxxxxxxxxx 
export GITHUB_CLIENT_SECRET=xxxxxxxxxxx
docker run -it bywang/github-auth-service \ 
-e GITHUB_CLIENT_ID=$GITHUB_CLIENT_ID \
-e GITHUB_CLIENT_SECRET=$GITHUB_CLIENT_SECRET

⁠How to call this service?

POST /auth
{"code": "your_code_here"} //with data in Json format: