Как управлять правами ACE на FiveM
Разберитесь с ACE и принципалами FiveM, создайте группы администрирования в отдельном файле, проверьте каждое право из консоли и устраните ошибки Access denied.
На этой странице
FXServer контролирует доступ к командам с помощью системы ACE (access control entries, записи управления доступом) и принципалов. Это руководство объясняет, как она принимает решения, как создать ваши группы в отдельном файле, как проверить каждое право и как отозвать доступ.
Предварительные требования
- Сервер, установленный по руководству Создание сервера FiveM
- Доступ к txAdmin для работы с Live Console, CFG Editor и списком игроков
- Идентификатор игрока, которому вы хотите выдать права
Что нужно знать
Правило читается так: такой-то принципал имеет или не имеет право доступа к такому-то объекту.
| Понятие | Роль | Примеры |
|---|---|---|
| Принципал | Кто получает право | group.admin, identifier.license:abc123, resource.es_extended |
| Объект | Что защищено | command, command.quit, myserver.garage |
| ACE | Правило allow или deny |
add_ace group.admin command allow |
| Наследование | Принципал получает права другого | add_principal identifier.license:abc123 group.admin |
Наиболее распространённые принципалы:
| Принципал | Обозначает |
|---|---|
identifier.license:... |
Игрока по его лицензии Rockstar. Это самый надёжный идентификатор |
identifier.fivem:... |
Игрока по его учётной записи Cfx.re |
identifier.discord:... |
Игрока по его учётной записи Discord, только если Discord был обнаружен при его подключении |
player.1 |
Игрока с номером 1 в текущей сессии. Этот номер меняется при каждом подключении |
group.name |
Группу, которую вы определяете произвольно |
resource.name |
Ресурс, когда он сам выполняет команду |
builtin.everyone |
Всех |
Как принимает решения FXServer
Четырёх правил достаточно, чтобы предсказать результат:
- Без правила доступ запрещён. По умолчанию у принципала нет доступа ни к чему.
- Право охватывает вложенные объекты.
commandохватываетcommand.quit, аmyserver.garageохватываетmyserver.garage.open. denyимеет приоритет надallow, независимо от порядка строк.- Игрок проверяется по каждому идентификатору отдельно. Достаточно, чтобы был разрешён один из его идентификаторов, и доступ у него будет.
У четвёртого правила есть важное следствие: deny для identifier.license:abc123 не запрещает доступ, если разрешён identifier.fivem:42 того же игрока. Чтобы отозвать право у игрока, уберите его из группы, а не добавляйте deny.
Шаг 1: определение идентификатора игрока
Игрок должен уже хотя бы раз подключиться к серверу. В txAdmin откройте его карточку из списка игроков, затем вкладку IDs. Там вы найдёте значения вроде license:abc123 или fivem:42.
Для FXServer добавьте префикс identifier.: license:abc123 превращается в identifier.license:abc123.
Шаг 2: создание файла прав
Отдельный файл сохраняет server.cfg читаемым. Найдите папку сервера, имя которой заканчивается на .base. Если появилось несколько папок, нужная указана в Server Data Folder, в Settings, вкладка FXServer:
sudo find /home/fivem/txData -maxdepth 1 -type d -name '*.base'Откройте сессию fivem, сохраните конфигурацию, затем создайте файл:
sudo -iu fivem
BASE=/home/fivem/txData/FOLDER_NAME.base
cp "$BASE/server.cfg" "$BASE/server.cfg.before-permissions"
nano "$BASE/permissions.cfg"Пример с группой модерации и группой администрирования, который нужно адаптировать:
# Права модераторов
add_ace group.moderator command.clientkick allow
add_ace group.moderator command.say allow
# Администраторы наследуют права модераторов
add_principal group.admin group.moderator
# Права администраторов
add_ace group.admin command allow
add_ace group.admin command.quit deny
# Члены команды
add_principal identifier.license:MODERATOR_LICENSE group.moderator
add_principal identifier.license:ADMIN_LICENSE group.adminВыйдите из сессии командой exit.
Шаг 3: загрузка файла
В CFG Editor добавьте эту строку рядом с уже имеющимися правами:
exec permissions.cfgПуть указывается относительно папки сервера. Сохраните, затем примените файл без перезапуска, введя ту же команду в Live Console. В любом случае он будет перечитан при следующем запуске.
Подключённый игрок получает новые права сразу, без повторного подключения.
Шаг 4: проверка прав
Все эти команды вводятся в Live Console. test_ace отвечает true или false:
test_ace identifier.license:MODERATOR_LICENSE command.clientkick
test_ace identifier.license:MODERATOR_LICENSE command.quit
test_ace group.admin command.quitВ приведённом выше примере вы должны получить true, false, затем false. Ответ имеет такой вид:
identifier.license:MODERATOR_LICENSE -> command.clientkick = trueЧтобы вывести всё, что загружено:
list_principals
list_aceslist_principals выводит потомок <- родитель, а list_aces выводит принципал -> объект = ALLOW или DENY.
Если результат вас удивляет, включите подробное отслеживание, повторите действие, затем отключите его:
se_debug true
se_debug falseТогда консоль покажет каждое проверенное правило в строках TEST ACL [...] -> ALLOW или DENY.
Разрешение команды или ресурса
Открыть ограниченную команду для всех игроков:
add_ace builtin.everyone command.mycommand allowРазрешить ресурсу запускать команду. Когда ресурс использует ExecuteCommand, право должно быть у него самого. Предоставляйте только необходимую команду:
add_ace resource.my_resource command.add_principal allowЗащитить функцию вашего собственного скрипта. Создайте произвольный объект, затем проверьте его на стороне сервера с помощью IsPlayerAceAllowed:
add_ace group.moderator myserver.garage allowif IsPlayerAceAllowed(source, 'myserver.garage') then
-- действие, доступное только избранным
endACE и фреймворки
Фреймворки опираются на эту систему, но у каждого свой метод. Не удаляйте строки add_ace resource..., добавленные их рецептом: они нужны им для работы.
ESX Legacy
Группа игрока хранится в столбце group таблицы users. При каждом подключении ESX автоматически добавляет игрока в group.<группа_игрока>. Поэтому меняйте группу предусмотренной командой, в Live Console или в игре, пока игрок подключён:
setgroup 1 adminЗдесь 1 — номер игрока в сессии.
QBCore
QBCore использует уровни god, admin и mod. Для постоянного права поместите лицензию в permissions.cfg:
add_principal identifier.license:PLAYER_LICENSE qbcore.godИгровая команда /addpermission 1 god действует на player.1: право теряется, как только игрок отключается.
txAdmin
Учётные записи интерфейса txAdmin не зависят от ACE. Их права управляются в Admins и хранятся в admins.json. Поэтому выдача group.admin игроку не даёт ему доступа к txAdmin, и наоборот.
Отзыв права
Удалите строку из permissions.cfg, иначе право вернётся при следующем запуске. Удаления строки недостаточно для текущего запущенного сервера, так как правила остаются в памяти. Введите также в Live Console:
remove_principal identifier.license:MODERATOR_LICENSE group.moderator
remove_ace group.moderator command.say allowЗатем проверьте с помощью test_ace. Можно также перезапустить сервер, и тогда он начнёт только с файлов.
Чтобы полностью отменить ваши изменения, удалите строку exec permissions.cfg из CFG Editor, при необходимости верните копию server.cfg.before-permissions, затем перезапустите сервер.
При возникновении проблем
Access denied for command
Сообщение Access denied for command xxx. показывает, у кого нет права, в зависимости от контекста:
- Команду запустил игрок: проверьте его идентификатор командой
test_ace identifier.license:... command.xxx. - Оно появляется при запуске ресурса или без действий игрока: права нет у самого ресурса. Добавьте
add_ace resource.name command.xxx allow.
В ESX сообщение о add_principal или remove_principal часто означает, что строки add_ace resource.es_extended ... из рецепта были удалены.
No such config file: permissions.cfg
Файла нет в папке сервера, или его имя отличается. Он должен находиться рядом с server.cfg и быть доступным для чтения пользователю fivem. В случае сомнений исправьте владельца:
sudo chown fivem:fivem /home/fivem/txData/FOLDER_NAME.base/permissions.cfgAccess type needs to be 'allow' or 'deny'
Строка add_ace или remove_ace написана неверно. Её форма — add_ace принципал объект allow, без других слов.
test_ace отвечает true, но у игрока нет доступа
- Убедитесь, что это тот же идентификатор, на вкладке IDs его карточки.
- Не используйте
identifier.discord, если Discord не был открыт при его подключении: лучше используйте лицензию. - Убедитесь, что команда запускается именно так, как вы себе представляете. Меню или скрипт могут применять собственные проверки в дополнение к ACE.
deny не блокирует игрока
Вероятно, игрок разрешён по другому из своих идентификаторов. Найдите их командой list_principals, затем уберите его из соответствующих групп.
Право исчезло после повторного подключения или перезапуска
Оно было выдано через player.N или введено только в консоли. Добавьте его в permissions.cfg через identifier.license:....
Право, удалённое из файла, всё ещё работает
Уже загруженные правила остаются активными до перезапуска. Используйте remove_ace или remove_principal либо перезапустите сервер.