Jak działa umask w systemie Linux i jak ją sprawdzić
Wartość umask określa uprawnienia nowych plików poprzez usuwanie bitów z trybu bazowego. Sprawdź bieżące ustawienia poleceniem umask i zrozum różnice między root a użytkownikiem.
Działanie umask w systemie Linux
Wartość umask jest przypisana do każdego procesu w systemie Linux i określa uprawnienia każdego pliku oraz katalogu tworzonego przez ten proces. Program żąda od jądra systemu określonego zestawu uprawnień w momencie tworzenia obiektu. Jądro usuwa każdy bit wskazany przez maskę i stosuje pozostałe uprawnienia. Umask nigdy nie nadaje dostępu. Jedynie odbiera bity uprawnień, o które wnioskował program tworzący. Jądro przewiduje jeden wyjątek: jeśli katalog nadrzędny posiada domyślną listę ACL, maska jest ignorowana, a zamiast niej stosowana jest odziedziczona lista ACL.
Wartość ta nie jest właściwością dystrybucji. Zależy ona od używanego konta oraz sposobu uruchomienia powłoki. Te dwa parametry mogą różnić się na tej samej maszynie, w tym samym momencie, nawet w przypadku standardowego obrazu systemu. Dlatego pierwszym krokiem nie jest przeglądanie dokumentacji. Jest nim sprawdzenie wartości na serwerze, do którego uzyskano dostęp.
Wyświetlanie wartości umask w bieżącej powłoce
umask
umask -SPierwsza postać polecenia wyświetla maskę w formacie ósemkowym. Druga postać wyświetla tę samą maskę w formie symbolicznej, akceptowanej przez chmod. Pozostaw obie linie widoczne na ekranie. Wszystkie poniższe informacje stanowią porównanie z wartościami zwróconymi przez powłokę.
umask jest wbudowanym poleceniem powłoki, a nie plikiem wykonywalnym na dysku. Potwierdź to za pomocą type umask. Jest to istotne, ponieważ polecenie wbudowane modyfikuje proces samej powłoki. Osobny program mógłby zmienić jedynie własny proces, po czym zakończyć działanie, tracąc wprowadzone zmiany.
Utworzenie pliku i katalogu oraz odczyt ich trybów
cd "$(mktemp -d)"
touch probe.file
mkdir probe.dir
stat -c '%a %A %n' probe.file probe.dir%a wyświetla tryb w formacie ósemkowym, a %A wyświetla ten sam tryb w postaci drwxr-xr-x, której używa ls -l. Porównaj obie linie z maską wyświetloną przed chwilą. Każdy bit ustawiony w masce jest nieobecny w trybach, ponieważ wyzerowanie tych bitów jest jedyną funkcją maski. Jeśli kolumna %A nie jest jeszcze czytelna, ciąg uprawnień drwxr-xr-x jest elementem, który należy najpierw zrozumieć.
Plik i katalog różnią się od siebie, a maska nie jest przyczyną tej różnicy. touch żąda od jądra uprawnień do odczytu i zapisu dla właściciela, grupy oraz pozostałych użytkowników. mkdir żąda uprawnień do odczytu, zapisu i wykonywania dla wszystkich trzech kategorii. Ta sama maska jest odejmowana od dwóch różnych żądań. Dlatego plik utworzony przez touch nigdy nie jest wykonywalny, niezależnie od zawartości maski: bit wykonywania nigdy nie został zażądany, a maska nie może przywrócić bitu.
( umask a=rwx; touch open.file; stat -c '%a %A %n' open.file )Nawiasy uruchamiają polecenia w podpowłoce, więc zmiana kończy się wraz z nią. Maska nie żąda teraz wyzerowania żadnych uprawnień, a stat nadal raportuje brak bitu wykonywania dla pliku. Uruchom ponownie umask, aby przywrócić pierwotną wartość; pokazuje to, że ustawienie żyje wewnątrz procesu i jest dziedziczone przez procesy potomne, zamiast być przechowywanym na dysku.
W przypadku katalogów brak bitu wykonywania jest odczuwalny.
( umask a=rw; mkdir noexec.dir; cd noexec.dir )Dla zwykłego użytkownika polecenie cd kończy się błędem bash: cd: noexec.dir: Permission denied, ponieważ maska wyzerowała bit wykonywania, o który prosiło mkdir, a do katalogu bez bitu wykonywania nie można wejść. Użytkownik root pomija to sprawdzenie, więc ten efekt jest widoczny tylko na zwykłym koncie.
Dlaczego root i użytkownik końcowy widzą różne wartości umask
Uruchom ten sam pomiar na innym koncie, zainicjowanym w inny sposób, a następnie porównaj oba wyniki.
umask
sudo -i umasksudo -i uruchamia powłokę logowania użytkownika root i wykonuje w niej wbudowane polecenie, więc jest to inne konto, które korzysta z innej ścieżki inicjacji. W standardowych obrazach serwerowych Ubuntu i Debian obie linie mogą wyświetlać różne wartości. Obie wartości są poprawne. Każda z nich pokazuje wynik wygenerowany przez własną ścieżkę startową, a dalsza część tego wpisu wyjaśnia, która część systemu odpowiada za ten wynik.
Który plik w obrazie określa tę wartość
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'Jeśli pierwsze polecenie grep nie zwraca wyników, należy uruchomić je ponownie bez znacznika ^: linia może być zakomentowana, a zakomentowana linia stanowi dokumentację, a nie konfigurację. Trzecie polecenie grep jest tym, które często zaskakuje. W systemach Debian i Ubuntu dostarczany plik /etc/profile zazwyczaj wskazuje na PAM zamiast samodzielnie ustawiać maskę, więc plik, który uznano za odpowiedzialny, często nim nie jest. Polecenie grep kończy działanie z kodem wyjścia innym niż zero, gdy nie znajdzie dopasowania, dlatego ta linia kończy się ciągiem || echo: w obrazie, w którym żaden plik startowy nie wspomina o masce, wyświetlany jest komunikat zamiast braku danych, a ten komunikat stanowi wynik poszukiwań.
/etc/login.defs deklaruje wartość, a PAM stosuje inną
Linia UMASK w pliku /etc/login.defs to wartość najczęściej przytaczana w poradnikach. Ani jądro systemu, ani powłoka nie odczytują tego pliku. Odczytuje go pam_umask, moduł PAM (pluggable authentication modules), który uruchamia się podczas tworzenia sesji. pam_umask przyjmuje pierwszą znalezioną wartość: wpis umask= w polu GECOS użytkownika, następnie argument umask= zapisany w samej linii pam_umask.so, potem UMASK z pliku /etc/login.defs, a na końcu wpis UMASK= w /etc/default/login. Dystrybucje wprowadzają własne poprawki do tego modułu, dlatego należy uruchomić man pam_umask na własnym obrazie i sprawdzić wyświetloną tam kolejność.
W ten sposób /etc/login.defs może deklarować jedną wartość, podczas gdy sesja kończy się z inną, bez żadnego ostrzeżenia po obu stronach. Polecenia grep pozwalają ustalić, z którym przypadkiem mamy do czynienia. Jeśli linia pam_umask.so zawiera własny argument umask=, wartość z login.defs zostaje nadpisana.
USERGROUPS_ENAB oraz wyjątek dla root
id -un
id -gnJeśli oba polecenia zwracają tę samą nazwę, oznacza to użycie prywatnej grupy użytkownika: konto zostało utworzone z własną grupą o tej samej nazwie. Wartość USERGROUPS_ENAB w pliku /etc/login.defs sprawia, że useradd domyślnie tworzy taką grupę. Moduł pam_umask posiada odpowiadające zachowanie usergroups. W oryginalnym module jest ono włączane argumentem usergroups w linii pam_umask.so lub poprzez ustawienie domyślne podczas kompilacji, a nousergroups je wyłącza. System Ubuntu w 2011 roku zmodyfikował moduł tak, aby odczytywał USERGROUPS_ENAB, dlatego należy zapoznać się z komentarzem nad tą linią oraz plikiem man pam_umask we własnym obrazie systemu. Gdy to zachowanie jest aktywne, a konto nie jest kontem root i nazwa głównej grupy odpowiada nazwie użytkownika, moduł kopiuje cyfrę właściciela maski do cyfry grupy. Sesja kończy się z maską, która pozostawia uprawnienia grupy otwarte dla wszystkich obiektów tworzonych przez to konto. Użytkownik root jest wykluczony przez sam moduł i to wykluczenie jest najczęstszą przyczyną, dla której dwie powłoki na tym samym serwerze wyświetlają różne maski.
Uzasadnieniem tej reguły jest fakt, że prywatna grupa posiada dokładnie jednego członka, więc uprawnienie zapisu dla grupy oznacza to samo, co uprawnienie zapisu dla właściciela. Stan ten utrzymuje się do momentu dodania drugiego członka do grupy. Od tego momentu każdy plik utworzony przez to konto staje się zapisywalny dla nowego członka, bez konieczności wykonywania jakichkolwiek poleceń na tych plikach. Każdej usłudze należy przypisać własne konto użytkownika o minimalnych uprawnieniach, dzięki czemu grupa ta celowo pozostanie grupą jednoosobową.
Login shell, non-login shell oraz non-interactive shell
umask
bash -lc 'umask'
bash -c 'umask'Moduł PAM uruchamia się w momencie tworzenia sesji: login na konsoli, sshd, su, sudo -i. Nie uruchamia się on, gdy jedna powłoka wywołuje kolejną. bash -l jest powłoką typu login shell, więc odczytuje /etc/profile oraz ~/.profile, jednak nigdy nie wywołuje pam_umask, ponieważ sesja nie została utworzona. bash -c nie odczytuje żadnego z tych plików i dziedziczy maskę procesu, który ją uruchomił. Git hook oraz program uruchomiony przez menedżer usług należą do tego ostatniego przypadku, więc ich maska jest taka sama, jak maska procesu nadrzędnego. Cron również nie odczytuje plików startowych powłoki, ale w systemie Debian jego plik PAM zawiera common-session-noninteractive, który ładuje pam_umask, dzięki czemu każde zadanie otrzymuje wartość PAM, jaką uzyskałaby sesja.
Dlatego zgłoszenie „ustawiłem to w /etc/profile, a usługa nadal zapisuje pliki z błędnymi uprawnieniami” jest tak częste. Usługa nigdy nie odczytała tego pliku.
Gdzie wprowadzić ustawienia, aby były trwałe
Maskę należy ustawić w miejscu, w którym faktycznie uruchamiane jest zadanie, ponieważ każda ścieżka startowa odczytuje inny plik.
- Dla kont logujących się:
UMASKw/etc/login.defs, stosowane przez pam_umask do każdej sesji na maszynie. Jest to ustawienie globalne, więc wpływa na wszystkie konta jednocześnie. - Dla jednego konta: argument
umask=w liniipam_umask.sorównież ma zasięg globalny, dlatego wartość dla konkretnego użytkownika powinna znaleźć się w polu GECOS tego użytkownika lub w~/.profiledla powłok logowania oraz~/.bashrcdla powłok interaktywnych. - Dla demona zarządzanego przez systemd:
UMask=w sekcji[Service]jednostki. Jednostka jest uruchamiana przez menedżer usług, więc/etc/profilenigdy nie jest odczytywane, a pam_umask nie jest wywoływane. Plik jednostki jest jedynym z wymienionych, który ma wpływ na demona. - Dla skryptu uruchamianego przez cron lub hook: jawne
umaskw pierwszej linii, przed utworzeniem jakiegokolwiek obiektu przez skrypt.
[Service]
UMask=<the octal mask you chose>Następnie należy zweryfikować ustawienia po świeżym uruchomieniu danej ścieżki, a nie z poziomu powłoki, w której edytowano plik. Bieżąca powłoka posiada już własną maskę, a edycja pliku konfiguracyjnego nie wpływa na działający proces.
bash -lc 'umask'
sudo -i umaskDlaczego chmod po fakcie nie jest tym samym rozwiązaniem
chmod naprawia istniejące pliki. Maska decyduje o trybie plików, które jeszcze nie istnieją. Uruchomienie chmod -R na katalogu sprawia, że kolejny plik zapisany przez usługę ponownie otrzyma stary tryb, ponieważ pochodzi on z procesu tworzącego, a zmiana trybu katalogu nie ma na niego wpływu.
Istnieje również okno czasowe. Pomiędzy momentem utworzenia pliku a momentem uruchomienia chmod, plik znajduje się na dysku z szerszymi uprawnieniami i każdy proces, który może odczytać katalog, może go otworzyć. W przypadku klucza prywatnego lub archiwum kopii zapasowej, to okno stanowi ryzyko, które próbowano wyeliminować.
Zamiast tego należy ustawić tryb w momencie tworzenia. install -m u=rw,go= newfile /etc/app/newfile zapisuje plik docelowy z jawnym trybem, a mkdir -m robi to samo dla katalogu. Oba polecenia przyjmują wskazany tryb i ignorują maskę. ssh-keygen ustawia tryb na zapisywanym kluczu prywatnym, dlatego ten jeden plik jest często poprawny na maszynie, na której wszystko inne nie jest.
Typową ofiarą jest SSH. ~/.ssh utworzony za pomocą zwykłego mkdir lub authorized_keys dopisany za pomocą cat >>, przejmuje maskę powłoki. Przy włączonym StrictModes, sshd odmawia odczytu pliku klucza z katalogu, do którego grupa ma uprawnienia zapisu. Klient otrzymuje komunikat Permission denied (publickey), podczas gdy /var/log/auth.log serwera rejestruje rzeczywistą przyczynę:
Authentication refused: bad ownership or modes for directory /home/deploy/.sshTa kontrola jest celowa, a utwardzanie SSH na VPS zależy od jej zachowania. Zmierz maskę na nowym serwerze przed utworzeniem kont, które będą z niej korzystać, równolegle z pierwszymi dziesięcioma minutami na nowym VPS, a następnie zmierz ją ponownie dla każdej ścieżki, z której te konta będą startować. Maska przypisana jest do każdego procesu, a nie do serwera, więc pojedynczy odczyt nie rozstrzyga kwestii dla każdego konta.
Kopie i archiwa ignorują maskę
cp -p oraz rsync -a przywracają tryb zapisany w pliku źródłowym, więc maska nie wpływa na wynik. tar wykonuje to samo podczas wypakowywania jako root lub jako zwykły użytkownik z flagą -p. Plik przywrócony z kopii zapasowej zachowuje tryb, który posiadał w momencie tworzenia kopii. Należy to sprawdzić przed wysunięciem wniosku, że poprawna maska jest ignorowana: w przypadku przywracanych danych nie była ona nigdy brana pod uwagę. Innym miejscem, w którym poprawna maska przestaje mieć znaczenie, jest domyślna lista ACL na katalogu nadrzędnym, co wykazuje polecenie getfacl -d wykonane dla tego katalogu.
FAQ
Dlaczego zadanie cron tworzy pliki z innymi uprawnieniami niż sesja ssh?
Zadanie cron nie odczytuje ani /etc/profile, ani ~/.profile, więc maska ustawiona w pliku startowym powłoki nigdy do niego nie dociera. W systemie Debian cron otwiera sesję PAM poprzez common-session-noninteractive, która zawiera pam_umask, dzięki czemu zadanie otrzymuje wartość PAM. Jeśli stos PAM dla crona nie zawiera pam_umask, zadanie dziedziczy maskę demona cron. Należy umieścić jawne polecenie umask w pierwszej linii skryptu, przed utworzeniem jakichkolwiek plików, oraz wypisać maskę wewnątrz zadania, aby sprawdzić jej rzeczywistą wartość, a nie tę, która obowiązuje w powłoce użytkownika.
Dlaczego /etc/login.defs podaje jedną wartość, a powłoka wyświetla inną?
UMASK w /etc/login.defs stanowi jedynie rozwiązanie zastępcze dla pam_umask. Moduł preferuje wpis umask= w polu GECOS użytkownika, a następnie argument umask= w linii pam_umask.so w pliku /etc/pam.d/. Zachowanie usergroups, włączane argumentem usergroups modułu lub – w wersjach z odpowiednią łatką – przez USERGROUPS_ENAB, nadpisuje cyfrę grupy dla każdego konta innego niż root, którego główna grupa ma taką samą nazwę jak użytkownik. Należy wykonać grep -rn pam_umask /etc/pam.d/ oraz id -un; id -gn, aby sprawdzić, które z tych ustawień dotyczy danego konta.
Czy umask może nadać plikowi uprawnienia do wykonywania?
Nie. Maska może jedynie usuwać bity z uprawnień żądanych przez program tworzący plik. touch nigdy nie żąda bitu wykonywania, więc żadna maska nie utworzy pliku wykonywalnego. Można to zweryfikować w tymczasowym katalogu za pomocą ( umask a=rwx; touch f; stat -c '%a %A' f ). Aby uzyskać bit wykonywania, wymagane jest użycie chmod lub programu takiego jak install -m, który żąda tego bitu w momencie tworzenia pliku.
Gdzie ustawić umask dla usługi systemd?
W jednostce (unit), za pomocą dyrektywy UMask= w sekcji [Service]. Usługa jest uruchamiana przez menedżer usług, a nie przez logowanie, więc pliki startowe powłoki nie są odczytywane, a pam_umask nie jest wykonywany. Po wykonaniu systemctl daemon-reload i restarcie jednostki, należy sprawdzić wynik z zewnątrz: pozwolić usłudze utworzyć plik, a następnie odczytać wynik za pomocą stat -c '%a %n'.
Czy domyślna maska z uprawnieniem do zapisu dla grupy jest bezpieczna?
Jest bezpieczna, dopóki grupa ma dokładnie jednego członka, co stanowi założenie schematu prywatnych grup użytkowników. Dodanie drugiego konta do tej grupy sprawia, że każdy plik utworzony przez pierwsze konto staje się natychmiast zapisywalny dla nowego członka, bez konieczności wykonywania jakichkolwiek poleceń na tych plikach. Należy wykonać id -un oraz id -gn: wyświetlenie tej samej nazwy oznacza korzystanie z prywatnej grupy. W przypadku współdzielenia grupy między kontami należy ustawić maskę, która usuwa bit zapisu dla grupy, a następnie utworzyć plik i odczytać stat -c '%a %n', aby potwierdzić wprowadzenie zmian.