Gestion des ACL

2005-11-07T12:38:01Z

FuraX : ajout de l'option --skip-base pour ne pas sauvegarder les droits std unix

[[Catégorie:Administration_système]]

Une '''ACL''', ou ''Access Control List'' (en anglais : Â« liste de contrôle d'accès Â») est, pour définir simplement la notion, une liste de [[Admin-admin env-permissions|permission]]s sur un fichier, un répertoire ou une arborescence, ajoutée aux permissions Â« classiques Â» (c'est-à-dire, techniquement, les permissions POSIX.1) de ce fichier. Ces permissions concernent des utilisateurs et/ou des groupes définis. La gestion des ACL sous GNU/Linux s'inspire de la norme POSIX 1003.1e (projet 17) mais ne la respecte pas entièrement.

Au moyen des ACL, on peut étendre le nombre d'utilisateurs et de groupes ayant des droits sur un même fichier. Rappelons que, dans le monde UNIX, chaque fichier ne peut normalement indiquer des permissions que pour ''un seul utilisateur'' et ''un seul groupe'', qui s'opposent à une unique catégorie correspondant à Â« tous les autres Â» (ou Â« le reste du monde Â»). Avec les ACL, on peut (entre autres) ajouter à un fichier d'autres utilisateurs et groupes et définir leurs droits séparément. On se rapproche ainsi du système de permissions pratiqué sur les plate-formes NT (de nombreuses différences subsistent, cependant).

Les ACL sont très utiles (voire indispensables) dans des environnements informatiques axés sur le travail collaboratif et mutualisé ; de même, leur utilisation avec [[Reseau-partfic-samba|SAMBA]] permet d'en étendre les capacités.

<cadre type="note">Dans les exemples qui suivent, les commandes peuvent être tapées en root ou en utilisateur normal, selon la portée des modificaitons : pour modifier les droits d'un fichier qui n'est pas possédé par un utilisateur ou pour ajouter des permissions à un autre utilisateur ou encore pour ajouter aux ACL un groupe dont l'utilisateur ne fait pas partie, il faut être root (pour les utilisateurs Ubuntu, il faut préfixer les commandes par [[sudo|<code>sudo</code>]]).</cadre>

==Exemple pratique==
Soit un fichier ''/var/www/index.php'' (page d'index d'un site web, par exemple) dont les droits sont les suivants :
<code>ls -l /var/www/index.php
-rw-r----- 1 root www-data 18 2005-09-11 11:24 /var/www/index.php</code>

En d'autres termes, root en est le propriétaire ; il peut le lire et le modifier ; le fichier est aussi accordé au groupe ''www-data'' (celui sous lequel, par exemple, tourne le [[Reseau-web-Apache PHP MySQL|serveur web]]), dont les membres peuvent le lire mais pas le modifier. Quant au reste du monde, il ne peut pas y accéder (le fichier contient des informations confidentielles telles qu'un mot de passe à une base de données [[Reseau-web-Apache PHP MySQL|MySQL]]).

Imaginons qu'on veuille rendre le fichier accessible en lecture aux utilisateurs jean et luce, en lecture et écriture à khadija et alice. On pourrait à la rigueur faire entrer jean et luce dans le groupe ''www-data'' mais cela introduirait une faille de sécurité car ''www-data'' peut aussi accéder à des données qui ne les concernent pas. Il n'est en tout cas rationnellement pas prudent d'ajouter khadija et alice au groupe ''root''. On ne peut non plus changer les permissions (les mettre en lecture et écriture pour tout le monde) ou modifier le propriétaire et le groupe.

Les ACL sont là une solution pratique et facile à gérer dans ce cas ; il suffit d'ajouter des permissions à l'ACL du fichier (grâce à des commandes décrites plus bas) pour qu'il se présente ainsi :
<code>root: rw-
www-data: r--
khadija: rw-
alice: rw-
jean: r--
luce: r--
reste du monde : ---
</code>

==Mise en place==
Selon la version du noyau utilisée, le support des ACL peut ou non être déjà compilé. S'il l'est, il faut aussi que la partition contenant les fichiers dont on veut étendre les droits soit montée avec l'option idoine.

===Noyau===
Il faut d'abord savoir si le noyau a été compilé avec le support des ACL. Le plus simple est de le vérifier dans le fichier de configuration du noyau, fichier normalement situé sous ''/boot''. Pour ce faire, utiliser la [[Admin-admin env-shell|commande <i>grep</i>]] :
<code>grep ACL /boot/config-version-du-noyau
</code>

