Introduction

o2Cloud User Manager est une application web professionnelle de création et gestion d'utilisateurs Active Directory. Elle offre une interface moderne et intuitive permettant aux administrateurs de créer des comptes utilisateurs AD de manière sécurisée et efficace.

Objectifs

Note : Cette documentation couvre l'installation, la configuration et l'utilisation de o2Cloud User Manager version 1.0. Pour toute question, contactez admin@o2cloud.fr

Prérequis

Serveur Web

Composant Version minimale Recommandation
PHP 8.0 8.1 ou supérieur
Extension PHP LDAP Requis php-ldap
Extension PHP OpenSSL Requis php-openssl
Composer 2.0 Dernière version
Serveur web - Apache 2.4 ou Nginx 1.18

Infrastructure Active Directory

Système d'exploitation

Compatible :
  • Windows Server 2012+ avec IIS ou Apache
  • Linux (Ubuntu 20.04+, Debian 11+, CentOS 8+, RHEL 8+)

Fonctionnalités

Interface utilisateur

Sécurité

Gestion des utilisateurs

Gestion des mots de passe

Logs & Audit

Installation

1Cloner le repository

Téléchargez les fichiers sources de o2Cloud User Manager :

git clone https://github.com/o2Cloud-fr/o2Cloud-User-Manager.git
cd o2Cloud-User-Manager
Astuce : Si vous avez acheté la licence, vous recevrez une archive ZIP contenant tous les fichiers. Extrayez-la dans le répertoire de votre serveur web.

2Installer les dépendances

o2Cloud User Manager utilise Composer pour gérer ses dépendances PHP :

composer install

Vérification des extensions PHP

Vérifiez que les extensions requises sont installées :

php -m | grep ldap
php -m | grep openssl

Installation des extensions manquantes

Ubuntu/Debian :
sudo apt-get update
sudo apt-get install php-ldap php-openssl php-mbstring
sudo systemctl restart apache2
CentOS/RHEL :
sudo yum install php-ldap php-openssl php-mbstring
sudo systemctl restart httpd
Windows/XAMPP :

Éditez C:\xampp\php\php.ini et décommentez :

extension=ldap
extension=openssl
extension=mbstring

Redémarrez Apache depuis le panneau de contrôle XAMPP.

3Configuration des certificats SSL (LDAPS)

Important : Cette étape est obligatoire pour créer des utilisateurs AD. LDAPS est requis pour définir les mots de passe.

Windows (XAMPP)

Étape 1 : Exporter le certificat CA depuis Active Directory

Sur le contrôleur de domaine Windows, ouvrez PowerShell en administrateur :

# Créer le dossier temporaire
New-Item -Path "C:\temp" -ItemType Directory -Force

# Exporter le certificat CA
$caName = "Votre-CA-Name"  # Ex: contoso-DC-CA
$cert = Get-ChildItem -Path "Cert:\LocalMachine\Root" | Where-Object {$_.Subject -match $caName}

if ($cert) {
    $base64 = [System.Convert]::ToBase64String($cert.RawData)
    $pem = "-----BEGIN CERTIFICATE-----`r`n"
    for ($i = 0; $i -lt $base64.Length; $i += 64) {
        $len = [Math]::Min(64, $base64.Length - $i)
        $pem += $base64.Substring($i, $len) + "`r`n"
    }
    $pem += "-----END CERTIFICATE-----`r`n"
    [System.IO.File]::WriteAllText("C:\temp\ca-cert.pem", $pem)
    Write-Host " Certificat exporté" -ForegroundColor Green
}

Étape 2 : Installer le certificat dans XAMPP/PHP

REM Créer le dossier de configuration OpenLDAP
mkdir C:\openldap\sysconf

REM Copier le certificat
copy C:\temp\ca-cert.pem C:\openldap\sysconf\cacert.pem

REM Créer le fichier de configuration
notepad C:\openldap\sysconf\ldap.conf

Contenu du fichier C:\openldap\sysconf\ldap.conf :

# Configuration OpenLDAP pour XAMPP
TLS_CACERT C:/openldap/sysconf/cacert.pem
TLS_REQCERT demand
TLS_PROTOCOL_MIN 3.1

Linux (Ubuntu/Debian)

# Copier le certificat CA
sudo mkdir -p /etc/ldap
sudo cp ca-cert.pem /etc/ldap/cacert.pem

# Créer le fichier de configuration
sudo nano /etc/ldap/ldap.conf

Contenu de /etc/ldap/ldap.conf :

TLS_CACERT /etc/ldap/cacert.pem
TLS_REQCERT demand

4Installation via l'interface web

Une fois le serveur web configuré, accédez à l'assistant d'installation :

https://users.exemple.com/install.php

Configuration Active Directory

Configuration de la sécurité

Configuration utilisateur

Test de connexion : L'assistant teste automatiquement la connexion AD avant de sauvegarder.

Compte de service Active Directory

Création du compte

Le compte de service est utilisé par l'application pour se connecter à AD et créer des utilisateurs.

Étapes de création

  1. Ouvrez Active Directory Users and Computers
  2. Naviguez vers l'OU Service Accounts
  3. Créez un nouveau compte utilisateur
  4. Configurez :
    • Le mot de passe n'expire jamais
    • L'utilisateur ne peut pas changer de mot de passe

Permissions requises

Permission Portée Usage
Read Base DN Rechercher et authentifier
Create User Objects OU utilisateurs Créer de nouveaux comptes
Write All Properties Objets utilisateurs Définir les attributs
Write Members Groupes Attribuer les groupes

