1.9 KiB
Server Folders mit Parametern
Backend-Proxy
Der bestehende Frontend-Endpunkt bleibt:
GET /admin/server-folders?path=D:\Milestone
POST /admin/server-folders
Zusätzlich kann der Proxy diese Parameter auswerten:
GET /admin/server-folders?path=D:\Milestone&schema=http&port=8099&token=CHANGE-ME
Aliasnamen:
schema,scheme,agentSchema,agentSchemeport,agentPorttoken,agentToken
Der Proxy entfernt diese Parameter, bevor er an den Agent weiterleitet. Der Token wird als Header weitergegeben:
X-Server-Folders-Token: <token>
Token-Handling (automatisch)
Der Agent wird ohne Token gestartet. Das Backend erzeugt beim Speichern der
Milestone-Einstellungen automatisch einen zufälligen Token und überträgt ihn per
PUT /agent-token an den Agent. Der Agent persistiert den Token in einer Datei
(Standard: neben der .exe) und nutzt ihn danach für alle weiteren Anfragen –
auch nach einem Neustart.
PUT /agent-token
X-Server-Folders-Token: <aktueller-token> # nur nötig, wenn bereits ein Token gesetzt ist
Content-Type: application/json
{ "token": "<neuer-token>" }
Solange noch kein Token gesetzt ist, akzeptiert der Agent PUT /agent-token auch
ohne Header (Bootstrap). Betreibe den Agent daher in einem vertrauenswürdigen
Netzwerk und speichere die Einstellungen nach dem Start zeitnah.
Agent starten
.\server-folders-agent.exe -port 8099 -roots "Milestone D=D:\Milestone;Milestone E=E:\Milestone"
Alternativ weiter per ENV:
$env:LISTEN_ADDR=":8099"
$env:SERVER_FOLDER_ROOTS="Milestone D=D:\Milestone;Milestone E=E:\Milestone"
.\server-folders-agent.exe
Optionale Parameter:
-token/SERVER_FOLDER_AGENT_TOKEN: nur als Start-Seed, falls noch keine Token-Datei existiert (in der Regel nicht nötig).-token-file/SERVER_FOLDER_AGENT_TOKEN_FILE: Pfad der Token-Datei (Standard:server-folders-agent.tokenneben der.exe).