Elle doit renvoyer la ligne suivante :
<code>CONFIG_FS_POSIX_ACL=y
</code>
pour signaler que le support général des ACL est présent, et plusieurs lignes du type
<code>CONFIG_SystèmeDeFichiers]_FS_POSIX_ACL=y
</code>
où ''[[système de fichiers|SystèmeDeFichiers]]'' peut recevoir les valeurs (pour un noyau 2.6.8-2-386 à la date de rédaction) ''EXT2'', ''EXT3'', ''JFS'' et ''XFS''. On peut aussi utiliser les ACL avec les systèmes de fichiers ''IBM JFS'', ''ReiserFS'', ''SGI XFS'' et ''NFS''. Leur implémentation peut nécessiter de patcher le noyau. Noter que les ACL ne sont pas possibles avec des systèmes de fichiers comme ''vfat'' qui ne gèrent aucun type de permissions.

Si la valeur des options n'est pas correcte, vous devez [[Rubrique : noyau et modules|recompiler votre noyau]]. N'oubliez pas de prévoir au moins un système de fichiers pour lequel les ACL seront permis.

===Systèmes de fichiers/montage des partitions===
Quand le noyau est disposé à gérer les ACL, on doit préparer les partitions montées dans un système de fichiers adapté (par exemple, il est exclu de vouloir utiliser ces permissions avec du ''vfat'').

====Montage et démontage à la volée====
Il faut monter les partitions voulues avec l'option ''acl''. Par exemple :
<code>mount -t ext3 -o defaults,acl /dev/hda2/ /var/www/
</code>
Si la partition est déjà montée, on peut modifier ses paramètres à la volée :
<code>mount -o remount,acl /var/www/
</code>

====Configuration automatique====
L'inscription dans ''[[Admin-admin fs-fstab|/etc/fstab]]'' des options de gestion des ACL est recommandée quand leur utilisation est régulière. Par exemple, notre même couple ''partition'' / ''point de montage'' serait déclaré ainsi :
<code>/dev/hda2 /var/www ext3 defaults,acl 0 0
</code>

À chaque montage automatique des partitions, le support des ACL sera activé.

==Commandes==
Il existe deux commandes essentielles : l'une pour manipuler l'ACL d'un fichier (''setfacl'') et l'autre pour la consulter (''getfacl''). Les commandes traditionnelles ''chmod'' et ''chown'' ne peuvent accéder aux ACL.

Ces deux commandes nécessitent, sous Debian (et distributions dérivées, comme Knoppix ou Ubuntu), l'installation du paquetage « acl ». Pour l'installer :
<code>[sudo] apt-get install acl
</code>
(ajout de <code>sudo</code> pour Ubuntu)

Pour les distributions à base de RedHat (donc aussi Fedora, Mandriva), il faut installer les paquetages <code>acl.*.rpm</code> et <code>libacl1.*.rpm</code> (leur nom contient leur numéro de version).

===setfacl===
Le nom de la commande se comprend ''set file's ACL'' (« régler l'ACL du fichier »). Elle possède de nombreuses options dont il convient de prendre connaissance en consultant la page de manuel (<code>man setfacl</code>). La commande fonctionne bien sûr aussi de manière récursive (option <code>-R</code>) :
<code>setfacl -Rm u:khadija:rw /var/www/
</code>
modifie l'ACL de tous les fichiers situés sous ''/var/www/'' en attribuant une permission de lecture et d'écriture à l'utilisateur khadija.

====Ajouter des permissions====
La syntaxe fondamentale est simple. La commande
<code>setfacl -m u:khadija:rw /var/www/index.php</code>
modifiera (<code>-m</code>) l'ACL de ''/var/www/index.php'' en attribuant à l'utilisateur (préfixe <code>u:</code>) khadija les droits <code>rw</code> et en lui refusant le droit d'exécution (qui n'a pas été mentionné dans la commande).

Les principaux paramètres à connaître sont :
* '''préfixes :'''
** <code>u:</code> (droits pour un '''u'''tilisateur, nommé ou désigné par son uid) ;
** <code>g:</code> (droits pour un '''g'''roupe, nommé ou désigné par son gid) ;
** <code>o:</code> (droits pour '''''o'''ther'', le reste du monde) ;
* '''permissions :''' elles sont codées dans l'ordre <code>r</code>, <code>w</code> et <code>x</code> ou <code>X</code> (ce dernier représentant, comme avec ''chmod'', le droit d'entrée dans les répertoires ou celui d'exécution pour les fichiers qui ont déjà un marqueur <code>x</code>). On les remplace par <code>-</code> pour une interdiction explicite. Ne pas mentionner un droit revient aussi à une interdiction : <code>setfacl -m u:khadija:w /var/www/index.php</code> et <code>setfacl -m u:khadija:-w- /var/www/index.php</code> reviennent au même.

