SPOTA Proxy

Aplikasi proxy kecil dan terpisah untuk meneruskan request dari project KP ke SPOTA melalui server yang masih bisa mengakses spota.untan.ac.id, misalnya ifserver1.

Proxy ini dibuat sebagai produk/deployable terpisah dari service-portal-kp. Deploy di ifserver1, lalu project KP di ifserver2 memanggil proxy ini, bukan langsung ke SPOTA.

Endpoint

Default endpoint yang diizinkan:

/login.php
/getListTugasAkhir.php
/getListMahasiswa.php
/getListDosen.php
/sendMail.php
/healthz

Endpoint selain daftar SPOTA_ALLOWED_ENDPOINTS akan ditolak dengan 404 supaya service ini tidak menjadi open proxy bebas.

Deploy Coolify di ifserver1

Gunakan resource Docker Compose terpisah.

Konfigurasi yang disarankan:

Repository: repository spota-proxy ini
Branch: main
Base directory: spota-proxy
Compose file: docker-compose.yml
Port aplikasi: 8099

Jika repository hanya berisi folder ini, kosongkan Base directory.

Environment minimal:

APP_PORT=8099
SPOTA_BASE_URL=https://spota.untan.ac.id/steven/API
SPOTA_ALLOWED_ENDPOINTS=login.php,getListTugasAkhir.php,getListMahasiswa.php,getListDosen.php,sendMail.php
PROXY_TOKEN=ganti_dengan_token_panjang
CONNECT_TIMEOUT=10
REQUEST_TIMEOUT=30

PROXY_TOKEN opsional, tetapi disarankan jika service dapat diakses dari luar network internal.

Tes dari ifserver1

curl -i http://127.0.0.1:8099/healthz

Tes akses SPOTA lewat proxy:

curl -i -X POST "http://127.0.0.1:8099/login.php" \
  -H "X-Proxy-Token: ganti_dengan_token_panjang" \
  -d "username=USERNAME_SPOTA" \
  -d "password=PASSWORD_SPOTA"

Jika username/password salah tetapi proxy sehat, respons akan tetap berasal dari SPOTA, misalnya:

{"status":0,"msg":"Username dan password tidak cocok!!!"}

Tes dari ifserver2

curl -i http://IP_IFSERVER1:8099/healthz

curl -i -X POST "http://IP_IFSERVER1:8099/login.php" \
  -H "X-Proxy-Token: ganti_dengan_token_panjang" \
  -d "username=USERNAME_SPOTA" \
  -d "password=PASSWORD_SPOTA"

Jika menggunakan domain internal di Coolify, ganti http://IP_IFSERVER1:8099 dengan URL domain tersebut.

Integrasi ke Project KP

Ubah base URL SPOTA di project KP dari:

https://spota.untan.ac.id/steven/API

menjadi URL proxy di ifserver1, contoh:

http://IP_IFSERVER1:8099

Jika PROXY_TOKEN diaktifkan, request dari project KP juga harus mengirim header:

X-Proxy-Token: ganti_dengan_token_panjang

2.5 KiB Raw Permalink Blame History