Délégation de contrôle

Assistant de délégation

  1. Ouvrez Active Directory Users and Computers
  2. Clic droit sur l'OU des utilisateurs → Déléguer le contrôle
  3. Ajoutez le compte de service
  4. Sélectionnez "Create, delete, and manage user accounts"
  5. Terminez l'assistant

Permissions avancées pour les groupes

Pour chaque groupe que vous voulez attribuer :

  1. Clic droit sur le groupe → Propriétés → Sécurité
  2. Ajoutez le compte de service
  3. Cochez Write Members
Sécurité : N'accordez pas de droits d'administrateur de domaine. Le principe du moindre privilège s'applique.

Créer un utilisateur

Processus de création

  1. Connexion : Authentifiez-vous avec un compte membre du groupe admin
  2. Informations de base :
    • Prénom et nom (obligatoires)
    • Nom d'utilisateur (auto-généré ou personnalisé)
    • Email (validé automatiquement)
  3. Informations de contact :
    • Téléphone fixe et mobile (optionnels)
  4. Informations professionnelles :
    • Département, titre, société, bureau
    • Manager (recherche dynamique)
    • Numéro d'employé (si requis)
    • Description/notes
  5. Attribution de groupes :
    • Groupes par défaut (automatiques)
    • Groupes optionnels (sélection multiple)

Après la création

L'application affiche :

Mot de passe : Le mot de passe est généré automatiquement selon la politique configurée. L'utilisateur devra le changer à sa première connexion.

Attribution de groupes

Groupes par défaut

Ces groupes sont attribués automatiquement à tous les nouveaux utilisateurs :

Groupes optionnels

Ces groupes peuvent être sélectionnés lors de la création :

Conseil : Configurez des groupes par défaut pour les accès basiques (VPN, email) et des groupes optionnels pour les accès spécifiques (départements, projets).

LDAPS - Sécurité

Pourquoi LDAPS est obligatoire ?

Active Directory refuse de définir des mots de passe sur une connexion non chiffrée. Pour créer des utilisateurs avec mot de passe, vous devez utiliser :

CRITIQUE : Sans LDAPS configuré, vous pourrez vous connecter à AD mais PAS créer d'utilisateurs. L'erreur LDAP #53 "Server unwilling to perform" sera retournée.

Test de connexion LDAPS

# Test avec OpenSSL
openssl s_client -connect dc.contoso.com:636 -showcerts

# Test avec ldapsearch
ldapsearch -H ldaps://dc.contoso.com:636 \
  -D "CN=Service Account,OU=Service Accounts,DC=contoso,DC=com" \
  -W -b "DC=contoso,DC=com" "(objectClass=user)" cn

Logs & Audit

Types de logs

1. access.log

Enregistre toutes les connexions :

[2026-01-03 14:23:45] [192.168.1.100] Authentification réussie pour: admin@contoso.com
[2026-01-03 14:25:12] [192.168.1.101] Échec d'authentification pour: user@contoso.com

2. user_creation.log

Enregistre toutes les créations d'utilisateurs :

[2026-01-03 14:30:15] [192.168.1.100] Tentative de création pour: CN=Jean Dupont,OU=Users,DC=contoso,DC=com
[2026-01-03 14:30:16] [192.168.1.100] Utilisateur créé avec succès: jdupont
[2026-01-03 14:30:17] [192.168.1.100] Utilisateur ajouté au groupe: CN=All_Users,OU=Security,DC=contoso,DC=com

3. errors.log

Enregistre toutes les erreurs :

[2026-01-03 14:35:22] Impossible de se connecter au serveur LDAP: dc.contoso.com
[2026-01-03 14:36:45] Échec de création - Erreur LDAP #53: Server is unwilling to perform

Surveillance recommandée

Dépannage

Erreur #53 : Server unwilling to perform

Symptôme : Impossible de créer des utilisateurs, erreur LDAP #53

Cause

Active Directory refuse de définir le mot de passe car la connexion n'est pas chiffrée.

Solutions

  1. Vérifiez que LDAPS est activé dans la configuration :
    'ad' => [
        'port' => 636,
        'use_ssl' => true,  // Doit être true
    ]
  2. Vérifiez que le certificat CA est configuré (voir section Installation)
  3. Testez la connexion LDAPS avec openssl

Erreur #50 : Insufficient access rights

Cause

Le compte de service n'a pas les permissions nécessaires.

Solutions

  1. Vérifiez les permissions sur l'OU des utilisateurs
  2. Vérifiez la délégation de contrôle
  3. Vérifiez les permissions "Write Members" sur les groupes

Nom d'utilisateur déjà existant

Comportement automatique

L'application ajoute automatiquement un suffixe numérique :

Vous pouvez aussi personnaliser manuellement le nom d'utilisateur.

Page de diagnostic

Accédez à la page de diagnostic pour vérifier votre configuration :

https://users.exemple.com/diagnostic.php

Informations fournies

Sécurité : Protégez ou supprimez cette page en production car elle affiche des informations sensibles.

Checklist de déploiement

Pré-installation

Active Directory

Installation

Sécurité

Tests

Support & Contact

Support technique

Pour toute question ou problème technique.

admin@o2cloud.fr

Documentation

Documentation complète et README inclus.

Consulter la documentation

Installation pro

Installation clé en main par nos experts.

Demander un devis

Informations

o2Cloud User Manager - Gestion d'utilisateurs Active Directory

© 2026 o2Cloud - Tous droits réservés - Made with in France