On peut construire des commandes plus complexes en enchaînant les entrées dans l'ACL :
<code>setfacl -m u:khadija:rw,g:site1:r--,o:--- /var/www/index.php
</code>
définit des permissions dans l'ACL de ''/var/www/index.php'' pour l'utilisateur khadija, le groupe ''site1'' et le reste du monde.

Cette commande permet aussi de modifier les permissions classiques (et remplace dans ce cas ''chmod'') : l'utilisateur, le groupe et le reste du monde initiaux du fichier sont simplement désignés par le préfixe (<code>u:</code>, <code>g:</code>, <code>o:</code>) suivi d'un nom vide : si un fichier ''index.php'' appartient à luce:''www-data'' avec les droits <code>r--r-----</code>, pour donner à l'utilisateur et le groupe les droits en lecture et écriture il suffit d'une commande <code>setfacl -m u::rw,g::rw /var/www/index.php</code>. Si l'utilisateur et le groupe possèdent déjà un droit qui ne serait pas mentionné dans la commande ''setfacl'', ce droit sera annulé. Soit le fichier ''index.php'' avec les droits <code>rw-r-----</code> pour luce:''www-data''. La commande <code>setfacl -m u::r,g::x index.php</code> modifiera les droits à <code>r----x---</code> pour pour luce:''www-data''.

Noter qu'un fichier dont seules les permissions classiques ont été altérées par ''setfacl'' au lieu de ''chmod'' ne reçoit pas pour autant une ACL. De fait, il n'est pas référencé par <code>ls -l</code> comme fichier à ACL (marqueur <code>+</code> ; voir plus bas).

====Droits par défaut et héritage des droits étendus====
Les droits étendus d'un objet parent ne sont pas automatiquement hérités par les objets contenus. Par exemple, si un répertoire (root:''www-data'', <code>rwxr-x-r-x</code>) possède une ACL <code>u:luce:rwx</code>, un fichier créé à l'intérieur (ou déjà présent avant l'adjonction de l'ACL) ne reçoit pas cette ACL et ses droits sont ceux impliqués par l'<i>[[fstab|umask]]</i> défini.

On peut modifier ce comportement en ajoutant, '''aux répertoires seulement''', un attribut ''default'', codé <code>d:</code>, qui se transmet à tous les fichiers créés dans le répertoire après l'ajout de l'ACL par défaut. Par exemple, <code>setfacl -m d:u:luce:rwX /var/www</code> donne à luce les droits de lecture et écriture (ainsi qu'« exécution » quand il s'agit de répertoires) pour tous les fichiers qui seront créés sous ''/var/www'' à partir de ce moment, jusqu'à ce que cette ACL « par défaut » soit annulé ou remplacé.

====Retirer des permissions====
Pour annuler tout ou partie d'une ACL :
<code>setfacl -b /var/www/index.php
</code>
ôte tout le contenu de l'ACL du fichier, tandis que
<code>setfacl -x u:khadija,g:site1 /var/www/index.php
</code>
retire les permissions propres à khadija et au groupe ''site1''.

Les permissions ACL par défaut d'un répertoire (<code>d:</code>) s'annulent par <code>setfacl -k</code>.

====Le masque====
Le masque est une synthèse des valeurs les plus permissives que possède un fichier doté d'une ACL. Les droits de l'utilisateur fondamental ne sont cependant pas pris en compte. Le masque est calculé automatiquement :
<code>chown luce:www-data index.php
chmod 640 index.php
ls -l index.php
-rw-r----- 1 luce www-data 5055 2005-10-16 18:53 index.php
getfacl index.php
# file: index.php
# owner: luce
# group: www-data
user::rw-
group::r--
other::---</code>
Ce fichier n'a pas d'ACL donc pas de masque.

<code>setfacl -m u:jean:rw,g:web:rw index.php
getfacl index.php
# file: index.php
# owner: luce
# group: www-data
user::rw-
user:jean:rw-
group::r--
group:web:rw-
mask::rw-
other::---</code>

Maintenant que le fichier possède une ACL, il a reçu un masque : les permissions les plus élevées (utilisateur exclu) étant <code>rw</code>, c'est aussi la valeur du masque.

