Come gestire i permessi ACE su FiveM
Comprendi gli ACE e i principal di FiveM, crea gruppi di amministrazione in un file dedicato, verifica ogni permesso dalla console e correggi gli errori Access denied.
In questa pagina
FXServer controlla l'accesso ai comandi con un sistema di ACE (access control entries) e di principal. Questa guida ti spiega come decide, come creare i tuoi gruppi in un file separato, come verificare ogni permesso e come revocare un accesso.
Prerequisiti
- Un server installato con la guida Creare un server FiveM
- Un accesso a txAdmin, per Live Console, CFG Editor e l'elenco dei giocatori
- L'identificatore del giocatore a cui vuoi dare dei permessi
Le nozioni da conoscere
Una regola si legge così: tale principal ha il permesso, o no, di accedere a tale oggetto.
| Nozione | Ruolo | Esempi |
|---|---|---|
| Principal | Chi riceve il permesso | group.admin, identifier.license:abc123, resource.es_extended |
| Oggetto | Ciò che è protetto | command, command.quit, mioserver.garage |
| ACE | Una regola allow o deny |
add_ace group.admin command allow |
| Ereditarietà | Un principal riceve i permessi di un altro | add_principal identifier.license:abc123 group.admin |
I principal più comuni:
| Principal | Indica |
|---|---|
identifier.license:... |
Un giocatore, tramite la sua licenza Rockstar. È l'identificatore più sicuro da usare |
identifier.fivem:... |
Un giocatore, tramite il suo account Cfx.re |
identifier.discord:... |
Un giocatore, tramite il suo account Discord, solo se Discord viene rilevato al momento della connessione |
player.1 |
Il giocatore numero 1 della sessione in corso. Questo numero cambia a ogni connessione |
group.nome |
Un gruppo che definisci liberamente |
resource.nome |
Una risorsa, quando esegue essa stessa un comando |
builtin.everyone |
Tutti |
Come decide FXServer
Quattro regole bastano a prevedere il risultato:
- Senza regola, è negato. Un principal non ha accesso a nulla per impostazione predefinita.
- Un permesso copre i suoi sotto-oggetti.
commandcoprecommand.quit, emioserver.garagecopremioserver.garage.apri. - Un
denyprevale su unallow, indipendentemente dall'ordine delle righe. - Un giocatore viene valutato identificatore per identificatore. Basta che uno solo dei suoi identificatori sia autorizzato perché abbia accesso.
La quarta regola ha una conseguenza importante: un deny applicato a identifier.license:abc123 non impedisce l'accesso se identifier.fivem:42, dello stesso giocatore, è autorizzato. Per togliere un permesso a un giocatore, toglilo dal gruppo invece di aggiungere un deny.
Passo 1: individuare l'identificatore del giocatore
Il giocatore deve essersi già connesso al server. In txAdmin, apri la sua scheda dall'elenco dei giocatori, poi la scheda IDs. Vi trovi valori come license:abc123 o fivem:42.
Per FXServer, aggiungi il prefisso identifier.: license:abc123 diventa identifier.license:abc123.
Passo 2: creare un file di permessi
Un file separato mantiene server.cfg leggibile. Individua la cartella del server, il cui nome termina con .base. Se compaiono più cartelle, quella giusta è indicata da Server Data Folder, in Settings, scheda FXServer:
sudo find /home/fivem/txData -maxdepth 1 -type d -name '*.base'Apri una sessione fivem, salva la configurazione, poi crea il file:
sudo -iu fivem
BASE=/home/fivem/txData/NOME_CARTELLA.base
cp "$BASE/server.cfg" "$BASE/server.cfg.prima-permessi"
nano "$BASE/permissions.cfg"Esempio con un gruppo di moderazione e un gruppo di amministrazione, da adattare:
# Permessi dei moderatori
add_ace group.moderator command.clientkick allow
add_ace group.moderator command.say allow
# Gli amministratori ereditano dai moderatori
add_principal group.admin group.moderator
# Permessi degli amministratori
add_ace group.admin command allow
add_ace group.admin command.quit deny
# Membri del team
add_principal identifier.license:LICENZA_MODERATORE group.moderator
add_principal identifier.license:LICENZA_ADMIN group.adminEsci dalla sessione con exit.
Passo 3: caricare il file
In CFG Editor, aggiungi questa riga accanto ai permessi già presenti:
exec permissions.cfgIl percorso è relativo alla cartella del server. Salva, poi applica il file senza riavviare digitando lo stesso comando in Live Console. Verrà comunque riletto al prossimo avvio.
Un giocatore connesso riceve subito i nuovi permessi, senza doversi riconnettere.
Passo 4: verificare i permessi
Tutti questi comandi si digitano in Live Console. test_ace risponde true o false:
test_ace identifier.license:LICENZA_MODERATORE command.clientkick
test_ace identifier.license:LICENZA_MODERATORE command.quit
test_ace group.admin command.quitCon l'esempio qui sopra, devi ottenere true, false poi false. La risposta ha questa forma:
identifier.license:LICENZA_MODERATORE -> command.clientkick = truePer mostrare tutto ciò che è caricato:
list_principals
list_aceslist_principals mostra figlio <- genitore, e list_aces mostra principal -> oggetto = ALLOW o DENY.
Se un risultato ti sorprende, attiva il tracciamento dettagliato, ripeti l'azione, poi disattivalo:
se_debug true
se_debug falseLa console indica allora ogni regola consultata, con righe TEST ACL [...] -> ALLOW o DENY.
Autorizzare un comando o una risorsa
Aprire a tutti i giocatori un comando con accesso limitato:
add_ace builtin.everyone command.miocomando allowAutorizzare una risorsa a lanciare un comando. Quando una risorsa usa ExecuteCommand, è lei che deve avere il permesso. Concedi solo il comando necessario:
add_ace resource.mia_risorsa command.add_principal allowProteggere una funzione del tuo script. Crea un oggetto libero, poi verificalo lato server con IsPlayerAceAllowed:
add_ace group.moderator mioserver.garage allowif IsPlayerAceAllowed(source, 'mioserver.garage') then
-- azione riservata
endACE e framework
I framework si appoggiano a questo sistema, ma ognuno ha il proprio metodo. Non rimuovere le righe add_ace resource... aggiunte dalla loro recipe: ne hanno bisogno per funzionare.
ESX Legacy
Il gruppo del giocatore è salvato nella colonna group della tabella users. A ogni connessione, ESX aggiunge automaticamente il giocatore a group.<suo gruppo>. Cambia quindi il gruppo con il comando previsto, in Live Console o in gioco, con il giocatore connesso:
setgroup 1 adminQui, 1 è il numero del giocatore nella sessione.
QBCore
QBCore usa i livelli god, admin e mod. Per un permesso duraturo, metti la licenza in permissions.cfg:
add_principal identifier.license:LICENZA_GIOCATORE qbcore.godIl comando in gioco /addpermission 1 god agisce su player.1: va perso non appena il giocatore si disconnette.
txAdmin
Gli account dell'interfaccia txAdmin sono indipendenti dagli ACE. I loro permessi si gestiscono in Admins e sono salvati in admins.json. Dare group.admin a un giocatore non gli dà quindi accesso a txAdmin, e viceversa.
Revocare un permesso
Elimina la riga da permissions.cfg, altrimenti il permesso tornerà al prossimo avvio. Togliere una riga non basta per il server in corso, perché le regole restano in memoria. Digita anche in Live Console:
remove_principal identifier.license:LICENZA_MODERATORE group.moderator
remove_ace group.moderator command.say allowVerifica poi con test_ace. Puoi anche riavviare il server, che riparte solo dai file.
Per annullare completamente le tue modifiche, rimuovi la riga exec permissions.cfg da CFG Editor, rimetti se necessario la copia server.cfg.prima-permessi, poi riavvia il server.
In caso di problemi
Access denied for command
Il messaggio Access denied for command xxx. indica chi non ha il permesso a seconda del contesto:
- Un giocatore ha lanciato il comando: verifica il suo identificatore con
test_ace identifier.license:... command.xxx. - Compare all'avvio di una risorsa, o senza azione di un giocatore: è la risorsa a non avere il permesso. Aggiungi
add_ace resource.nome command.xxx allow.
Con ESX, un messaggio su add_principal o remove_principal segnala spesso che le righe add_ace resource.es_extended ... della recipe sono state rimosse.
No such config file: permissions.cfg
Il file non è nella cartella del server, o il suo nome è diverso. Deve trovarsi accanto a server.cfg ed essere leggibile dall'utente fivem. Nel dubbio, correggi il proprietario:
sudo chown fivem:fivem /home/fivem/txData/NOME_CARTELLA.base/permissions.cfgAccess type needs to be 'allow' or 'deny'
La riga add_ace o remove_ace è scritta male. La sua forma è add_ace principal oggetto allow, senza altre parole.
test_ace risponde true, ma il giocatore non ha accesso
- Verifica che si tratti dello stesso identificatore, nella scheda IDs della sua scheda.
- Non usare
identifier.discordse Discord non era aperto al momento della connessione: preferisci la licenza. - Verifica che il comando venga lanciato davvero come immagini. Un menu o uno script può applicare i propri controlli oltre agli ACE.
Un deny non blocca il giocatore
Il giocatore è probabilmente autorizzato da un altro dei suoi identificatori. Cercali con list_principals, poi toglilo dai gruppi interessati.
Il permesso è sparito dopo una riconnessione o un riavvio
È stato dato con player.N, oppure digitato solo nella console. Aggiungilo a permissions.cfg con identifier.license:....
Un permesso rimosso dal file funziona ancora
Le regole già caricate restano attive fino al riavvio. Usa remove_ace o remove_principal, oppure riavvia il server.