# 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:

```text
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:

```env
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

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

Tes akses SPOTA lewat proxy:

```bash
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:

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

## Tes dari ifserver2

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

```bash
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:

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

menjadi URL proxy di `ifserver1`, contoh:

```text
http://IP_IFSERVER1:8099
```

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

```text
X-Proxy-Token: ganti_dengan_token_panjang
```