Joindre des postes Linux à l’annuaire
Ce guide montre comment faire ouvrir une session sur des postes Linux avec les comptes de
l’annuaire. Vous y réservez cet accès à certains groupes, donnez sudo à un groupe et laissez les
portables travailler hors du réseau. Le composant « Postes Linux (SSSD) » se règle dans
l’assistant. Vous joignez les postes à l’installation, ou plus tard depuis « Faire évoluer
l’installation ». Comptez 10 minutes par poste, test compris.
Ce que l’installeur pose sur un poste
Sur chaque poste joint, l’installeur installe SSSD et le configure ainsi :
- SSSD lit les comptes dans l’annuaire en LDAPS, avec le certificat de l’autorité de
l’installation. Il utilise un compte de service propre au poste, en lecture seule
(
cn=poste-pc1.exemple.fr,ou=applications,dc=exemple,dc=fr) ; - seuls les membres des groupes autorisés ouvrent une session ;
- les règles
sudoet les clés SSH des utilisateurs viennent de l’annuaire ; - le répertoire personnel est créé à la première session ;
- un utilisateur déjà venu peut se reconnecter hors ligne pendant la durée du cache.
Un compte ou un groupe de l’annuaire ne prend jamais la place d’un compte ou d’un groupe local
du poste (root, sudo, admin, docker, le premier utilisateur créé à l’installation du
poste…). Le poste le garantit de plusieurs façons :
- SSSD ne sert pas les noms réservés (liste
ansible/noms-reserves.txt), ni les comptes et groupes locaux relevés à l’enrôlement. Les comptes locaux créés ensuite sont tenus parpam_localuser, placé avantpam_sss. Un mot de passe de l’annuaire n’ouvre donc jamais un compte local (SSH,su,sudo, console) ; - les clés SSH de l’annuaire ne sont rendues que pour le compte de l’annuaire (même numéro) ;
sudocompare les groupes par numéro (match_group_by_gid). Un groupesudode l’annuaire ne donne donc pas les droits du groupesudodu poste ;- la synchronisation Active Directory n’importe pas un agent ou un groupe qui porte un nom
réservé. La ligne
OIAM collisiondu journal de LSC et du rapport de simulation le signale ; - un groupe autorisé qui porte le nom d’un groupe local du poste (par exemple
docker) est filtré : SSSD ne le sert pas. Ses membres passent pourtant le filtre d’accès, qui interroge l’annuaire. La règleMatch Groupde sshd (connexion par mot de passe désactivée) ne les reconnaît pas, et sshd leur applique la règle du poste. Le mot de passe de l’annuaire resterait alors accepté en SSH. Le rôle refuse les noms réservés comme groupes autorisés. Ne choisissez pas non plus un nom de groupe local propre à vos postes ; - les numéros d’utilisateur de l’annuaire commencent à 10000 (
min_id) et le répertoire personnel est toujours/home/<nom>. Ni l’un ni l’autre ne vient de l’annuaire.
Un compte verrouillé dans l’annuaire (désactivé ou disparu de l’AD, ou verrouillé par le support) est refusé sur les postes, par clé SSH comme par mot de passe. Un poste hors ligne ne l’apprend qu’à son retour. Avec un cache hors ligne, le mot de passe déjà venu reste valable pendant la durée du cache.
Les comptes reçoivent leurs identifiants Unix (numéro à partir de 10000, /home/<uid>,
/bin/bash) dans l’annuaire, à l’installation, puis à chaque enrôlement de postes.
Préparer chaque poste
- Système : Debian 13 ou Ubuntu 26.04, avec Python 3 et l’accès aux dépôts de paquets de la distribution.
- Accès SSH depuis la machine où tourne l’installeur, en
rootou avec un compte qui asudosans mot de passe. Déposez la clé publique de l’installeur dans~/.ssh/authorized_keysde ce compte. L’assistant l’affiche à l’étape des postes et à l’étape « Mode et cibles ». C’est la même clé que pour les serveurs. - Réseau : le poste joint l’annuaire sur le port 636 et résout son nom (par exemple
annuaire.exemple.fr).- Si l’annuaire est déclaré par son adresse IP en « Plusieurs serveurs », l’installeur
inscrit cette adresse dans
/etc/hostsdu poste. - Sinon, votre DNS doit résoudre le nom. L’assistant l’annonce sous la clé de l’installeur : « Les postes résoudront annuaire.exemple.fr par leur DNS ».
- Si l’annuaire est déclaré par son adresse IP en « Plusieurs serveurs », l’installeur
inscrit cette adresse dans
Choisir les réglages
Cochez Postes Linux (SSSD) à l’écran Composants. L’étape Paramètres — Postes Linux propose les réglages suivants.
| Réglage | Par défaut | À savoir |
|---|---|---|
| Groupes autorisés | openiam-admins | Au moins un. Les autres comptes sont refusés sur les postes |
| Groupe à créer | — | Un nom de groupe ajouté à la volée (par exemple postes-linux) est créé par l’installation, avec le premier administrateur pour membre. Ajoutez-y les agents ensuite |
| Groupe sudo | Aucun | Choisi parmi les groupes autorisés. Ses membres lancent toute commande en root, avec leur mot de passe de l’annuaire. Le groupe est protégé comme openiam-admins : seuls les administrateurs en modifient les membres, et le support ne réinitialise pas leurs mots de passe. Avec la synchronisation Active Directory, ne choisissez pas un groupe importé d’un AD |
| Cache hors ligne | 30 jours | Désactivé, 7, 30 ou 90 jours. C’est la durée pendant laquelle un compte déjà connu se connecte sans joindre l’annuaire. Désactivé : le poste ne garde aucun mot de passe et ne sert plus les clés SSH quand SSSD se sait hors ligne, donc plus personne ne se connecte sans l’annuaire. SSSD comprendrait « 0 » comme « sans limite », alors l’installeur n’écrit aucune durée. SSSD ne passe hors ligne qu’à la première requête qui échoue. Tant qu’il n’a pas essayé de joindre l’annuaire, il garde sa dernière décision pendant la durée de ses caches internes (90 minutes pour les clés) |
| Connexion SSH par mot de passe | Désactivée | Désactivée, les membres des groupes autorisés se connectent en SSH par clé seulement, et les comptes locaux du poste gardent la règle du poste. Activée, les mots de passe de l’annuaire circulent jusqu’aux postes à chaque connexion SSH. Préférez les clés |
Ces réglages sont fixés à l’installation. Ensuite, vous ne pouvez plus qu’ajouter de nouveaux postes.
Joindre les postes à l’installation
- À l’étape des postes, cliquez « Ajouter un poste ». Indiquez le nom du poste (par exemple
pc1.exemple.fr), son adresse, le port SSH et l’utilisateur, puis enregistrez. - Cliquez « Tester » sur sa ligne, ou « Tout tester ». Le test est celui des serveurs : connexion avec la clé de l’installeur, droits, système, Python 3. « Continuer » reste refusé tant qu’un poste n’a pas réussi son test.
- Aucun poste n’est obligatoire. Vous pouvez continuer sans poste et les joindre plus tard.
- Le récapitulatif montre la carte « Postes Linux » et une ligne « pc1.exemple.fr (poste) » au plan d’exécution. L’installation configure d’abord les serveurs, puis les postes.
- L’écran de fin liste les postes joints et rappelle la commande de contrôle (section suivante).
Joindre d’autres postes plus tard
- Relancez l’installeur comme pour faire évoluer l’installation.
- Sur « Faire évoluer l’installation », la carte Enrôler des postes Linux liste les postes déjà joints. Cliquez « Enrôler des postes ».
- L’étape des postes s’ouvre :
- les réglages sont en lecture seule ;
- les postes déjà joints sont marqués « (déjà joint) ». Vous ne pouvez pas les modifier, mais vous pouvez les retirer (voir Retirer un poste) ;
- ajoutez les nouveaux postes et testez-les.
- Le récapitulatif annonce : « Seuls les nouveaux postes sont configurés : les serveurs et les postes déjà joints ne sont pas touchés ». Le plan d’exécution ne montre que l’annuaire et les nouveaux postes. Faites la vérification préalable, puis lancez.
L’enrôlement ne touche que les nouveaux postes :
- chacun reçoit son propre compte de service dans l’annuaire, avec un mot de passe qui n’existe que sur ce poste ;
- les postes déjà joints ne sont ni contactés ni modifiés, et ils peuvent être éteints ;
- les comptes créés depuis l’installation reçoivent leurs identifiants Unix au passage.
Retirer un poste
- Relancez l’installeur, puis, sur « Faire évoluer l’installation », cliquez « Enrôler des postes » dans la carte Enrôler des postes Linux.
- Dans le tableau des postes, cliquez la corbeille de la ligne du poste. L’assistant demande confirmation : « Retirer pc1.exemple.fr, déjà joint ? Au lancement, son compte de service sera supprimé de l’annuaire : le poste ne résoudra plus les comptes de l’annuaire, sauf les comptes déjà venus, hors ligne, pendant la durée du cache. Rien n’est modifié sur le poste lui-même. » Tant que vous n’avez rien lancé, redéclarer le poste à l’identique annule le retrait.
- Cliquez « Continuer ». Le récapitulatif montre la ligne « Poste retiré » et l’avertissement « Le poste retiré pc1.exemple.fr perd son compte de service ». Vous pouvez retirer et ajouter des postes dans le même passage.
- Faites la vérification préalable, puis lancez. L’installeur joue
clients.ymlsur le seul serveur de l’annuaire (phase « Comptes de service des postes »). Il supprime le compte du poste retiré et ne contacte aucun poste. Le poste retiré n’a pas besoin d’être allumé.
Une évolution qui rejoue l’installation des serveurs supprime aussi le compte d’un poste qui
n’est plus dans la liste. Sinon, un administrateur le supprime lui-même, par exemple avec
ldapdelete et le compte d’urgence :
cn=poste-pc1.exemple.fr,ou=applications,dc=exemple,dc=fr.
Les autres postes ne sont pas touchés. Sur le poste retiré :
- SSSD garde sa connexion ouverte à l’annuaire 15 minutes au plus. À la connexion suivante,
l’annuaire refuse le compte supprimé. Le poste ne lit plus rien : ni nouveau compte, ni
changement de groupe, ni règle
sudo; - les comptes qui s’y sont déjà connectés peuvent encore ouvrir une session hors ligne,
pendant la durée du cache. Pour couper aussi ces sessions, arrêtez SSSD sur le poste
(
systemctl disable --now sssd).
Donner une clé SSH aux utilisateurs
La connexion SSH par mot de passe est désactivée par défaut. Chaque utilisateur dépose donc sa clé publique SSH dans l’annuaire.
-
Avec Self Service Password : menu « Clé SSH » (
https://mdp.exemple.fr/?action=changesshkey). L’utilisateur saisit son identifiant, son mot de passe et sa clé publique. -
Sans Self Service Password : un administrateur ajoute la classe
ldapPublicKeyet l’attributsshPublicKeyau compte, par exemple avecldapmodifyet le compte d’urgence :dn: uid=jean.dupont,ou=users,dc=exemple,dc=fr changetype: modify add: objectClass objectClass: ldapPublicKey - add: sshPublicKey sshPublicKey: ssh-ed25519 AAAA… jean.dupont
Vérifier
Sur un poste joint, en root :
getent passwd jean.dupont
La commande rend la ligne du compte, par exemple
jean.dupont:*:10000:10000:Jean Dupont:/home/jean.dupont:/bin/bash. Si elle ne rend rien,
voyez En cas de problème.
Depuis la machine de l’utilisateur, avec sa clé :
ssh jean.dupont@pc1.exemple.fr id -un
La réponse est jean.dupont, et /home/jean.dupont existe désormais sur le poste.
Le poste se lie à l’annuaire avec son propre compte :
grep ldap_default_bind_dn /etc/sssd/sssd.conf
La ligne attendue est
ldap_default_bind_dn = cn=poste-pc1.exemple.fr,ou=applications,dc=exemple,dc=fr.
Si le compte est dans le groupe sudo, sur le poste :
sudo -l
sudo demande le mot de passe de l’annuaire, puis la liste se termine par (ALL) ALL.
sudo -n true (sans mot de passe) est refusé.
Un compte hors des groupes autorisés est refusé, même avec une clé déposée. Sur le poste, le journal l’explique :
journalctl -q | grep 'Access denied for user'
La ligne attendue est par exemple
pam_sss(sshd:account): Access denied for user marc.durand: 6 (Permission denied).
En cas de problème
Voici les cinq cas les plus probables, dans l’ordre où ils se présentent.
- Le test SSH du poste échoue (étape des postes).
- Le diagnostic dit quoi faire, comme pour un serveur. Les causes possibles sont la clé de
l’installeur absente de
authorized_keys, un utilisateur sanssudosans mot de passe, un système autre que Debian 13 ou Ubuntu 26.04, ou Python 3 absent. - Corrigez sur le poste, puis cliquez de nouveau « Tester ».
- Le diagnostic dit quoi faire, comme pour un serveur. Les causes possibles sont la clé de
l’installeur absente de
getent passwdne rend rien sur le poste.- Vérifiez d’abord que le poste joint l’annuaire :
getent hosts annuaire.exemple.frdoit rendre l’adresse de l’annuaire ;openssl s_client -connect annuaire.exemple.fr:636 -verify_return_error </dev/nulldoit afficherVerify return code: 0 (ok);- sinon, ouvrez le port 636 ou déclarez le nom dans votre DNS.
- Si le poste a été retiré de l’installation, son compte n’existe plus et il ne lit plus l’annuaire (voir Retirer un poste).
- Si l’annuaire répond, le compte n’a peut-être pas encore ses identifiants Unix. C’est le cas d’un compte créé après l’installation : il les reçoit au prochain passage de l’installation sur l’annuaire, ou au prochain enrôlement de postes.
- En attendant, un administrateur peut les ajouter : classe
posixAccount,uidNumberetgidNumberégaux et libres entre 10000 et 199999,homeDirectory/home/<uid>,loginShell/bin/bash.
- Vérifiez d’abord que le poste joint l’annuaire :
- La session SSH est refusée.
- Si le journal du poste montre
Access denied for user …, le compte n’est membre d’aucun groupe autorisé.- Ajoutez-le au groupe dans l’annuaire.
- Si l’ajout n’est pas pris en compte, videz le cache de SSSD sur le poste
(
sss_cache -E).
- Si le journal ne montre rien et que SSH répond
Permission denied (publickey), la clé de l’utilisateur manque.sss_ssh_authorizedkeys jean.dupontsur le poste liste les clés lues dans l’annuaire.- Une clé tout juste déposée apparaît après
sss_cache -u jean.dupont.
- Un mot de passe de l’annuaire est refusé en SSH tant que la connexion par mot de passe n’est
pas activée. Le poste le refuse lui-même pour les groupes autorisés (
PasswordAuthentication nodans/etc/ssh/sshd_config.d/00-open-iam-sssd.conf), et les comptes locaux gardent la règle du poste. - Un compte de l’annuaire qui porte le nom d’un compte local ne se connecte pas. C’est voulu (nom réservé ou homonyme local). Renommez le compte dans l’annuaire.
- Un compte verrouillé dans l’annuaire est refusé aussi par clé.
- Si le journal du poste montre
sudorefuse.sudo -lne montre pas(ALL) ALL:- le compte n’est pas dans le groupe sudo choisi à l’installation ;
- ou le cache de SSSD n’est pas à jour (
sss_cache -E).
- Sur Ubuntu 26.04,
update-alternatives --query sudodoit désigner/usr/bin/sudo.ws.sudo-rs, installé par défaut, ne lit pas les règles de l’annuaire. L’installeur fait ce choix, ne le changez pas.
- L’enrôlement depuis « Faire évoluer l’installation » échoue.
- Le cas le plus fréquent est un nouveau poste, réussi au test, devenu injoignable depuis. Les postes déjà joints n’y sont pour rien, car l’enrôlement ne les contacte pas.
- Le journal de l’exécution nomme le poste en échec. Allumez-le, puis cliquez « Relancer ».
Identifiants Unix et conteneurs sans privilège
Les plages d’identifiants de l’annuaire recoupent celles des postes. useradd donne à chaque
compte local 65 536 sous-identifiants (/etc/subuid, /etc/subgid) à partir de 100 000
(165 536 à 231 071 pour le deuxième compte local). Ils portent les processus et les fichiers des
conteneurs sans privilège (podman, Docker sans root). Les comptes importés de la première source
Active Directory (200 000 + RID) tombent dans ces plages. Un agent pourrait alors devenir
propriétaire des fichiers du conteneur d’un compte local. Sur les postes où des conteneurs sans
privilège tournent, ne laissez pas ces plages se recouper. Déplacez les sous-identifiants des
comptes locaux au-delà des numéros utilisés par l’annuaire (usermod --add-subuids, après avoir
retiré les plages par défaut), ou n’importez pas d’agents d’AD sur ces postes.
Identifiants Unix tirés du SID avec plusieurs domaines
Le numéro d’un compte ou d’un groupe importé vaut 200000 + (priorité de la source − 1) × 2^24 + RID. Cette formule suppose un seul domaine par source et des RID inférieurs à 2^24. Une source pointée sur un catalogue global, ou une base qui couvre CN=Builtin, mêle des SID de domaines différents aux mêmes RID. La synchronisation n’importe pas l’objet dont le SID n’est pas de la forme S-1-5-21-… ou dont le RID est trop grand, et écrit une ligne OIAM posix. Elle ne détecte pas deux domaines de même forme dans une même source. Dans ce cas, l’unicité de uidNumber sous ou=users et de gidNumber sous ou=groups fait échouer la seconde création, au lieu de donner le même numéro à deux personnes. Une source correspond à un domaine : ajoutez un autre domaine comme une seconde source, avec sa propre priorité.