umask у Linux: звідки беруться права за замовчуванням
Дізнайтеся, як umask очищає біти прав: виконайте umask, створіть файл і каталог та порівняйте режими, щоб зрозуміти різницю між root і вашим користувачем.
Що робить umask у Linux
umask — це число, яке має кожен процес у Linux. Воно визначає режим доступу для кожного файлу й каталогу, створеного цим процесом. Під час створення програма передає ядру набір дозволів. Ядро очищає всі біти, указані в масці, і застосовує решту. umask ніколи не надає доступ. Вона лише вилучає біти з дозволів, які запитала програма, що створює об’єкт. У документації ядра зазначено виняток: якщо батьківський каталог має default ACL, маска ігнорується, а натомість застосовується успадкований ACL.
Значення не є властивістю вашого дистрибутива. Воно залежить від облікового запису та способу запуску shell. На одному комп’ютері ці два параметри можуть відрізнятися в один і той самий момент, навіть у стандартному образі. Тому перший крок — не пошук у довіднику. Спочатку потрібно перевірити фактичне значення на сервері перед вами.
Виведіть umask у поточній оболонці
umask
umask -SПерша форма виводить маску у вісімковому форматі. Друга виводить ту саму маску як дозволи, які вона пропускає, у символьному форматі, прийнятному для chmod. Залиште обидва рядки на екрані. Усе нижче — порівняння з тим, що щойно вивела ваша оболонка.
umask — це вбудована команда оболонки, а не програма на диску. Підтвердьте це за допомогою type umask. Це важливо, оскільки вбудована команда змінює сам процес оболонки. Окрема програма могла б змінити лише власний процес, а потім завершитися та завершити разом із собою цю зміну.
Створіть файл і каталог, а потім зчитайте їхні режими
cd "$(mktemp -d)"
touch probe.file
mkdir probe.dir
stat -c '%a %A %n' probe.file probe.dir%a виводить режим у вісімковому форматі, а %A виводить той самий режим у форматі drwxr-xr-x, який використовує ls -l. Порівняйте обидва рядки з маскою, яку щойно вивели. Кожен біт, установлений у масці, відсутній у режимах, оскільки маска лише очищає ці біти. Якщо стовпець %A ще важко читати, спочатку розберіться з рядком дозволів drwxr-xr-x.
Файл і каталог відрізняються, і причина не в масці. touch запитує права на читання та запис для власника, групи й інших користувачів. mkdir запитує права на читання, запис і виконання для всіх трьох категорій. Та сама маска застосовується до двох різних запитів. Тому файл, створений за допомогою touch, ніколи не буде виконуваним, незалежно від значення маски: біт виконання не запитувався, а маска не може додати біт назад.
( umask a=rwx; touch open.file; stat -c '%a %A %n' open.file )Дужки запускають команди в підоболонці, тому зміна зникає разом із нею. Тепер маска не вимагає очищати жодного біта, а stat все одно не показує біта виконання для файлу. Після цього знову виконайте umask — початкове значення повернеться. Це показує, що параметр зберігається всередині процесу й успадковується дочірніми процесами, а не записується на диск.
Для каталогів наслідки очищеного біта виконання помітні особливо чітко.
( umask a=rw; mkdir noexec.dir; cd noexec.dir )Як звичайний користувач, cd завершується помилкою bash: cd: noexec.dir: Permission denied, оскільки маска очистила біт виконання, який запитував mkdir, а каталог без біта виконання неможливо відкрити. root минає цю перевірку, тому проблема проявляється лише для звичайного облікового запису.
Чому root і ваш користувач бачать різні значення umask
Виконайте те саме вимірювання через інший обліковий запис, запустивши його іншим способом, і порівняйте два результати поруч.
umask
sudo -i umasksudo -i запускає login shell користувача root і виконує вбудовану команду в ньому. Отже, це інший обліковий запис, який проходить інший шлях запуску. У стандартних образах серверів Ubuntu та Debian ці два рядки можуть вивести різні значення. Обидва рядки правильні. Кожен показує результат свого шляху запуску. У решті цієї статті розглянуто, яка саме частина системи його сформувала.
Який файл у вашому образі визначав це значення
grep -nE '^(UMASK|USERGROUPS_ENAB)' /etc/login.defs
grep -rn pam_umask /etc/pam.d/
grep -rn umask /etc/profile /etc/profile.d/ /etc/bash.bashrc ~/.profile ~/.bashrc 2>/dev/null || echo 'no umask line in the shell startup files'Якщо перший grep нічого не виводить, виконайте його ще раз без якоря ^: рядок може бути закоментований, а закоментований рядок є документацією, а не конфігурацією. Третя команда grep часто дивує. У Debian і Ubuntu встановлений файл /etc/profile переважно посилається на PAM, а не задає маску самостійно, тому файл, який ви вважали відповідальним, часто ним не є. grep завершується з ненульовим кодом, якщо нічого не знаходить, тому цей рядок закінчується на || echo: в образі, де жоден файл запуску не містить маски, ви отримуєте повідомлення, а не порожній вивід, і саме це повідомлення є результатом перевірки.
/etc/login.defs оголошує значення, а PAM застосовує інше
Рядок UMASK у /etc/login.defs містить значення, яке наводить більшість інструкцій. Ні kernel, ні shell не читають цей файл. Його читає pam_umask — модуль PAM (pluggable authentication modules), який запускається під час створення сеансу. pam_umask бере перше знайдене значення: запис umask= у полі GECOS користувача, потім аргумент umask=, указаний безпосередньо в рядку pam_umask.so, далі UMASK із /etc/login.defs і, зрештою, запис UMASK= у /etc/default/login. Дистрибутиви вносять зміни до цього модуля, тому виконайте man pam_umask у власному образі та перевірте порядок, який буде виведено.
Саме тому /etc/login.defs може оголошувати одне значення, а ваш сеанс отримує інше, причому жодна зі сторін не виводить попередження. Команди grep покажуть, який саме випадок у вас. Якщо рядок pam_umask.so містить власний аргумент umask=, значення з login.defs не застосовується.
USERGROUPS_ENAB і виняток для root
id -un
id -gnЯкщо ці два значення виводять однакове ім’я, у вас є приватна група користувача: обліковий запис створено разом із власною групою, названою на його честь. USERGROUPS_ENAB у /etc/login.defs змушує useradd створювати таку групу за замовчуванням. pam_umask має відповідну поведінку usergroups. У модулі upstream її вмикає аргумент usergroups у рядку pam_umask.so або значення за замовчуванням, задане під час збирання, а nousergroups вимикає її. Ubuntu у 2011 році внесла до модуля зміни, щоб він читав USERGROUPS_ENAB, тому прочитайте коментар над цим рядком і перевірте man pam_umask у власному образі. Коли цю поведінку ввімкнено, обліковий запис не є root, а назва основної групи збігається з іменем користувача, модуль копіює цифру власника з маски в цифру групи. У результаті сеанс завершується з маскою, яка залишає біти групи відкритими для всього, що створює цей обліковий запис. root виключено самим модулем, і саме це виключення найчастіше є причиною того, що дві оболонки на одному сервері виводять різні маски.
Обґрунтування цього правила полягає в тому, що приватна група має рівно одного учасника, тому право запису для групи фактично означає право запису для власника і не більше. Це працює, доки до групи не додадуть другого учасника. Відтоді новий учасник може записувати в кожен файл, який обліковий запис створив раніше, хоча для цього файлів не змінювали жодною командою. Створюйте для кожного сервісу власний обліковий запис із мінімально необхідними привілеями, і тоді ця група навмисно залишатиметься групою з одного учасника.
Оболонка входу, оболонка без входу та неінтерактивна оболонка
umask
bash -lc 'umask'
bash -c 'umask'PAM запускається під час створення сеансу: login на консолі, sshd, su, sudo -i. Якщо одна оболонка запускає іншу, PAM не запускається. bash -l є оболонкою входу, тому вона читає /etc/profile і ~/.profile, але ніколи не викликає pam_umask, оскільки сеанс не створювався. bash -c не читає жоден із цих файлів і успадковує маску процесу, який її запустив. Git hook і програма, запущена менеджером служб, належать до останнього випадку, тому їхня маска визначається маскою батьківського процесу. Cron також не читає файли запуску оболонки, але в Debian його PAM-файл містить common-session-noninteractive, який завантажує pam_umask, тому кожне завдання отримує значення PAM, яке отримав би сеанс.
Тому повідомлення «Я встановив це в /etc/profile, але служба й далі створює файли з неправильними правами доступу» трапляється так часто. Служба ніколи не читала цей файл.
Де налаштувати маску, щоб вона зберігалася
Встановлюйте маску там, де фактично запускається робоче навантаження, оскільки кожен спосіб запуску читає інший файл.
- Для облікових записів, які виконують вхід:
UMASKу/etc/login.defs, що застосовується pam_umask до кожного сеансу на машині. Це загальносистемне налаштування, тому воно змінює значення для всіх облікових записів одночасно. - Для одного облікового запису: аргумент
umask=у рядкуpam_umask.soтакож є загальносистемним, тому значення для окремого користувача слід вказати в полі GECOS цього користувача, або в~/.profileдля login shell і в~/.bashrcдля інтерактивних shell. - Для daemon під керуванням systemd:
UMask=у секції[Service]unit. Unit запускає service manager, тому/etc/profileніколи не читається, а pam_umask не запускається. Лише файл unit із наведених варіантів впливає на daemon. - Для скрипту, який запускається cron або hook: явне
umaskу першому рядку, до того як скрипт створить будь-які об’єкти.
[Service]
UMask=<the octal mask you chose>Потім перевірте результат після нового запуску тим самим способом і ніколи не перевіряйте його в shell, де ви редагували файл. Поточний shell уже зберігає свою маску, а редагування конфігураційного файлу не змінює вже запущений процес.
bash -lc 'umask'
sudo -i umaskЧому виконання chmod після створення не є тим самим виправленням
chmod виправляє наявні файли. Маска визначає режим доступу для файлів, яких ще не існує. Виконайте chmod -R для каталогу — і наступний файл, який запише сервіс, знову матиме старий режим, оскільки цей режим задає процес, що створює файл. Зміна режиму каталогу на нього не впливає.
Є також часовий проміжок. Від моменту створення файла до виконання chmod файл зберігається на диску з ширшим режимом доступу, і будь-який процес, що може читати каталог, може його відкрити. Для приватного ключа або архіву резервної копії саме цей проміжок створює ризик, якого ви намагалися позбутися.
Натомість задавайте режим під час створення. install -m u=rw,go= newfile /etc/app/newfile записує цільовий об’єкт із явно вказаним режимом, а mkdir -m робить те саме для каталогу. Обидві команди використовують указаний вами режим і ігнорують маску. ssh-keygen задає режим для приватного ключа, який записує, тому саме цей файл часто має правильні права на машині, де решта файлів — ні.
Найчастіше проблема виникає з SSH. Об’єкт ~/.ssh, створений звичайною командою mkdir, або об’єкт authorized_keys, дописаний за допомогою cat >>, отримує маску вашої оболонки. Якщо ввімкнено StrictModes, sshd відмовляється читати файл ключа з каталогу, доступного для запису групою. Клієнт отримує повідомлення Permission denied (publickey), а сервер у /var/log/auth.log записує справжню причину:
Authentication refused: bad ownership or modes for directory /home/deploy/.sshЦя перевірка навмисна, і посилення захисту SSH на VPS залежить від того, що вона працює. Перевірте маску на новому сервері до створення облікових записів, які ним користуватимуться, разом із першими десятьма хвилинами на новому VPS, а потім перевірте її ще раз через кожен спосіб запуску, який використовуватимуть ці облікові записи. Маска належить кожному процесу, а не серверу, тому одне значення не є показовим для всіх облікових записів.
Копіювання та архіви ігнорують mask
cp -p і rsync -a відновлюють mode, записаний для вихідного файлу, тому mask не впливає на результат. tar робить те саме, коли розпаковує файли від імені root або звичайного користувача з -p. Файл, відновлений із backup, зберігає mode, який він мав під час створення backup. Перевірте це, перш ніж робити висновок, що правильний mask ігнорують: під час відновлення даних його взагалі не перевіряли. Ще один випадок, коли правильний mask не враховується, — default ACL для батьківського каталогу. Її можна переглянути за допомогою getfacl -d для цього каталогу.
FAQ
Чому cron створює файли з режимом, відмінним від режиму в моєму сеансі ssh?
Завдання cron не читає ні /etc/profile, ні ~/.profile, тому маска, задана у файлі запуску shell, до нього не потрапляє. У Debian cron відкриває сеанс PAM через common-session-noninteractive, до якого входить pam_umask, тому завдання отримує значення PAM. Якщо у стеку PAM для cron немає pam_umask, завдання успадковує маску демона cron. Додайте явний umask у перший рядок скрипту, до створення будь-яких об’єктів, і один раз виведіть маску з самого завдання. Так ви побачите фактичну маску цього завдання, а не маску власного shell.
Чому в /etc/login.defs зазначено одне значення, а shell виводить інше?
UMASK у /etc/login.defs — лише резервне значення для pam_umask. Модуль спочатку використовує запис umask= у полі GECOS користувача, потім аргумент umask= у рядку pam_umask.so у /etc/pam.d/. Поведінка usergroups, увімкнена аргументом модуля usergroups або, у збірках із відповідним патчем, параметром USERGROUPS_ENAB, змінює цифру групи для будь-якого облікового запису, крім root, якщо його первинна група має таке саме ім’я. Виконайте grep -rn pam_umask /etc/pam.d/ і id -un; id -gn, щоб визначити, яке з цих правил застосовується до вашого облікового запису.
Чи може umask зробити файл виконуваним?
Ні. Маска може лише очистити біти з режиму, який запитала програма, що створює файл. touch ніколи не запитує біт виконання, тому жодна маска не створить виконуваний файл. Перевірте це в тимчасовому каталозі за допомогою ( umask a=rwx; touch f; stat -c '%a %A' f ). Щоб додати біт виконання, потрібен chmod або програма, наприклад install -m, яка запитує цей біт під час створення.
Де задати umask для сервісу systemd?
У unit-файлі, за допомогою UMask= у секції [Service]. Сервіс запускає менеджер сервісів, а не login-сеанс, тому файли запуску shell не читаються і pam_umask для нього не виконується. Після systemctl daemon-reload і перезапуску unit-файлу перевірте результат ззовні: дозвольте сервісу створити файл, а потім прочитайте результат за допомогою stat -c '%a %n'.
Чи безпечна маска за замовчуванням із дозволом на запис для групи?
Це безпечно, якщо група має рівно одного учасника, що є припущенням схеми приватних груп користувачів. Додайте до цієї групи другий обліковий запис — і кожен файл, створений першим обліковим записом, одразу стане доступним для запису новому учаснику без виконання команди над цими файлами. Виконайте id -un і id -gn: однакове виведене ім’я означає, що використовується приватна група. Якщо одна група спільно використовується кількома обліковими записами, задайте маску, яка очищає біт запису для групи, потім створіть файл і прочитайте stat -c '%a %n', щоб підтвердити застосування зміни.