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 IAM | Dans Samba | Quand |
|---|---|---|
Comptes de ou=users | Comptes 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=groups | Groupes de OU=Groupes, avec leurs membres et leur description | Idem |
| Compte verrouillé, ou retiré de l’annuaire | Compte 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 Desk | Nouveau mot de passe installé | Au moment de la réinitialisation |
Mot de passe changé par ldappasswd ou écrit directement dans l’annuaire | Non 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é dansOU=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=Agentset les groupes deOU=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.
- il crée les comptes de
- Mots de passe : le service
open-iam-samba-mdpdu serveur des outils les installe, avec le comptesvc-oiam-mdp. Ce compte a le seul droit de réinitialiser les mots de passe deOU=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 groupeopen-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_maxmots de passe faux, un compte est verrouillé pendantverrouillage_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=Agentsdans un groupe privilégié du domaine (Domain Admins,Administrators…). Le comptesvc-oiam-mdppeut réinitialiser tout compte deOU=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 deOU=Agents, par exemple dansCN=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’appelledc(hostnamectl set-hostname dc). Dans l’assistant, déclarez-la sous un nom qui commence de même, par exempledc.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
-
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.
-
Composants : cochez Postes Windows (Samba AD). L’assistant refuse ce choix en « Tout sur cette machine ».
-
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.
- il a au moins trois parties, et ce qui suit le nom court est le domaine Active Directory
(
-
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.
-
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 listliste les comptes recopiés.userAccountControl: 512désigne un compte actif, et514un 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.
- Les postes Windows trouvent le domaine par le DNS. Le contrôleur sert la zone
ad.exemple.fret ne résout rien d’autre. Déléguez doncad.exemple.frau contrôleur dans votre DNS (enregistrementNSet son adresse), plutôt que d’en faire le DNS des postes. - Sur le poste (Windows Pro ou Entreprise), joignez le domaine
ad.exemple.fravec le compteEXEMPLE\Administrator, puis redémarrez. - 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
- 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 ».
- « 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).
- « 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=1sur 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
/procet/sysde l’hôte. En production, préférez une machine virtuelle.
- Le serveur est un conteneur LXC sans imbrication, et systemd ne peut pas isoler les
services (
- 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 deopen-iam-lsc-samba.servicedonne la cause. Le plus souvent, le contrôleur ne joint pasannuaire.exemple.frsur 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.
- 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 warningChaque 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é.
-
- Un mot de passe changé par un administrateur n’ouvre pas Windows.
- Le mot de passe a été changé par
ldappasswdou 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.
- Le mot de passe a été changé par