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

Mettre en place le contrôleur Samba pour les postes Windows

Guide pratique : donner aux postes Windows un domaine Active Directory alimenté par l’annuaire. Les agents y ouvrent une session avec leur identifiant et leur mot de passe Open IAM. Le composant « Postes Windows (Samba AD) » installe un contrôleur de domaine Samba AD sur un serveur dédié. Il y recopie les comptes et les groupes de l’annuaire, et il y propage chaque mot de passe changé dans Self Service Password ou réinitialisé dans Service Desk.

Ce qui est synchronisé, et ce qui ne l’est pas

L’annuaire Open IAM fait foi. Samba ne fait que recevoir.

Annuaire Open IAMDans SambaQuand
Comptes de ou=usersComptes de OU=Agents : sAMAccountName = uid, userPrincipalName = uid@ad.exemple.fr, prénom, nom, nom affiché, mailÀ l’installation, puis toutes les 15 minutes
Groupes de ou=groupsGroupes de OU=Groupes, avec leurs membres et leur descriptionIdem
Compte verrouillé, ou retiré de l’annuaireCompte désactivé, jamais suppriméIdem
Mot de passe changé dans Self Service Password (changement, « mot de passe oublié », liens de la bascule AD)Nouveau mot de passe installéAu moment du changement, en moins d’une seconde
Mot de passe réinitialisé dans Service DeskNouveau mot de passe installéAu moment de la réinitialisation
Mot de passe changé par ldappasswd ou écrit directement dans l’annuaireNon propagé—
Comptes de service (ou=applications)Non recopiés—

Deux conséquences à connaître :

  • Un compte recopié n’a pas encore de mot de passe dans Samba, donc aucune saisie ne l’ouvre. Il en reçoit un au premier changement dans Self Service Password ou à la première réinitialisation dans Service Desk. Pour un premier déploiement, demandez aux agents de changer leur mot de passe, ou réinitialisez-le depuis Service Desk.
  • Si LemonLDAP::NG est installé, son portail ne propose plus le changement de mot de passe, car il ne verrait pas passer le nouveau. Les utilisateurs passent par Self Service Password, déjà publié comme application du portail.

Dans Samba, l’ancien mot de passe est refusé dès le changement.

Comment la synchronisation fonctionne

La recopie des comptes et des groupes tourne sur le contrôleur. Le minuteur open-iam-lsc-samba.timer y lance LSC toutes les 15 minutes, et l’installation le lance aussi à chaque passage.

  • Lecture de l’annuaire : LSC se connecte en LDAPS avec le compte cn=lsc-samba,ou=applications,…. Ce compte lit les comptes, les groupes et leur verrouillage, et n’écrit rien dans l’annuaire. LSC vérifie le certificat de l’annuaire avec la seule autorité de l’installation.
  • Écriture dans Samba : LSC utilise svc-oiam-sync, un compte du domaine rangé dans OU=Services. Son mot de passe est tiré sur le contrôleur, dans /var/lib/samba/private/open-iam-sync.mdp (0400, root). Il ne passe ni par l’installeur ni par un autre serveur.
  • Droits de svc-oiam-sync :
    • il crée les comptes de OU=Agents et les groupes de OU=Groupes ;
    • il n’écrit que les attributs recopiés (voir le tableau ci-dessus) ;
    • il ne supprime rien et n’installe aucun mot de passe. Il n’écrit ni script de connexion, ni profil, ni répertoire personnel.
  • Mots de passe : le service open-iam-samba-mdp du serveur des outils les installe, avec le compte svc-oiam-mdp. Ce compte a le seul droit de réinitialiser les mots de passe de OU=Agents.

LSC ne tourne pas en root. Il a son propre utilisateur système, oiam-lsc-samba, sans shell. Il lit lsc.xml, qui reprend les deux mots de passe, ainsi que le magasin de confiance et l’autorité interne, dans /etc/lsc/vers-samba/. Il y accède par le groupe oiam-lsc-samba-secrets (0440, root). Le mot de passe de cn=lsc-samba (annuaire.mdp) et celui de svc-oiam-sync restent lisibles par root seul. Une faille de LSC ne donne donc plus root sur le contrôleur.

