Guide d'installation TBSCertBot v0.9.6 sur Windows Server

Ce guide vous accompagne dans l'installation de TBSCertBot sur votre serveur Windows.

Note : Pour une installation rapide et “style Linux”, nous avons inclus un script PowerShell automatisé.

1. Préparation du Serveur

1. Connexion KVM/Console (si ce n'est pas déjà fait)

• Connectez-vous à l'espace client de votre hébergeur ;
  
• Accédez à la console KVM ou VNC de votre serveur ;
  
• Suivez les étapes pour initialiser Windows (Langue, Clavier, Mot de passe Administrateur).
  

2. Connexion Bureau à Distance (RDP)

• Une fois Windows initialisé, connectez-vous via un client RDP (ex: “Connexion Bureau à distance” sur Windows ou “Remmina” sur Linux) avec l'IP du serveur et le compte Administrator.
  

2. Installation Automatisée (Recommandée)

Nous avons préparé un script install_on_windows.ps1 qui installe IIS, PHP, et configure TBSCertBot pour vous.

1. Transférer les fichiers

• Copiez le dossier tbscertbot extrait sur le serveur, par exemple sur le Bureau ou dans C:\Temp.
  

2. Lancer l'installation

• Ouvrez PowerShell en tant qu'administrateur (Clic droit sur le menu Démarrer > Windows PowerShell (Admin)) ;
  
• Naviguez vers le dossier windows à l'intérieur du dossier extrait : powershell cd C:\Chemin\Vers\tbscertbot\windows ;
  
• Exécutez le script : powershell .\install_on_windows.ps1 ;
  
• Le script va :
  • Installer le rôle Web Server (IIS) ;
    
  • Télécharger et installer PHP 8.2 ;
    
  • Télécharger et installer OpenSSL (requis pour la cryptographie) ;
    
  • Installer les redistribuables VC++ nécessaires ;
    
  • Créer le dossier C:\TBSCertBot et y copier les fichiers ;
    
  • Pré-configurer data\conf.ini.example avec le chemin OpenSSL ;
    
  • Configurer la tâche planifiée (Cron) : Une tâche TBSCertBot_Cron est créée pour s'exécuter tous les jours à 03:00 (renouvellements automatiques) ;
    
    Note : Un délai aléatoire (0-12h) est ajouté à l'exécution pour éviter la surcharge serveur ;
    
  
  
• À la fin, le script vous demandera si vous voulez lancer l'assistant (Wizard) :
  • Y (Oui) : Lance la configuration interactive ;
    
  • N (Non) : Crée le fichier conf.ini pour une édition manuelle.
    

3. Configuration (Si vous n'avez pas utilisé le Wizard)

• Allez dans C:\TBSCertBot\data ;
  
• Ouvrez conf.ini avec un éditeur de texte (Notepad ou autre) ;
  
• Section [HOOKS] :
  • Pour la validation (DCV), configurez le chemin vers le script de validation. ini [HOOKS] dcv = "C \TBSCertBot\doc\examples\windows\exportDCVScript.bat" ;
    
  • Pour l'installation du certificat sur IIS : ini [HOOKS] download = "C:\TBSCertBot\doc\examples\windows\hook-iis.bat".
    
  
  
• Vérification :
  • Ouvrez une invite de commande (cmd ou PowerShell) ;
    
  • Tapez : powershell php tbscertbot.php version ;
    
    

    cd C:\TBSCertBot
    powershell php tbscertbot.php version

    
    
  • Tout doit être au vert.
    

4. Utilisation

Vous pouvez maintenant utiliser TBSCertBot.

Commander un certificat :

powershell php tbscertbot.php order

Importer un certificat :

powershell php tbscertbot.php import [reference]

Annexes : Installation Manuelle

Si vous préférez tout faire par vous même :

• IIS : Installez le rôle “Web Server (IIS)” via le Server Manager ;
  
• PHP :
  • Téléchargez PHP 8.x (Non Thread Safe) sur windows.php.net ;
    
  • Dézippez dans C:\PHP ;
    
  • Ajoutez C:\PHP à votre variable d'environnement PATH ;
    
  • Activez curl, mbstring, openssl dans php.ini.
    
  
  
• OpenSSL :
  • Téléchargez et installez “Win64 OpenSSL v3.x Light” depuis slproweb.com ;
    
  • Installez-le dans le dossier par défaut (C:\Program Files\OpenSSL-Win64).
    
  
  
• TBSCertBot :
  • Copiez les fichiers dans C:\TBSCertBot ;
    
  • Configurez data\conf.ini (copiez data\conf.ini.example vers data\conf.ini).
    

Liens utiles

• Gérez simplement vos certificats avec TBSCertBot
• Prise en main rapide de TBSCertBot
• Automatisez vos commandes et renouvellements grâce aux Hooks et au mode Cron
• TBSCertBot - Tableau de bord et suivi des agents