GameAP

GameAP werkt met één API-token, zonder OAuth2-client en zonder sleutelpaar. Maak er een aan in het paneel en plak hem samen met de paneel-URL in Provibr.

• Host: de volledige paneel-URL inclusief de poort, bijvoorbeeld http://panel.example.com:8025. GameAP draait standaard op plain HTTP op 8025, en er is geen poort die Provibr zonder gokken kan aanvullen.
• API-token: het Sanctum-token, in de vorm id|secret. Provibr houdt die id|secret-vorm aan en weigert een token dat zonder de id ervoor geplakt is.

Het token verloopt niet, waarmee het de schoonste langlevende credential van de gamepanelen is: de agent blijft maandenlang werken zonder dat iemand een wachtwoord opnieuw invoert.

Een verse GameAP levert plain HTTP op poort 8025, met poort 443 dicht. Er is geen TLS-fingerprintveld, want zonder TLS is er geen certificaat om te pinnen.

Een paneel op plain http werkt, maar het API-token en alles wat de integratie doet reizen dan onversleuteld. Zet er een reverse proxy met TLS voor om dat te veranderen; de agent valideert de certificaatketen dan als vanouds, zonder pin.

Een GameAP-server is gebouwd uit een spel, een titel als samp of minecraft, en een game mod, de template; samen zijn ze wat elders één Pterodactyl-egg is. Provibr somt die niet voor je op: het API-token wordt geweigerd op de games, mods en nodes van het paneel, die admin-only zijn. Je leest de game code en de mod-id in je eigen GameAP-paneel af en typt ze in het plan.

Een game-plan draagt de game code, de mod-id en de resourcelimieten. Bestellen is plan-gedreven: het spel en zijn template komen uit het plan, en de node komt uit de instellingen van de integratie.

Het API-token kan de nodes van het paneel niet opsommen, dus de plaatsingsengine kan er geen kiezen. De node komt uit de integratie-instelling: GameAP's node-id, dat op een paneel met één node 1 is. Er is ook geen allocatiesysteem: de agent kiest een vrij drietal poorten uit een bereik dat je instelt, want GameAP deelt er zelf geen uit.

Aanmaken, starten, stoppen, herstarten, herinstalleren en verwijderen werken allemaal. Een server aanmaken en installeren zijn twee stappen: het paneel schrijft eerst de rij en installeert daarna, en Provibr doet allebei en wacht dan tot de taak van de daemon klaar is.

Wanneer Provibr een gameserver opschort om een licentielimiet te handhaven, stopt het de server en markeert het hem als geblokkeerd in het paneel.

Er is geen console: die van GameAP loopt over een websocket met een apart kortlevend token en een eigen frameprotocol, een ander pad dan de tunnel die de andere gamepanelen delen. Verbruiksgrafieken zijn er evenmin, want GameAP levert geen cpu, geheugen, schijf of netwerk per server. Provibr beheert het paneel, zijn nodes, bestanden of gebruikers niet; een gameserver op het paneel is de integratie.