Comment gérer les permissions ACE sur FiveM
Comprenez les ACE et les principals de FiveM, créez des groupes d'administration dans un fichier dédié, testez chaque droit depuis la console et corrigez les erreurs Access denied.
Sur cette page
FXServer contrôle l'accès aux commandes avec un système d'ACE (access control entries) et de principals. Ce guide vous explique comment il décide, comment créer vos groupes dans un fichier séparé, comment tester chaque droit et comment retirer un accès.
Prérequis
- Un serveur installé avec le guide Créer un serveur FiveM
- Un accès à txAdmin, pour Live Console, CFG Editor et la liste des joueurs
- L'identifiant du joueur à qui vous voulez donner des droits
Les notions à connaître
Une règle se lit ainsi : tel principal a le droit, ou non, d'accéder à tel objet.
| Notion | Rôle | Exemples |
|---|---|---|
| Principal | Qui reçoit le droit | group.admin, identifier.license:abc123, resource.es_extended |
| Objet | Ce qui est protégé | command, command.quit, monserveur.garage |
| ACE | Une règle allow ou deny |
add_ace group.admin command allow |
| Héritage | Un principal reçoit les droits d'un autre | add_principal identifier.license:abc123 group.admin |
Les principals les plus courants :
| Principal | Désigne |
|---|---|
identifier.license:... |
Un joueur, par sa licence Rockstar. C'est l'identifiant le plus sûr à utiliser |
identifier.fivem:... |
Un joueur, par son compte Cfx.re |
identifier.discord:... |
Un joueur, par son compte Discord, seulement si Discord est détecté à sa connexion |
player.1 |
Le joueur numéro 1 de la session en cours. Ce numéro change à chaque connexion |
group.nom |
Un groupe que vous définissez librement |
resource.nom |
Une ressource, quand elle exécute elle-même une commande |
builtin.everyone |
Tout le monde |
Comment FXServer décide
Quatre règles suffisent à prévoir le résultat :
- Sans règle, c'est refusé. Un principal n'a accès à rien par défaut.
- Un droit couvre ses sous-objets.
commandcouvrecommand.quit, etmonserveur.garagecouvremonserveur.garage.ouvrir. - Un
denyl'emporte sur unallow, quel que soit l'ordre des lignes. - Un joueur est évalué identifiant par identifiant. Il suffit qu'un seul de ses identifiants soit autorisé pour qu'il ait accès.
La quatrième règle a une conséquence importante : un deny posé sur identifier.license:abc123 n'empêche pas l'accès si identifier.fivem:42, du même joueur, est autorisé. Pour retirer un droit à un joueur, retirez-le du groupe plutôt que d'ajouter un deny.
Étape 1 : relever l'identifiant du joueur
Le joueur doit s'être déjà connecté au serveur. Dans txAdmin, ouvrez sa fiche depuis la liste des joueurs, puis l'onglet IDs. Vous y trouvez des valeurs comme license:abc123 ou fivem:42.
Pour FXServer, ajoutez le préfixe identifier. : license:abc123 devient identifier.license:abc123.
Étape 2 : créer un fichier de permissions
Un fichier séparé garde server.cfg lisible. Repérez le dossier du serveur, dont le nom se termine par .base. Si plusieurs dossiers apparaissent, le bon est indiqué par Server Data Folder, dans Settings, onglet FXServer :
sudo find /home/fivem/txData -maxdepth 1 -type d -name '*.base'Ouvrez une session fivem, sauvegardez la configuration, puis créez le fichier :
sudo -iu fivem
BASE=/home/fivem/txData/NOM_DU_DOSSIER.base
cp "$BASE/server.cfg" "$BASE/server.cfg.avant-permissions"
nano "$BASE/permissions.cfg"Exemple avec un groupe de modération et un groupe d'administration, à adapter :
# Droits des modérateurs
add_ace group.moderator command.clientkick allow
add_ace group.moderator command.say allow
# Les administrateurs héritent des modérateurs
add_principal group.admin group.moderator
# Droits des administrateurs
add_ace group.admin command allow
add_ace group.admin command.quit deny
# Membres de l'équipe
add_principal identifier.license:LICENCE_DU_MODERATEUR group.moderator
add_principal identifier.license:LICENCE_DE_L_ADMIN group.adminQuittez la session avec exit.
Étape 3 : charger le fichier
Dans CFG Editor, ajoutez cette ligne à côté des permissions déjà présentes :
exec permissions.cfgLe chemin est relatif au dossier du serveur. Enregistrez, puis appliquez le fichier sans redémarrer en tapant la même commande dans Live Console. Il sera de toute façon relu au prochain démarrage.
Un joueur connecté reçoit ses nouveaux droits immédiatement, sans se reconnecter.
Étape 4 : tester les droits
Toutes ces commandes se tapent dans Live Console. test_ace répond true ou false :
test_ace identifier.license:LICENCE_DU_MODERATEUR command.clientkick
test_ace identifier.license:LICENCE_DU_MODERATEUR command.quit
test_ace group.admin command.quitAvec l'exemple ci-dessus, vous devez obtenir true, false puis false. La réponse a cette forme :
identifier.license:LICENCE_DU_MODERATEUR -> command.clientkick = truePour afficher tout ce qui est chargé :
list_principals
list_aceslist_principals affiche enfant <- parent, et list_aces affiche principal -> objet = ALLOW ou DENY.
Si un résultat vous surprend, activez le suivi détaillé, refaites l'action, puis désactivez-le :
se_debug true
se_debug falseLa console indique alors chaque règle consultée, avec des lignes TEST ACL [...] -> ALLOW ou DENY.
Autoriser une commande ou une ressource
Ouvrir une commande restreinte à tous les joueurs :
add_ace builtin.everyone command.macommande allowAutoriser une ressource à lancer une commande. Quand une ressource utilise ExecuteCommand, c'est elle qui doit avoir le droit. Accordez uniquement la commande nécessaire :
add_ace resource.ma_ressource command.add_principal allowProtéger une fonction de votre propre script. Créez un objet libre, puis testez-le côté serveur avec IsPlayerAceAllowed :
add_ace group.moderator monserveur.garage allowif IsPlayerAceAllowed(source, 'monserveur.garage') then
-- action réservée
endACE et frameworks
Les frameworks s'appuient sur ce système, mais chacun a sa méthode. Ne retirez pas les lignes add_ace resource... ajoutées par leur recette : ils en ont besoin pour fonctionner.
ESX Legacy
Le groupe du joueur est stocké dans la colonne group de la table users. À chaque connexion, ESX ajoute automatiquement le joueur à group.<son groupe>. Changez donc le groupe avec la commande prévue, dans Live Console ou en jeu, le joueur étant connecté :
setgroup 1 adminIci, 1 est le numéro du joueur dans la session.
QBCore
QBCore utilise les niveaux god, admin et mod. Pour un droit durable, placez la licence dans permissions.cfg :
add_principal identifier.license:LICENCE_DU_JOUEUR qbcore.godLa commande en jeu /addpermission 1 god agit sur player.1 : elle est perdue dès que le joueur se déconnecte.
txAdmin
Les comptes de l'interface txAdmin sont indépendants des ACE. Leurs droits se gèrent dans Admins et sont stockés dans admins.json. Donner group.admin à un joueur ne lui donne donc pas accès à txAdmin, et inversement.
Retirer un droit
Supprimez la ligne de permissions.cfg, sinon le droit reviendra au prochain démarrage. Retirer une ligne ne suffit pas pour le serveur en cours, car les règles restent en mémoire. Tapez aussi dans Live Console :
remove_principal identifier.license:LICENCE_DU_MODERATEUR group.moderator
remove_ace group.moderator command.say allowVérifiez ensuite avec test_ace. Vous pouvez aussi redémarrer le serveur, ce qui repart uniquement des fichiers.
Pour annuler complètement vos changements, retirez la ligne exec permissions.cfg de CFG Editor, remettez au besoin la copie server.cfg.avant-permissions, puis redémarrez le serveur.
En cas de problème
Access denied for command
Le message Access denied for command xxx. indique qui n'a pas le droit selon le contexte :
- Un joueur a lancé la commande : testez son identifiant avec
test_ace identifier.license:... command.xxx. - Il apparaît au démarrage d'une ressource, ou sans action d'un joueur : c'est la ressource qui n'a pas le droit. Ajoutez
add_ace resource.nom command.xxx allow.
Avec ESX, un message sur add_principal ou remove_principal signale souvent que les lignes add_ace resource.es_extended ... de la recette ont été retirées.
No such config file: permissions.cfg
Le fichier n'est pas dans le dossier du serveur, ou son nom est différent. Il doit se trouver à côté de server.cfg, et être lisible par l'utilisateur fivem. En cas de doute, corrigez le propriétaire :
sudo chown fivem:fivem /home/fivem/txData/NOM_DU_DOSSIER.base/permissions.cfgAccess type needs to be 'allow' or 'deny'
La ligne add_ace ou remove_ace est mal écrite. Sa forme est add_ace principal objet allow, sans autre mot.
test_ace répond true, mais le joueur n'a pas accès
- Vérifiez qu'il s'agit du même identifiant, dans l'onglet IDs de sa fiche.
- N'utilisez pas
identifier.discordsi Discord n'était pas ouvert à sa connexion : préférez la licence. - Vérifiez que la commande se lance bien comme vous l'imaginez. Un menu ou un script peut appliquer ses propres contrôles en plus des ACE.
Un deny ne bloque pas le joueur
Le joueur est probablement autorisé par un autre de ses identifiants. Cherchez-les avec list_principals, puis retirez-le des groupes concernés.
Le droit a disparu après une reconnexion ou un redémarrage
Il a été donné avec player.N, ou tapé uniquement dans la console. Ajoutez-le à permissions.cfg avec identifier.license:....
Un droit retiré du fichier fonctionne encore
Les règles déjà chargées restent actives jusqu'au redémarrage. Utilisez remove_ace ou remove_principal, ou redémarrez le serveur.