L'intérêt du masque est de pouvoir limiter d'un coup toutes les permissions d'un fichier (étendues ou non), sauf celles du propriétaire ; on utilise pour cela le préfixe <code>m:</code> suivi du droit maximal à accorder :
<code>getfacl index.php
# file: index.php
# owner: luce
# group: www-data
user::rw-
user:jean:rw-
group::r--
group:web:rw-
mask::rw-
other::---
setfacl -m m:r index.php
getfacl index.php
# file: index.php
# owner: luce
# group: www-data
user::rw-
user:jean:rw- #effective:r--
group::r--
group:web:rw- #effective:r--
mask::r--
other::---</code>

Les valeurs modifiées sont indiquées par le commentaire « ''effective:'' » suivi des permissions effectives après l'application du masque (ici, jean et ''web'' n'ont plus que le droit <code>r</code>, la situation reste la même pour ''www-data'').

<cadre type="note">L'existence même d'un masque renvoie au fonctionnement profond des ACL. Pour en comprendre l'utilité réelle sans se limiter à l'application pragmatique qui en est donnée ici, on se reportera à ''[http://www.suse.de/~agruen/acl/linux-acls/online/ POSIX Access Control Lists on Linux]''.</cadre>

===getfacl===
Cette commande suivie d'un nom de fichier affiche l'ACL de ce fichier (''get file's ACL'' « récupérer l'ACL du fichier »). Par exemple :
<code>getfacl /var/www
# file: var/www
# owner: root
# group: www-data
user::rwx
user:luce:rwx
group::rwx
mask::rwx
other::r-x
default:user::rwx
default:user:khadija:rwx
default:group::rwx
default:group:www-data:r-x
default:mask::rwx
default:other::r-x
</code>

On voit qu'outre les droits traditionnels attribués à root:''www-data'' (droits indiqués après <code>user::</code> et <code>group::</code>), sont aussi définis :
* des droits complets pour luce (<code>user:luce:rwx</code>) ;
* une permission ACL par défaut donnant des droits complets à khadija sur tous les nouveaux fichiers créés sous ''/var/www/'' (<code>default:user:khadija:rwx</code>) ;
* une autre permission ACL par défaut donnant des droits de lecture et d'exécution au groupe ''www-data'' sur les mêmes fichiers (<code>default:group:www-data:r-x</code>).

Noter que <code>user::</code>, <code>group::</code> et <code>other::</code> représentent le triplet ''utilisateur'' / ''groupe'' / ''reste du monde'' des permissions classiques. Appliquer cette commande sur un fichier qui n'a pas d'ACL définie donne les mêmes informations que <code>ls -l</code>, dans un format différent :
<code>setfacl -b index.php # retirer les ACL pouvant exister
ls -l index.php
-rw-r----- 1 root www-data 5055 2005-10-16 18:53 index.php
getfacl index.php
# file: index.php
# owner: root
# group: www-data
user::rw-
group::r--
other::---
</code>

===''ls'', ''cp'' et ''mv''===
Ces commandes doivent pouvoir lister, copier et déplacer les ACL en même temps que les fichiers. Pour les deux premières commande, il faut préciser explicitment que l'on veut afficher/conserver les droits (ce qui est aussi le cas quand on ne travaille que sur les droits classiques) : <code>ls -l</code>, <code>cp -a</code>. La commande ''mv'', quant à elle, préserve toujours les droits.

Quand les droits étendus ne peuvent être conservés (déplacement ou copie vers un système de fichier qui n'est pas configuré pour les recevoir ou utilisation d'une version de ''cp'' trop ancienne), un message d'avertissement en informe l'utilisateur. Par exemple :
<code>setfacl -m u:luce:rw index.php
cp -a index.php /mnt/vfat
cp: preserving permissions for `/mnt/vfat/index.php': Opération non supportée</code>

Noter qu'un fichier comportant une ACL qu'on veut lister par <code>ls -l</code> n'affiche qu'un <code>+</code> à la suite de ses permissions. Seule la commande ''getfacl'', pour l'instant, permet d'avoir connaissance du détail. Par exemple :
<code>setfacl -m u:khadija:rw /var/www/index.php
ls -l /var/www/index.php
-rw-rw----+ 1 khadija www-data 5055 2005-10-16 18:53 /var/www/index.php
</code>
Avec <code>-rw-rw----+</code>, on sait que le fichier possède une ACL (<code>+</code>), sans en connaître les constituants.

===Sauvegarde des données===
Sauvegarder des données dotées d'ACL nécessite :
* l'utilisation d'un système de fichiers pour le stockage qui soit compatible ;
* et l'utilisation d'un logiciel de sauvegarde qui soit tout autant compatible.
:À titre indicatif, ''tar'' et ''cpio'' et ''rsync'' ne le sont pas (à moins d'être patchés), ''star'' et ''pax'' le sont.

Pour contourner le problème de sauvegarde, il est possible d'écrire toutes les ACL dans un fichier qui servira de base à une restauration ultérieure : <code>getfacl --skip-base -R /dossier/dossier/ > fichier</code> récupère les informations récursivement et les inscrit dans un simple fichier. La restauration se fait au moyen de <code>setfacl --restore=fichier</code>. Il faut, pour qu'elle fonctionne, se placer à la racine contenant l'arborescence, en raison de la notation relative des chemins (d'où le message <code>Removing leading '/' from absolute path names</code> que l'on peut souvent lire en tapant des commandes avec ces programmes). Le chemin d'un répertoire ''/tmp/test'' est enregistré comme ''tmp/test'' : on doit donc, pour restaurer, lancer la commande depuis la racine de ''/tmp'', c'est-à-dire ''/''.

Par exemple : le répertoire ''/tmp/test'' contient trois fichiers à ACL. On sauvegarde les ACL avec <code>getfacl --skip-base -R /tmp/test > acl.acl</code>. Pour restaurer, on se place à la racine (<code>cd /</code>) et on lance <code>setfacl --restore=acl.acl</code>. Si on avait lancé la commande depuis ''/test'', ''setfacl'' aurait renvoyé les erreurs :
<code>setfacl: tmp/test: Aucun fichier ou répertoire de ce type
setfacl: tmp/test/a: Aucun fichier ou répertoire de ce type
setfacl: tmp/test/b: Aucun fichier ou répertoire de ce type
setfacl: tmp/test/c: Aucun fichier ou répertoire de ce type</code>

==Note concernant la syntaxe de ''setfacl''==
Les préfixes abrégés peuvent être développés et les permissions codées en octal (avec préfixe ''0'' optionnel). Ces trois commandes ont donc le même sens :
<code>setfacl -m d:u:luce:rw,g:www-data:r,o:- index.php
setfacl -m default:user:luce:6,group:www-data:4,other:0 index.php
setfacl -m default:user:luce:06,group:www-data:04,other:00 index.php</code>

----
<cadre type="note">
Tout au long de ce document, on a parlé de « permissions classiques » opposées à des « permissions étendues » qui leur seraient ajoutées. C'est une simplification : dans les faits, un système de fichiers monté avec le support des ACL change son appréhension globale des permissions, qui sont toutes des ACL, qu'elles soient minimales (utilisateur primaire, groupe primaire, reste du monde) ou étendues. Dans ce dernier cas, c'est la notion de groupe qui est redéfinie : tout utilisateur ou groupe ajouté à l'utilisateur primaire est enregistré avec ses droits dans une classe « groupe » étendue.

Cela explique la nécessité d'un masque : c'est la valeur limite réelle de la classe « groupe », que les entrées qu'elle contient ne peuvent dépasser. Un <code>ls -l</code> sur un fichier dont le masque ACL a été abaissé à <code>r--</code> alors que les droits du groupe primaire étaient auparavant <code>rw-</code> donnera : <code>-rw-r-----+</code> et non <code>-rw-rw----+</code>. Inversement, si l'on change par ''chmod'' les permissions du groupe principal, cela revient à changer le masque, donc les permissions de tous les utilisateurs et groupes ajoutés.
</cadre>

==Documents annexes==
* '''Articles de Léa : '''
** les [[permissions]] « classiques » POSIX.1 ;
** les [[attributs étendus]] des systèmes de fichiers ''ext2'' et ''ext3'' ;
* '''pages de manuel : '''
** <code>man acl</code> ;
** <code>man setfacl</code> ;
** <code>man getfacl</code>.
* '''sites externes : '''
** [http://www.linuxplusvalue.be/mylpv.php?id=153 Les ACL POSIX] ;
** [http://www.linuxfrench.net/article.php3?id_article=1463 Comment fonctionnent les ACL POSIX sous GNU/Linux] ;
** [http://www.suse.de/~agruen/acl/linux-acls/online/ POSIX Access Control Lists on Linux] (anglais).

{{Copy|27.10.05|Vincent Ramos|FDL}}

Lea Linux - Contributions [fr]

Gestion des ACL