Authentifizierung
Eranio
Authentifizierung
Jede Anfrage braucht den Header X-Admin-Token mit dem Token des Mods.
X-Admin-Token: 1b4e28ba-2fa1-11d2-883f-0016d3cca427
Woher der Token kommt
Beim ersten Start legt der Mod mods/Eranio_HytaleAdminAPI/config.json mit einer zufälligen UUID als token an. Für einen anderen Token dort ändern und den Server neu starten. Das Pelican-Plugin liest den Token selbst aus dieser Datei.
Beispiel
curl -H 'X-Admin-Token: DEIN_TOKEN' http://localhost:5550/api/status
Antworten
| Status | Bedeutung |
|---|---|
200 |
Angenommen (bei Aktionen success im Inhalt prüfen) |
204 |
CORS-Vorabanfrage (OPTIONS), kein Token nötig |
403 |
Token fehlt oder ist falsch, Inhalt {"error": "Forbidden"} |
Der Vergleich ist zeitkonstant. Einen IP-Filter hat der Mod selbst nicht.
Empfehlungen
- Auf
127.0.0.1binden, wenn das Panel auf derselben Maschine läuft, sonst den Port in der Firewall nur für die Panel-IP öffnen - Den Token nie in Browser-Code einbauen
- Für Zugriff aus dem Internet einen Reverse-Proxy mit HTTPS verwenden