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 œ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.

BesoinComposantLotMoment conseillé
Annuaire central, politique de mots de passe, sauvegardesAnnuaire OpenLDAP, Sauvegardes chiffrées (toujours installés)1Première installation
Changement de mot de passe en libre-service, annuaire consultable, outil du supportSelf Service Password, White Pages, Service Desk1Première installation
Tableaux de bord, journaux centralisés, alertes par e-mailSupervision1Première installation
Authentification unique des applications web, double authentificationLemonLDAP::NG2Première installation, ou évolution
Reprise des comptes d’un ou plusieurs Active DirectorySynchronisation Active Directory (LSC)3Évolution, une fois le socle validé
Ouverture de session sur les postes et serveurs LinuxPostes Linux (SSSD)4Première installation, ou évolution
Ouverture de session sur les postes WindowsPostes Windows (Samba AD)4Premiè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

  1. Choisissez le mode et la topologie :

    SituationChoix
    Cas généralPaquets 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 WindowsPaquets natifs, un seul serveur qui porte tous les rôles (« Plusieurs serveurs » avec un seul serveur, depuis le poste)
    Aucun poste Linux équipé d’AnsibleInstalleur en root sur le serveur : Installer sur le serveur lui-même
    Appliance Docker ComposeLot 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 OrchestraPaquets 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
  2. 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.

  3. Dimensionnez avec les estimations de l’écran Composants, qui additionne les besoins de chaque serveur :

    ComposantMémoireDisque
    Annuaire OpenLDAP512 Mo5 Go
    Synchronisation AD (LSC, Java)512 Mo1 Go
    Self Service Password, White Pages, Service Desk128 Mo chacun1 Go chacun
    LemonLDAP::NG512 Mo2 Go
    Supervision1,5 Go20 Go
    Contrôleur Samba1 Go5 Go

    Comptez au moins 2 processeurs, 4 Go de mémoire et 20 Go libres sur /var par serveur. Voici une répartition courante pour quelques centaines de comptes :

    ServeurRô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 root ou avec un compte qui a sudo sans 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 :

DeVersPortQuand
Machine de l’installeurChaque serveur et chaque poste Linux22Toujours
Serveursdeb.debian.org ou archive.ubuntu.com, ltb-project.org443Toujours
Serveursapt.grafana.com, lemonldap-ng.org, lsc-project.org, download.docker.com443Selon les composants (supervision, SSO, synchronisation AD) et le mode (Compose)
ServeursRelais SMTP de l’organisation25, 465 ou 587Avec la messagerie
UtilisateursServeur des outils et du SSO443Toujours
Postes LinuxServeur de l’annuaire636Postes Linux
Serveur de l’annuaire, et machine de l’installeurContrôleurs de l’Active Directory636Migration AD
Postes WindowsContrôleur Sambavoir le guide du contrôleurPostes Windows
Serveur des outilsContrôleur Samba636Postes Windows : propagation des mots de passe
Contrôleur SambaServeur de l’annuaire636Postes Windows : recopie des comptes
Machine de l’installeurXen Orchestra443Serveurs créés par l’installeur
Machine de l’installeurregistry.opentofu.org, github.com443Serveurs 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’assistantRemarque
Nom de l’organisation, domaine, base de l’annuaireOrganisationDé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 nomsSé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’envoiMessagerieLe mot de passe du compte d’envoi est redemandé à chaque évolution
Premier administrateur : identité, e-mailComptes
Destinataires des alertesSupervision et télémétrie
Applications à raccorder au SSO (OIDC, SAML, CAS)Paramètres — LemonLDAP::NGDéclarables seulement à l’ajout de LemonLDAP::NG ; ensuite, par son Manager
Pour chaque AD : adresse ldaps://, base, compte de lecture, chaîne de certificats PEMParamè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 sudoParamè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 machinesLe 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, DNSMode 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

  1. Contrôlez l’annuaire avec ldapwhoami, comme à l’étape 8 du tutoriel, puis ouvrez chaque service listé par l’écran de fin.
  2. 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.
  3. Déclarez les noms des services dans votre DNS.
  4. Avec l’autorité interne, distribuez son certificat aux postes : Faire confiance à l’autorité interne.
  5. 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 :

  1. 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).
  2. 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.
  3. Postes Linux : Joindre des postes Linux à l’annuaire. Commencez par un poste pilote.
  4. 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âcheFréquenceComment
Vérifier les sauvegardesChaque semaineLa 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’annuaireEn cas de perte de donnéesRestaurer une sauvegarde
Mettre à jour les composantsChaque 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 fourniAvant son expirationObtenir et installer un certificat
Enrôler ou retirer un poste LinuxAu fil de l’eauJoindre des postes Linux à l’annuaire
Suivre les alertesEn continuGrafana 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-iam et 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).

Voir aussi