Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

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 sudo et 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 par pam_localuser, placé avant pam_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) ;
  • sudo compare les groupes par numéro (match_group_by_gid). Un groupe sudo de l’annuaire ne donne donc pas les droits du groupe sudo du poste ;
  • la synchronisation Active Directory n’importe pas un agent ou un groupe qui porte un nom réservé. La ligne OIAM collision du 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ègle Match Group de 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 root ou avec un compte qui a sudo sans mot de passe. Déposez la clé publique de l’installeur dans ~/.ssh/authorized_keys de 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/hosts du 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 ».

Choisir les réglages

Cochez Postes Linux (SSSD) à l’écran Composants. L’étape Paramètres — Postes Linux propose les réglages suivants.

RéglagePar défautÀ savoir
Groupes autorisésopeniam-adminsAu 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 sudoAucunChoisi 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 ligne30 joursDé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 passeDésactivéeDé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

  1. À 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.
  2. 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.
  3. Aucun poste n’est obligatoire. Vous pouvez continuer sans poste et les joindre plus tard.
  4. 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.
  5. L’écran de fin liste les postes joints et rappelle la commande de contrôle (section suivante).

Joindre d’autres postes plus tard

  1. Relancez l’installeur comme pour faire évoluer l’installation.
  2. Sur « Faire évoluer l’installation », la carte Enrôler des postes Linux liste les postes déjà joints. Cliquez « Enrôler des postes ».
  3. 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.
  4. 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

  1. Relancez l’installeur, puis, sur « Faire évoluer l’installation », cliquez « Enrôler des postes » dans la carte Enrôler des postes Linux.
  2. 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.
  3. 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.
  4. Faites la vérification préalable, puis lancez. L’installeur joue clients.yml sur 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 ldapPublicKey et l’attribut sshPublicKey au compte, par exemple avec ldapmodify et 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.

  1. 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 sans sudo sans 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 ».
  2. getent passwd ne rend rien sur le poste.
    • Vérifiez d’abord que le poste joint l’annuaire :
      • getent hosts annuaire.exemple.fr doit rendre l’adresse de l’annuaire ;
      • openssl s_client -connect annuaire.exemple.fr:636 -verify_return_error </dev/null doit afficher Verify 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, uidNumber et gidNumber égaux et libres entre 10000 et 199999, homeDirectory /home/<uid>, loginShell /bin/bash.
  3. 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.dupont sur 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 no dans /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é.
  4. sudo refuse.
    • sudo -l ne 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 sudo doit 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.
  5. 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é.