maulana-oauth

module yang di gunakan untuk menghubungkan oauth dari sso server seperti laravel passport ke dalam aplikasi node js, module ini menggunakan base module dari passport.js namun dibuat lebih ringkas dalam konfigurasi untuk mempermudah.

Instalisasi

 # instalisasi dengan npm
 npm i maulana-oauth
 # instalisasi dengan pnpm
 pnpm i maulana-oauth

Penggunaan

Konfigurasi pada app.js

const  oauth  =  require('maulana-oauth')

// Inisialisasi SSO
app.use(oauth.init());

// Pengaturan session
app.use(oauth.session());

Konfigurasi file .env

setelah melakukan konfigurasi app.js perlu di lakukan konfigurasi pada file .env untuk menambahkan variabel pendukung.

AUTHORIZATION_URL=https://server.dev/oauth/authorize
TOKEN_URL=https://server.dev/oauth/token
CLIENT_ID=<client_id>
CLIENT_SECRET=<secret_id>
CALLBACK_URL=https://client.dev/callback
SCOPE=view-user
OAUTH_PUBLICKEY = <path_publicKey>

|Parameter| Keterangan | |--|--| | AUTHORIZATION_URL | url authorization dari server SSO/oauth misalkan https://server.dev/oauth/authorize | |TOKEN_URL| url token dari SSO/oauth untuk request accessToken misalkan https://server.dev/oauth/token | |CLIENT_ID| client id dari server SSO/oauth| |CLIENT_SECRET| Client Secret dari server SSO/oauth| |CALLBACK_URL| Callback url untuk melakukan request accessToken misalkan https://client.dev/callback| |SCOPE| scope yang akan di request oleh aplikasi ke sso server | |OAUTH_PUBLICKEY| public key dari sso server untuk proses verifikasi jwt secara mandiri di aplikasi |

Menambahkan route /login

route ini digunakan untuk menampilkan page sso login dengan cara meredirect ke page sso login

app.get('/login', oauth.redirect());

Menambahkan route /callback

route ini digunakan untuk melakukan request accessToken

app.get('/callback', oauth.callback('/login'), (req, res) => {
    oauth.auth(req, res)
});

|Fungsi| Keterangan | |--|--| | oauth.callback(RouteLogin) | digunakan untuk request accessToken RouteLogin digunakan jika proses gagal maka akan di arahkan ke RouteLogin | |oauth.auth(req, res)| digunakan untuk menyimpan session login dan mendapatkan accessToken| |oauth.userId(req, res)| digunakan untuk mendapatkan userID dari sso server|