GameAP

GameAP si autentica con un unico token API: nessun client OAuth2 e nessuna coppia di chiavi. Ne crei uno nel pannello, poi lo incolli in Provibr insieme all’URL del pannello.

• Host: l’URL completo del pannello con la porta, per esempio http://panel.example.com:8025. GameAP usa HTTP in chiaro sulla 8025 in modo predefinito, e non c’è porta che Provibr possa aggiungere senza indovinare.
• Token API: il token Sanctum, nella forma id|secret. Provibr mantiene questa forma id|secret e rifiuta un token incollato senza l’id davanti.

Il token non scade, il che ne fa la credenziale a lunga durata più pulita dei pannelli di gioco: l’agente continua a funzionare per mesi senza che nessuno reinserisca una password.

Un GameAP nuovo usa HTTP in chiaro sulla porta 8025, con la 443 chiusa. Non c’è un campo per l’impronta TLS, perché senza TLS non c’è alcun certificato da fissare.

Un pannello in http funziona, ma il token API e tutto ciò che fa l’integrazione viaggiano allora in chiaro. Metta davanti un reverse proxy con TLS per cambiarlo; l’agente convalida allora la catena di certificati come al solito, senza fissaggio.

Un server GameAP nasce da un gioco (un titolo come samp o minecraft) e da un game mod, il suo modello; insieme sono ciò che altrove è un egg di Pterodactyl. Provibr non glieli elenca: il token API viene rifiutato su giochi, mod e nodi del pannello, riservati agli amministratori. Legga il codice di gioco e l’ID del mod nel suo pannello GameAP e li inserisca nel piano.

Un piano di gioco porta il codice di gioco, l’ID del mod e i limiti di risorse. L’ordine passa da un piano: il gioco e il suo modello vengono dal piano, e il nodo viene dalle impostazioni dell’integrazione.

Il token API non può elencare i nodi del pannello, quindi il motore di collocazione non può sceglierne uno. Il nodo viene dall’impostazione dell’integrazione, cioè l’ID di nodo di GameAP, che su un pannello a un solo nodo è 1. Non c’è nemmeno un sistema di assegnazione: l’agente sceglie un terzetto di porte libere da un intervallo che lei imposta, perché GameAP non ne distribuisce di suoi.

Creare, avviare, arrestare, riavviare, reinstallare ed eliminare funzionano tutti. Creare un server e installarlo sono due passi: il pannello scrive prima il record e installa dopo, e Provibr fa entrambi, poi attende che la mansione del daemon finisca.

Quando Provibr sospende un server di gioco per far rispettare un limite di licenza, arresta il server e lo contrassegna come bloccato nel pannello.

Non c’è console: quella di GameAP passa da un websocket con un token effimero a parte e un proprio protocollo a frame, una via diversa dal tunnel che condividono gli altri pannelli di gioco. Non ci sono nemmeno grafici d’uso, perché GameAP non fornisce CPU, memoria, disco o rete per server. Provibr non gestisce il pannello, i suoi nodi, i file o gli utenti; un server di gioco sul pannello è l’integrazione.