Mettre en œuvre Open IAM (phase 1)
Ce guide accompagne le déploiement d’Open IAM dans une organisation, du choix des serveurs à l’exploitation courante. Il dit aussi ce que la phase 1 sait faire aujourd’hui. Chaque étape renvoie vers le tutoriel ou le guide qui la détaille.
Quand utiliser ce guide
Vous préparez un déploiement réel, en pilote ou en production. Il faut choisir les serveurs, réunir les informations de l’organisation et décider dans quel ordre ajouter les lots. Pour une première prise en main sur un serveur de test, suivez plutôt le tutoriel Première installation.
Pré-requis
- Savoir administrer des serveurs Linux, SSH et le DNS de l’organisation.
- Connaître les bases de LDAP (DN, groupes) et, pour une migration, avoir accès à l’Active Directory.
- Avoir lu le Périmètre de la phase 1, et en particulier ses limites connues.
Étape 1 : arrêter le périmètre
Partez des besoins de l’organisation. Chaque ligne indique le composant à cocher dans l’assistant.
| Besoin | Composant | Lot | Moment conseillé |
|---|---|---|---|
| Annuaire central, politique de mots de passe, sauvegardes | Annuaire OpenLDAP, Sauvegardes chiffrées (toujours installés) | 1 | Première installation |
| Changement de mot de passe en libre-service, annuaire consultable, outil du support | Self Service Password, White Pages, Service Desk | 1 | Première installation |
| Tableaux de bord, journaux centralisés, alertes par e-mail | Supervision | 1 | Première installation |
| Authentification unique des applications web, double authentification | LemonLDAP::NG | 2 | Première installation, ou évolution |
| Reprise des comptes d’un ou plusieurs Active Directory | Synchronisation Active Directory (LSC) | 3 | Évolution, une fois le socle validé |
| Ouverture de session sur les postes et serveurs Linux | Postes Linux (SSSD) | 4 | Première installation, ou évolution |
| Ouverture de session sur les postes Windows | Postes Windows (Samba AD) | 4 | Première installation de préférence (voir étape 2). En pilote, la jonction Windows n’est pas encore éprouvée |
Si vous migrez un Active Directory et que vous avez des postes Windows, installez le contrôleur Samba avant la bascule. Les mots de passe que les agents choisissent depuis les liens de la bascule sont alors enregistrés aussi dans Samba.
Étape 2 : choisir le mode, la topologie et les serveurs
-
Choisissez le mode et la topologie :
Situation Choix Cas général Paquets natifs, Plusieurs serveurs, installeur lancé depuis un poste Linux. C’est le seul choix qui accepte tous les lots, contrôleur Samba compris Petite structure, sans postes Windows Paquets natifs, un seul serveur qui porte tous les rôles (« Plusieurs serveurs » avec un seul serveur, depuis le poste) Aucun poste Linux équipé d’Ansible Installeur en root sur le serveur : Installer sur le serveur lui-même Appliance Docker Compose Lot 1 seulement. Un seul hôte, contrôleur Samba refusé, lots 2 à 4 non recettés dans ce mode Serveurs à créer sur un pool XCP-ng piloté par Xen Orchestra Paquets natifs, Plusieurs serveurs, depuis un poste : Créer les machines depuis l’installeur. L’installation complète sur une machine créée n’est pas encore recettée. L’état de la fonction est indiqué en tête du guide -
Déclarez de préférence tous les serveurs prévus dès la première installation. Une évolution ajoute des composants et attribue des rôles aux serveurs déjà déclarés. Depuis l’installeur 0.7.0, elle peut aussi ajouter un serveur pour un rôle qu’aucun serveur installé ne porte encore, par exemple le serveur dédié du contrôleur Samba, ajouté en même temps que « Postes Windows (Samba AD) ». Elle ne retire ni ne modifie jamais un serveur installé. Un rôle déjà porté ne se déplace pas, et chaque serveur porte au moins un rôle.
-
Dimensionnez avec les estimations de l’écran Composants, qui additionne les besoins de chaque serveur :
Composant Mémoire Disque Annuaire OpenLDAP 512 Mo 5 Go Synchronisation AD (LSC, Java) 512 Mo 1 Go Self Service Password, White Pages, Service Desk 128 Mo chacun 1 Go chacun LemonLDAP::NG 512 Mo 2 Go Supervision 1,5 Go 20 Go Contrôleur Samba 1 Go 5 Go Comptez au moins 2 processeurs, 4 Go de mémoire et 20 Go libres sur
/varpar serveur. Voici une répartition courante pour quelques centaines de comptes :Serveur Rôles srv-annuaireannuaire srv-servicesoutils, sso, supervision dc(postes Windows)samba, dès la première installation. Jamais sur le serveur de l’annuaire
Étape 3 : préparer les serveurs et le réseau
Pour chaque serveur et chaque poste Linux à joindre :
- Système : Debian 13 ou Ubuntu 26.04 fraîchement installé, avec
python3. - SSH : le serveur doit être joignable depuis la machine de l’installeur, en
rootou avec un compte qui asudosans mot de passe. Vous déposez la clé publique de l’installeur au moment de déclarer le serveur. - Conteneur LXC : activez « Imbrication » (
nesting=1), sinon le pare-feu ne démarre pas. - Contrôleur Samba : utilisez une machine virtuelle ou un conteneur privilégié avec imbrication.
Son nom système est le nom court du contrôleur (
hostnamectl set-hostname dc). - Serveurs créés par l’installeur sur XCP-ng : il n’y a rien à préparer sur les serveurs eux-mêmes. Il vous faut un jeton Xen Orchestra, un modèle cloud-init Debian 13 ou Ubuntu 26.04 sur le pool, un réseau, un stockage et une adresse fixe libre par serveur (voir Créer les machines depuis l’installeur).
Ouvrez ensuite les flux réseau :
| De | Vers | Port | Quand |
|---|---|---|---|
| Machine de l’installeur | Chaque serveur et chaque poste Linux | 22 | Toujours |
| Serveurs | deb.debian.org ou archive.ubuntu.com, ltb-project.org | 443 | Toujours |
| Serveurs | apt.grafana.com, lemonldap-ng.org, lsc-project.org, download.docker.com | 443 | Selon les composants (supervision, SSO, synchronisation AD) et le mode (Compose) |
| Serveurs | Relais SMTP de l’organisation | 25, 465 ou 587 | Avec la messagerie |
| Utilisateurs | Serveur des outils et du SSO | 443 | Toujours |
| Postes Linux | Serveur de l’annuaire | 636 | Postes Linux |
| Serveur de l’annuaire, et machine de l’installeur | Contrôleurs de l’Active Directory | 636 | Migration AD |
| Postes Windows | Contrôleur Samba | voir le guide du contrôleur | Postes Windows |
| Serveur des outils | Contrôleur Samba | 636 | Postes Windows : propagation des mots de passe |
| Contrôleur Samba | Serveur de l’annuaire | 636 | Postes Windows : recopie des comptes |
| Machine de l’installeur | Xen Orchestra | 443 | Serveurs créés par l’installeur |
| Machine de l’installeur | registry.opentofu.org, github.com | 443 | Serveurs créés par l’installeur : premier calcul de plan |
Le détail des ports ouverts par le pare-feu figure dans Ports réseau.
Étape 4 : réunir les informations de l’organisation
| Information | Écran de l’assistant | Remarque |
|---|---|---|
| Nom de l’organisation, domaine, base de l’annuaire | Organisation | Définitifs : une évolution ne les change pas |
Noms DNS des services (annuaire., mdp., pages., support., supervision., auth., admin-sso., dc.ad.) | Sécurité | À déclarer ensuite dans votre DNS |
| Certificats : autorité interne, ou chaîne et clé fournies par votre PKI couvrant tous les noms | Sécurité | Voir Obtenir et installer un certificat |
| Politique de mots de passe, exigence de la double authentification (tous, un groupe, facultative) | Sécurité | Lisez Avant d’ouvrir la 2FA |
| Relais SMTP joignable depuis les serveurs, expéditeur, compte d’envoi | Messagerie | Le mot de passe du compte d’envoi est redemandé à chaque évolution |
| Premier administrateur : identité, e-mail | Comptes | |
| Destinataires des alertes | Supervision et télémétrie | |
| Applications à raccorder au SSO (OIDC, SAML, CAS) | Paramètres — LemonLDAP::NG | Déclarables seulement à l’ajout de LemonLDAP::NG ; ensuite, par son Manager |
Pour chaque AD : adresse ldaps://, base, compte de lecture, chaîne de certificats PEM | Paramètres — Synchronisation Active Directory (LSC) | Voir l’étape 1 du tutoriel Migrer depuis Active Directory |
Postes Linux (nom, adresse, compte SSH), groupes autorisés, groupe sudo | Paramètres — Postes Linux (SSSD) | |
| Fournisseur : URL de Xen Orchestra, jeton d’accès, empreinte de son certificat ou autorité qui l’a signé | Mode et cibles — Fournisseurs de machines | Le jeton est effacé à « Terminer » et ne peut pas être ressaisi ensuite |
| Machine à créer : pool, modèle, réseau, stockage, taille, adresse et préfixe, passerelle, DNS | Mode et cibles — Nouvelle machine |
Étape 5 : obtenir l’installeur
La phase 1 n’a pas de release publiée. Construisez le binaire depuis le dépôt, sur une machine
qui a Rust stable et un compilateur C (build-essential). La feuille de style est fournie déjà
compilée. Vous n’avez besoin de Tailwind CSS que pour modifier les gabarits ou le style. Le
binaire embarque l’assistant et les rôles Ansible : c’est le seul fichier à copier.
cargo build --release -p open-iam-installer
install -D -m 755 target/release/open-iam-installer ~/.local/bin/open-iam-installer
open-iam-installer --version
La machine qui lancera l’installeur a aussi besoin d’ansible-core 2.16 ou plus
(pipx install ansible-core) et du client SSH. Pour que l’installeur crée les serveurs, ajoutez
OpenTofu 1.8 ou plus et openssl.
Étape 6 : installer le socle
Suivez le tutoriel Première installation avec vos serveurs, vos noms et les composants choisis aux étapes 1 et 2. Surveillez ces points :
- Lancez toujours l’installeur depuis la même machine et avec le même répertoire d’état
(
~/.local/state/open-iam, ou--etat). Eux seuls permettent les évolutions et les mises à jour. - Comparez l’empreinte SSH affichée par le test de chaque serveur avec celle du serveur.
- Si une exécution échoue sur Grafana (réponse 502), cliquez « Relancer ». La reprise est sans risque. La version actuelle de Grafana peut mettre plus de 25 secondes à démarrer.
Étape 7 : contrôler le socle et l’ouvrir aux utilisateurs
- Contrôlez l’annuaire avec
ldapwhoami, comme à l’étape 8 du tutoriel, puis ouvrez chaque service listé par l’écran de fin. - Rangez le fichier récapitulatif (
~/open-iam/) dans votre coffre. Il contient le mot de passe d’urgence, les comptes de service et la clé de déchiffrement des sauvegardes. Sauvegardez aussi le répertoire d’état de l’installeur, qui contient la clé de l’autorité interne. - Déclarez les noms des services dans votre DNS.
- Avec l’autorité interne, distribuez son certificat aux postes : Faire confiance à l’autorité interne.
- Avec la supervision, ouvrez Grafana (
supervision.<domaine>) et vérifiez que les tableaux de bord Open IAM (annuaire, système) sont alimentés.
Étape 8 : ajouter les lots suivants
Chaque ajout passe par Faire évoluer l’installation, dans cet ordre :
- SSO et 2FA : cochez LemonLDAP::NG, déclarez les applications, puis faites enrôler les administrateurs avant d’ouvrir le portail (Avant d’ouvrir la 2FA).
- Migration AD : suivez le tutoriel Migrer depuis Active Directory. Simulez et lisez le rapport avant d’importer. Laissez tourner la synchronisation pendant la transition. Ne basculez qu’une fois les postes Windows et les applications prêts.
- Postes Linux : Joindre des postes Linux à l’annuaire. Commencez par un poste pilote.
- Postes Windows, si le contrôleur n’a pas été installé d’emblée : Mettre en place le contrôleur Samba, avant la bascule AD le cas échéant. Joignez d’abord un poste pilote : la jonction n’est pas encore éprouvée par une recette.
Étape 9 : exploiter
| Tâche | Fréquence | Comment |
|---|---|---|
| Vérifier les sauvegardes | Chaque semaine | La supervision alerte quand aucune sauvegarde n’a réussi depuis 48 heures. Le test de restauration du dimanche n’alerte pas : lisez son résultat avec journalctl -u open-iam-test-restauration |
| Restaurer l’annuaire | En cas de perte de données | Restaurer une sauvegarde |
| Mettre à jour les composants | Chaque mois, et sur alerte de sécurité | « Mettre à jour les composants » dans Faire évoluer l’installation. Les correctifs de sécurité du système s’appliquent seuls |
| Renouveler un certificat fourni | Avant son expiration | Obtenir et installer un certificat |
| Enrôler ou retirer un poste Linux | Au fil de l’eau | Joindre des postes Linux à l’annuaire |
| Suivre les alertes | En continu | Grafana et e-mails des destinataires choisis |
Variantes
- Installeur en root sur le serveur : Installer sur le serveur lui-même.
Le répertoire d’état est
/var/lib/open-iamet le récapitulatif/root/open-iam/. - Certificats de votre PKI : chaque évolution redemande la chaîne et la clé, qui sont effacées à la fin de chaque exécution.
- Binaire signé : l’équipe du projet peut produire une archive signée Ed25519 avec son SBOM, la
liste de ses composants logiciels (
scripts/chaine-logicielle.sh release) et la vérifier (scripts/chaine-logicielle.sh verifier-release).