Chapitre 25. Création manuelle de profils NetworkManager au format keyfile
Par défaut, NetworkManager stocke les profils au format keyfile. Par exemple, l'utilitaire nmcli, le rôle de système RHEL network ou l'API nmstate pour gérer les profils utilisent ce format. Cependant, NetworkManager prend toujours en charge les profils au format ifcfg, qui est obsolète.
25.1. Format du fichier clé des profils NetworkManager
NetworkManager utilise le format INI pour stocker les profils de connexion sur le disque.
Exemple de profil de connexion Ethernet au format fichier clé :
[connection] id=example_connection uuid=82c6272d-1ff7-4d56-9c7c-0eb27c300029 type=ethernet autoconnect=true [ipv4] method=auto [ipv6] method=auto [ethernet] mac-address=00:53:00:8f:fa:66
Chaque section correspond à un nom de paramètre de NetworkManager tel que décrit dans les pages de manuel nm-settings(5) et nm-settings-keyfile(5). Chaque paire clé-valeur d'une section correspond à l'une des propriétés énumérées dans la spécification des paramètres de la page de manuel.
La plupart des variables des fichiers clés de NetworkManager ont une correspondance biunivoque. Cela signifie qu'une propriété du NetworkManager est stockée dans le fichier clé sous la forme d'une variable portant le même nom et ayant le même format. Il existe cependant des exceptions, principalement pour faciliter la lecture de la syntaxe du fichier clé. Pour une liste de ces exceptions, voir la page de manuel nm-settings-keyfile(5).
Pour des raisons de sécurité, étant donné que les profils de connexion peuvent contenir des informations sensibles, telles que des clés privées et des phrases de passe, NetworkManager n'utilise que des fichiers de configuration appartenant à root et qui ne peuvent être lus et écrits que par root.
En fonction de l'objectif du profil de connexion, enregistrez-le dans l'un des répertoires suivants :
-
/etc/NetworkManager/system-connections/: Emplacement des profils persistants. Si vous modifiez un profil persistant à l'aide de l'API NetworkManager, NetworkManager écrit et écrase les fichiers dans ce répertoire. -
/run/NetworkManager/system-connections/: Pour les profils temporaires qui sont automatiquement supprimés lorsque vous redémarrez le système. -
/usr/lib/NetworkManager/system-connections/: Pour les profils immuables pré-déployés. Lorsque vous modifiez un tel profil à l'aide de l'API de NetworkManager, NetworkManager copie ce profil dans le stockage persistant ou temporaire.
NetworkManager ne recharge pas automatiquement les profils à partir du disque. Lorsque vous créez ou mettez à jour un profil de connexion au format keyfile, utilisez la commande nmcli connection reload pour informer NetworkManager des changements.