Certains noms sont sautés par la synchronisation. Un compte de l’annuaire n’est pas créé dans Samba si son uid est un nom réservé (ansible/noms-reserves.txt, administrator, guest, krbtgt, svc-oiam-*), ou s’il est déjà pris dans le domaine hors de OU=Agents. Le journal de open-iam-lsc-samba.service porte alors une ligne OIAM collision <uid>, et la synchronisation se termine sans erreur. Si l’annuaire est lu vide (droits changés, mauvaise base), la synchronisation échoue au lieu de désactiver tous les comptes.

Ce que la propagation vérifie

Le service open-iam-samba-mdp ne fait pas confiance à son client.

  • Qui l’appelle : seuls les pools PHP de Self Service Password (oiam-ssp) et de Service Desk (oiam-service-desk) ont accès au socket, par le groupe open-iam-samba-clients. Chaque outil web tourne sous son propre utilisateur, et White Pages n’a pas accès au socket. Le journal donne l’utilisateur du client ([client oiam-ssp uid=…]).
  • Le mot de passe reçu est d’abord essayé dans l’annuaire, par une liaison LDAPS au nom du compte. L’autorité interne vérifie le certificat. Si l’annuaire refuse le mot de passe, rien n’est changé dans Samba, et le journal dit … NON propagé vers Samba (mot de passe différent de l'annuaire).
  • Le verrouillage du domaine suit celui de l’annuaire. Après echecs_max mots de passe faux, un compte est verrouillé pendant verrouillage_minutes, dans l’annuaire comme dans Samba.

Sur l’hôte des outils, n’ajoutez pas de règle auditd qui journalise les arguments d’execve (-a always,exit -S execve). Le crochet de Self Service Password reçoit le mot de passe, codé en base64, dans ses arguments, et auditd l’écrirait sur le disque.

Ce que le guide demande aux exploitants

  • Aucun compte de OU=Agents dans un groupe privilégié du domaine (Domain Admins, Administrators…). Le compte svc-oiam-mdp peut réinitialiser tout compte de OU=Agents. Le support de Service Desk peut aussi changer le mot de passe d’annuaire d’un compte, et le service le propage. Administrez Samba avec des comptes créés hors de OU=Agents, par exemple dans CN=Users.
  • Samba ne reflète que le verrou permanent de l’annuaire. Il ignore l’expiration du mot de passe (pwdMaxAge), le « changer à la prochaine connexion » posé par Service Desk (pwdReset) et les verrous temporaires de l’annuaire. Samba a ses propres verrous temporaires (voir plus haut). Le mot de passe choisi par le support reste donc valable sans limite sur les postes Windows. Après une réinitialisation, faites changer le mot de passe par l’agent dans Self Service Password.

Préparer le serveur du contrôleur

  • Serveur dédié : Debian 13 ou Ubuntu 26.04, joint en SSH comme les autres serveurs de l’installation. Il ne porte jamais l’annuaire, car les deux servent LDAP et LDAPS.

  • Nom système : c’est le nom court du contrôleur. Pour le contrôleur dc.ad.exemple.fr, la machine s’appelle dc (hostnamectl set-hostname dc). Dans l’assistant, déclarez-la sous un nom qui commence de même, par exemple dc.exemple.fr.

  • Type de machine : une machine virtuelle, ou un conteneur privilégié. Dans un conteneur LXC non privilégié, la plage d’identifiants doit couvrir au moins 0 à 4 000 000, parce que Samba en attribue de 3 000 000 à 4 000 000.

  • Imbrication : un conteneur LXC en a besoin (« Imbrication », nesting=1). Sans elle, systemd ne peut pas isoler les services, et le pare-feu ne démarre pas. Proxmox l’active par défaut sur un conteneur non privilégié, pas sur un conteneur privilégié.

  • Réseau : le pare-feu installé ouvre les ports du contrôleur :

    • TCP 53, 88, 135, 389, 445, 464, 636, 3268, 3269 et 49152-49200 ;
    • UDP 53, 88, 389, 464.

    Trois flux doivent passer :

    • les postes Windows joignent ces ports ;
    • le serveur des outils joint le port 636 du contrôleur, pour y installer les mots de passe ;
    • le contrôleur joint l’annuaire sur le port 636 et résout son nom (par exemple annuaire.exemple.fr), puisque la synchronisation tourne sur le contrôleur.

Déclarer le contrôleur dans l’assistant

  1. Mode et cibles : choisissez « Plusieurs serveurs ». Ajoutez le serveur du contrôleur avec le seul rôle Contrôleur Samba (postes Windows), puis testez-le.

    • L’assistant refuse un serveur qui porte aussi l’annuaire.
    • Un seul serveur peut porter le contrôleur.
  2. Composants : cochez Postes Windows (Samba AD). L’assistant refuse ce choix en « Tout sur cette machine ».

  3. Sécurité : le champ Contrôleur Samba (postes Windows) propose dc.ad.<domaine>. Gardez ce nom, ou choisissez-en un autre qui respecte ces règles :

    • il a au moins trois parties, et ce qui suit le nom court est le domaine Active Directory (ad.exemple.fr), jamais le domaine de l’organisation ;
    • son nom court est celui du serveur déclaré.

    En certificats fournis, le certificat doit aussi couvrir ce nom.

  4. Récapitulatif : la carte « Postes Windows (Samba AD) » donne :

    • le contrôleur ;
    • le domaine Active Directory (ad.exemple.fr) ;
    • le royaume Kerberos (AD.EXEMPLE.FR) ;
    • le nom NetBIOS du domaine (EXEMPLE, tiré du domaine de l’organisation) ;
    • les avertissements sur les mots de passe non propagés.

    Le plan montre la phase « Contrôleur Samba » sur le seul serveur du contrôleur.

  5. Fin d’installation :

    • l’écran de fin rappelle le domaine à joindre ;
    • le fichier récapitulatif contient le mot de passe de EXEMPLE\Administrator, l’administrateur du domaine Samba. Conservez-le avec les autres secrets ;
    • les autres secrets du contrôleur ne restent que sur les serveurs, car le coffre chiffré de l’installeur est purgé à « Terminer ».

Vous pouvez aussi ajouter le contrôleur plus tard, par une évolution. Il faut alors l’installer sur un serveur déjà déclaré qui ne porte pas l’annuaire, car une évolution n’ajoute pas de serveur.

Vérifier

Depuis votre poste, avec le certificat de l’autorité téléchargé à la fin de l’installation (open-iam-ca.crt), et le nom du contrôleur résolu par votre DNS :

LDAPTLS_CACERT=open-iam-ca.crt ldapsearch -H ldaps://dc.ad.exemple.fr -x \
  -D jean.dupont@ad.exemple.fr -W \
  -b OU=Agents,DC=ad,DC=exemple,DC=fr '(sAMAccountName=jean.dupont)' sAMAccountName memberOf

Avec le mot de passe que jean.dupont a choisi dans Self Service Password, la recherche rend son compte et ses groupes. Elle vérifie à la fois le certificat LDAPS du contrôleur, la recopie du compte et la propagation de son mot de passe. Le contrôleur doit refuser l’ancien mot de passe (Invalid credentials (49)).

Sur le serveur du contrôleur, en root :

systemctl list-timers open-iam-lsc-samba.timer
systemctl start open-iam-lsc-samba.service
journalctl -u open-iam-lsc-samba.service --since '10 min ago' -o cat | grep -E 'All entries|ERROR'
  • La première commande montre la prochaine synchronisation.
  • La deuxième en lance une tout de suite.
  • La troisième en donne le bilan. Il compte trois lignes, pour les comptes, les groupes et la désactivation des comptes retirés, toutes terminées par errors: 0. Par exemple : samba-comptes - sync - All entries: 12, to modify entries: 0, successfully modified entries: 0, errors: 0.
samba-tool user list
samba-tool user show jean.dupont --attributes=userAccountControl
ls -l /var/lib/samba/private/open-iam-sync.mdp /etc/lsc/vers-samba/
  • samba-tool user list liste les comptes recopiés.
  • userAccountControl: 512 désigne un compte actif, et 514 un compte désactivé (verrouillé ou retiré de l’annuaire).
  • Les fichiers de mot de passe sont en -r--------, propriété de root.

Joindre un poste Windows

Aucune recette n’a encore éprouvé cette étape. Elle le sera avec un poste Windows 11.

  1. Les postes Windows trouvent le domaine par le DNS. Le contrôleur sert la zone ad.exemple.fr et ne résout rien d’autre. Déléguez donc ad.exemple.fr au contrôleur dans votre DNS (enregistrement NS et son adresse), plutôt que d’en faire le DNS des postes.
  2. Sur le poste (Windows Pro ou Entreprise), joignez le domaine ad.exemple.fr avec le compte EXEMPLE\Administrator, puis redémarrez.
  3. Un agent ouvre sa session avec EXEMPLE\<uid> ou <uid>@ad.exemple.fr, et le mot de passe choisi dans Self Service Password.

En cas de problème

  1. L’installation s’arrête sur « Le contrôleur Samba (…) veut un hôte dédié ».
    • Le message donne le nom attendu et le nom actuel de la machine.
    • Renommez la machine (hostnamectl set-hostname dc), puis cliquez « Relancer ».
  2. « Plage d’identifiants » en échec au test du serveur, ou « Plage d’identifiants trop courte » pendant l’installation.
    • Le serveur est un conteneur LXC non privilégié. Le test de l’étape « Mode et cibles » et la vérification du récapitulatif le signalent avant tout lancement.
    • Sous Proxmox, un conteneur ne change pas de type en place. Sauvegardez-le, puis restaurez-le en décochant « Conteneur non privilégié » (pct restore <id> <sauvegarde> --unprivileged 0 --force).
    • Vous pouvez aussi utiliser une machine virtuelle ou un conteneur privilégié, ou étendre lxc.idmap à au moins 4 000 000 identifiants depuis 0, puis relancer.
    • Un conteneur restauré en privilégié n’a pas forcément l’imbrication. Vérifiez-la avant de relancer (cas suivant).
  3. « Isolation des services » en échec au test du serveur, ou « Unable to start service nftables » pendant la phase Durcissement.
    • Le serveur est un conteneur LXC sans imbrication, et systemd ne peut pas isoler les services (journalctl -u nftables : « Failed to set up mount namespacing: Permission denied », 226/NAMESPACE).
    • Sous Proxmox, ouvrez Conteneur → Options → Fonctionnalités → « Imbrication », ou lancez pct set <id> --features nesting=1 sur l’hôte. Redémarrez ensuite le conteneur (pct reboot <id>) et relancez.
    • Proxmox prévient qu’avec un conteneur privilégié, l’imbrication expose au conteneur une partie de /proc et /sys de l’hôte. En production, préférez une machine virtuelle.
  4. Un agent ne peut pas ouvrir de session Windows.
    • Le plus souvent, son compte n’a pas encore de mot de passe dans Samba. Faites-le changer dans Self Service Password, ou réinitialisez-le dans Service Desk.
    • Si le compte manque dans Samba, il a été créé depuis moins de 15 minutes. Forcez la synchronisation sur le contrôleur : systemctl start open-iam-lsc-samba.service.
    • Si le bilan de la synchronisation (voir Vérifier) n’a pas ses trois lignes errors: 0, le journal de open-iam-lsc-samba.service donne la cause. Le plus souvent, le contrôleur ne joint pas annuaire.exemple.fr sur le port 636. Vérifiez sa résolution et le pare-feu entre les deux serveurs.
    • Si le compte est désactivé dans Samba, il est verrouillé ou supprimé dans l’annuaire.
  5. Self Service Password ou Service Desk avertit que le mot de passe n’est pas passé sur les postes Windows.
    • Les deux messages commencent par « Votre mot de passe est changé, mais pas encore sur les postes Windows » (Self Service Password) et « Mot de passe réinitialisé dans l’annuaire, mais pas sur les postes Windows (Samba) » (Service Desk).

    • Le changement est fait dans l’annuaire, pas dans Samba. Sur le serveur des outils :

      journalctl -t open-iam-samba-mdp -p warning
      

      Chaque ligne donne l’outil, l’identifiant et la raison (… NON propagé vers Samba (…)), sans mot de passe.

    • Rétablissez le contrôleur, puis réinitialisez le mot de passe dans Service Desk. Rien ne rattrape un changement de lui-même, parce que le mot de passe n’est connu qu’à l’instant du changement et n’est jamais conservé.

  6. Un mot de passe changé par un administrateur n’ouvre pas Windows.
    • Le mot de passe a été changé par ldappasswd ou par une écriture directe dans l’annuaire, deux chemins que Samba ne voit pas.
    • Réinitialisez-le dans Service Desk. C’est la procédure d’exploitation pour tout changement fait par un administrateur.