Table des matières
Description générale
Ce document décrit l'installation et la configuration de DokuWiki sur un Serveur NethServer-7.6.1810:
Ce cahier utilise le Serveur NethServer du Cahier-03: Création d'un Serveur NethServer virtuel du “Cours NethServer-101”.
But de ce cahier
DokuWiki
Référence: https://fr.wikipedia.org/wiki/DokuWiki.
DokuWiki est un moteur de wiki libre sous licence GNU GPL conforme aux standards, simple à utiliser, dont le but principal est de créer des documentations de toute sorte. Ce logiciel est développé en PHP par Andreas Gohr. Il est destiné aux équipes de développement, aux travaux de groupe et aux petites entreprises. Il a une syntaxe simple qui assure la lisibilité des fichiers de données en dehors du Wiki et facilite la création de textes structurés. Toutes les données sont stockées dans des fichiers texte et donc aucune base de données n’est nécessaire.
DokuWiki a été créé par Andreas Gohr en juin 2004. La première version officielle est sortie en juillet sur Freshmeat. L’une des étapes importantes de la phase du développement a été la refonte des analyseurs syntaxiques et de la partie rendu en janvier 2005. Cette nouvelle réalisation a été synonyme de performances bien meilleures et a ainsi rendu DokuWiki utilisable pour les projets de documentation plus importants. Elle a apporté une interface générique pour les extensions qui a simplifié le travail de développement et de maintenance des extensions. Ces améliorations ont bien été perçues par la communauté puisque DokuWiki fait désormais partie des distributions Debian depuis avril 2005 et Gentoo depuis juillet 2005. Aujourd’hui, DokuWiki fait partie des moteurs de Wiki les plus connus.
Manuel DokuWiki: https://www.dokuwiki.org/fr:manual.
Cours NethServer-101
Le Cours NethServer-101, se voulant une base solide pour la création d'un site de Commerce en ligne, comprend plusieurs cahiers:
- Cahier-01: → Les bases de Linux.
- Cahier-02: → Installation et configuration des logiciels prérequis sur le poste de travail.
- Cahier-03: → Création d'un Serveur NethServer virtuel.
- Cahier-04: → Serveur NethServer LOCAL & Let's Encrypt.
- Cahier-06: → Installation de WordPress.
- Cahier-07: → Installation de l'extension de sécurité Wordfence.
- Cahier-08: → WooCommerce, comptes chez Stripe et PayPal pour les paiements en ligne.
- Cahier-09: → Sauvegarde/restauration ou migration d'un site avec l'extension Duplicator.
- Cahier-10: → Serveur mandataire inversé.
- Cahier-11: → Sauvegarde/restauration avec BackupPC.
Cours NethServer-201
Le Cours NethServer-201 décrit l'installation et la configuration d'applications sur un serveur NethServer.
- Cahier-201-01: → Dolibarr.
- Cahier-201-02: → Odoo-12.
- Cahier-201-03: → MediaWiki.
- Cahier-201-04: → DokuWiki.
- Cahier-201-05: → Moodle.
- Cahier-201-06: → Proxmox.
- Cahier-201-07: → Flectra.
Logiciels
Tous les logiciels nécessaires sont du domaine public ou LIBRE sous licence GPL; ils ne coûtent pas un sou. Le seul achat nécessaire est l'obtention d'un nom de domaine au prix initial de $15 CAD et son renouvellement annuel d'environ $30 CAD.
But final
Après avoir suivi le Cours NethServer-101, vous posséderez un site de Commerce en ligne fiable et hautement sécuritaire. De plus, vous pourrez utiliser un clone de votre site, sur un Serveur NethServer virtuel roulant sur votre poste de travail, pour tester de nouvelles extensions et applications sans compromettre la sécurité ou l'intégrité de votre site en ligne.
Particularités de ce document
Notes au lecteur
* Les captures d'écrans ne sont que des références.
** Les informations écrites ont préséance sur celles retrouvées dans les captures d'écrans. Veillez vous référer aux différents tableaux lorsque ceux-ci sont présents.
*** Une capture d'écran avec une accentuation en magenta indique qu'il faut remplacer cette distinction par vos propres paramètres ou implique un choix laissé à votre appréciation.
Conventions
Manipulation, truc ou ruse pour se tirer d'embarras.
Une recommandation ou astuce.
Une note.
Une étape, note ou procédure à surveiller.
Paragraphe non complété ou non vérifié.
Danger pour la sécurité du système.
Toutes les commandes à la console ou à travers PuTTY sont précédées d'une invite qui est toujours présente.
[root@dorgee ~]# ping 10.10.10.75 -c1 PING 10.10.10.75 (10.10.10.75) 56(84) bytes of data. 64 bytes from 10.10.10.75: icmp_seq=1 ttl=64 time=1.63 ms --- 10.10.10.75 ping statistics --- 1 packets transmitted, 1 received, 0% packet loss, time 0ms rtt min/avg/max/mdev = 1.639/1.639/1.639/0.000 ms [root@dorgee ~]#
Commande à exécuter si ce n'est déjà fait.
Commande indiquée à titre d'information seulement.
À savoir
Diagramme réseau
Serveur NethServer-7.6.1810
Le Serveur NethServer-7.6.1810 est un dérivé de la distribution Linux CentOS et est équivalent à CentOS-7.6.1810.
dorgee.micronator-101.org
Serveur et passerelle pour la documentation.
tchana.micronator-dev.org
Serveur virtuel LOCAL sous VirtualBox Version 6.0.4 r128413 (Qt5.6.2).
Répertoire d'installation
Nous installerons DokuWiki dans le répertoire /var/lib/nethserver/vhost/dokuwiki
.
Poste de travail
Windows-8.1, on utilisera ce poste de travail pour tous ce document.
Éditeur de texte
Ne modifiez pas les fichiers avec des éditeurs de documents tels Notepad, TextEdit ou autres qui ajoutent une marque d'ordre d'octets (byte order marks) aux fichiers et qui casse le programme PHP. Utilisez plutôt un éditeur de code tel vi, vim, Notepad++, ou Atom. Ces éditeurs gèrent l'encodage des fichiers de manière appropriée; ils peuvent aussi être utilisés pour réparer les fichiers précédemment cassés par les autres éditeurs de documents.
Notepad++
Voir le Cahier-02: Installations & configurations des logiciels prérequis du “Cours NethServer-1010” pour l'installation et la configuration de cet éditeur.
Description
Référence: https://notepad-plus-plus.org/fr/.
Notepad++ est un éditeur de code source qui prend en charge plusieurs langages. Ce logiciel, codé en C++ avec STL et win32 api, a pour vocation de fournir un éditeur de code source de taille réduite mais très performant. En optimisant de nombreuses fonctions, tout en conservant une facilité d’utilisation et une certaine convivialité, Notepad++ contribue à la limitation des émissions de dioxyde de carbone dans le monde; en effet, en réduisant l’utilisation du CPU, la consommation d’énergie des ordinateurs chute considérablement, en conséquence de quoi, la terre est plus verte.
Site de téléchargement: https://notepad-plus-plus.org/fr/.
Documentation
Guide pratique (1er août 2013): http://nliautaud.developpez.com/tutoriels/web/notepadplusplus-guide-pratique/.
Aide-mémoire des principales commande: https://drive.google.com/file/d/0B86nuTd5nMTKaENHcmliUC1kdnc/edit.
Connexion sécuritaire
Ce document décrit aussi la marche à suivre pour une connexion sécuritaire (https) vers DokuWiki.
HTTPS (Hyper Text Transfer Protocol Secure) apparaît dans l'URL lorsqu'un site Web est sécurisé par un certificat SSL/TLS. Les détails du certificat, y compris l'autorité émettrice et la dénomination sociale du propriétaire du site Web, peuvent être consultés en cliquant sur l'icône du cadenas sur la barre du navigateur.
Préparation de l'environnement de travail
Configuration du poste de travail
Voir la section À savoir du Cahier-03 : Création d'un Serveur NethServer virtuel du “Cours NethServer-101”.
Vérification
Centre Réseau et partage → Modifier les paramètres de la carte → clac (clic droit) sur la carte Éthernet → Statut → Détails.
● Nos deux adresses IP et nos deux passerelles son présentes.
● Fermer toutes les fenêtre.
C:\Windows\System32\drivers\etc\hosts
.
Les CNAME de notre Serveur NethServer virtuel LOCAL sont présents.
Installation d'un Serveur NethServer
Voir le Cahier-03: Création d'un Serveur NethServer virtuel du “Cours NethServer-101”.
Pour un serveur virtuel de test, prendre un minimum de 8 Go dynamiquement alloué pour le disque principal.
Mise à jour du Serveur
Avant de commencer quoi que ce soit, il est toujours préférable de mettre à jour le Serveur NethServer.
Fail2ban & ClamAV
Il est fortement recommandé d'installer Fail2ban et ClamAV pour mieux sécuriser notre futur site DokuWiki. L'installation de ces logiciels est décrite dans le Cahier-03: Création d'un Serveur NethServer virtuel du “Cours NethServer-101”..
interface Web NethServer
Il faut activer Javascript et les témoins (cookies).
Depuis le poste de travail, sur le réseau LOCAL 10.10.10.0/24, on accède à l'interface Web Nethserver http://10.10.10.75:980.
Login
Lorsque vous parvenez à l'URL, vous serez invité à entrer votre nom d’utilisateur (qui est obligatoirement root et son mot de passe). Entrez ce justificatif et cliquez sur Login afin d’être amené à l'interface Web Nethserver. L’écran du gestionnaire s’affiche.
Le cadenas n'est pas vert, car si nous utilisons un nouveau Serveur NethServer, nous n'avons pas encore de certificat émis par une autorité de certification reconnue. Plus loin, nous réglerons cet inconvénient
Si vous avez de la difficulté à vous connecter, vidanger le cache DNS du poste de travail et celui du navigateur Firefox.
Fournisseur des comptes
FQDN du serveur
Configuration → DNS → onglet Hôtes.
Le FQDN du serveur: micronator-dev.org est bien ce qu'il devrait être.
mediawiki.micronator-dev.org provient du Cahier-03: MediaWiki du “Cours NethServer-201”.
Nom du serveur
Paramètres d'accès à distance
FTP
Configuration → FTP → onglet Configurer.
Dokuwiki utilise son propre logiciel FTP, il n'est donc pas nécessaire d'activer le service FTP sur le serveur.
Nous ne recommandons pas d'activer ce service, car il n'est pas sécuritaire. Pour le transfert de fichiers, il est préférable d'employer des utilitaires sécurisés tels que WinSCP ou FileZilla.
Serveurs DNS
Configuration → Réseau → onglet Serveur DNS.
Le serveur DNS secondaire peut être 8.8.8.8 ou 1.1.1.1; le dernier étant plus rapide.
Ouverture d'une session PuTTY
Les paramètres du serveur sont définis correctement et on peut utiliser PuTTY pour s'y loguer.
Voir PuTTY dans le Cahier-02 : Installations & configurations des logiciels prérequis du “Cours NethServer-101”.
On se logue en tant que l'utilisateur root.
login as: root root@10.10.10.75's password: mot-de-passe-de-root Last login: Thu May 16 09:58:33 2019 from 10.10.10.81 ************ Welcome to NethServer ************ This is a NethServer installation. Before editing configuration files, be aware of the automatic events and templates system. http://docs.nethserver.org *********************************************** [root@tchana ~]#
Adresse IP
On vérifie les adresses IP du serveur.
[root@tchana ~]# ifconfig enp0s3: flags=4163<UP,BROADCAST,RUNNING,MULTICAST> mtu 1500 inet 10.10.10.75 netmask 255.255.255.0 broadcast 10.10.10.255 inet6 fe80::a00:27ff:fedd:6373 prefixlen 64 scopeid 0x20<link> ether 08:00:27:dd:63:73 txqueuelen 1000 (Ethernet) RX packets 680 bytes 63712 (62.2 KiB) RX errors 0 dropped 0 overruns 0 frame 0 TX packets 634 bytes 260579 (254.4 KiB) TX errors 0 dropped 0 overruns 0 carrier 0 collisions 0 enp0s8: flags=4163<UP,BROADCAST,RUNNING,MULTICAST> mtu 1500 inet 192.168.1.75 netmask 255.255.255.0 broadcast 192.168.1.255 inet6 fe80::a00:27ff:feda:1348 prefixlen 64 scopeid 0x20<link> ether 08:00:27:da:13:48 txqueuelen 1000 (Ethernet) RX packets 27919 bytes 26181152 (24.9 MiB) RX errors 0 dropped 0 overruns 0 frame 0 TX packets 20591 bytes 5112156 (4.8 MiB) TX errors 0 dropped 0 overruns 0 carrier 0 collisions 0 lo: flags=73<UP,LOOPBACK,RUNNING> mtu 65536 inet 127.0.0.1 netmask 255.0.0.0 inet6 ::1 prefixlen 128 scopeid 0x10<host> loop txqueuelen 1000 (Local Loopback) RX packets 2534 bytes 309622 (302.3 KiB) RX errors 0 dropped 0 overruns 0 frame 0 TX packets 2534 bytes 309622 (302.3 KiB) TX errors 0 dropped 0 overruns 0 carrier 0 collisions 0 [root@tchana ~]#
Fail2ban
On vérifie que le pare-feu Fail2ban est installé.
[root@tchana ~]# rpm -qa | grep -i fail2ban fail2ban-firewalld-0.9.7-1.el7.noarch fail2ban-server-0.9.7-1.el7.noarch fail2ban-0.9.7-1.el7.noarch fail2ban-sendmail-0.9.7-1.el7.noarch nethserver-fail2ban-1.1.6-1.ns7.noarch fail2ban-shorewall-0.9.7-1.el7.noarch [root@tchana ~]#
On vérifie que Fail2ban roule sur le serveur.
[root@tchana ~]# ps aux | grep -i fail2ban root 4586 1.2 0.5 1746708 22656 ? Sl 12:05 0:28 /usr/bin/python2 -s /usr/bin/fail2ban-server -s /var/run/fail2ban/fail2ban.sock -p /var/run/fail2ban/fail2ban.pid -x -b root 7161 0.0 0.0 112728 984 pts/0 S+ 12:44 0:00 grep --color=auto -i fail2ban [root@tchana ~]#
ClamAV
Par défaut ClamAV est installé, mais partiellement, et s'occupe seulement du balayage des courriels.
Dans le Cahier-03 : Création d'un Serveur NethServer virtuel du “Cours NethServer-101”, nous avons installé ClamAV qui s'occupe aussi du balayage du système de fichiers.
On vérifie que l'antivirus ClamAV pour le système de fichiers est installé.
[root@tchana ~]# rpm -qa | grep -i clamav clamav-scanner-systemd-0.101.2-1.el7.x86_64 clamav-lib-0.101.2-1.el7.x86_64 clamav-server-systemd-0.101.2-1.el7.x86_64 clamav-unofficial-sigs-5.6.2-7.el7.noarch clamav-update-0.101.2-1.el7.x86_64 clamav-0.101.2-1.el7.x86_64 clamav-filesystem-0.101.2-1.el7.noarch [root@tchana ~]#
Configuration → Scanner Antivirus → onglet Clamscan.
ClamAV lancera un balayage complet du système à 01h00.
Utilisateurs
Utilisateur michelandre
Gestion → Utilisateurs et groupes → onglet Utilisateurs.
L'utilisateur michelandre a été créé dans le
Cahier-03
: Création d'un Serveur NethServer virtuel du “Cours NethServer-101”.
Fichier hosts du poste de travail
Nous sommes sur un réseau LOCAL et vu que nous n'avons pas de serveur DNS pour ce réseau, on ajoute des entrées
dokuwiki
dans le fichier:
C:\Windows\System32\drivers\etc\hosts
du poste de travail afin qu'il puisse trouver l'adresse IP de notre serveur DokuWiki.
Pour un serveur directement branché à l'Internet, cette procédure de modification du fichier
hosts
du poste de travail n'est pas nécessaire s'il existe des CNAME dokuwiki chez le régistraire du domaine.
Prérequis
Collection PHP
Version PHP actuelle pour notre Serveur NethServer-7.6-1810.
[root@tchana ~]# php --version PHP 5.4.16 (cli) (built: Oct 30 2018 19:30:51) Copyright (c) 1997-2013 The PHP Group Zend Engine v2.4.0, Copyright (c) 1998-2013 Zend Technologies [root@tchana ~]#
Comme on le voit, notre version 5.4.16 de PHP est légèrement vieillotte.
Nous allons installer la Collection PHP qui fournit une version plus récente tout en gardant installée la version originale.
Collections de logiciels
Les développeurs de RedHat ont pensé qu'un inconvénient, avec entre autres la version 5 de PHP, allait survenir tôt ou tard et ont écrit les paquetages des Collections.
Tous les RPM des Collections sont installés dans le répertoire /opt
; ce qui empêche toutes interférences ou conflits avec les installations par défaut.
But de la Collection PHP
Le but de la Collection PHP est d'installer PHP-5.6, PHP-7.0, PHP-7.1, PHP-7.2 et PHP-7.3 parallèlement à la version installée par défaut avec NethServer-7.6.1810, sans devoir supprimer ou modifier cette dernière. Cette Collection utilise les RPM du référentiel remi qui sont en fait, les mêmes que ceux sur le site Web officiel, mais ils ont l'avantage de fournir plus de choix. Cette Collection nécessite d'installer le référentiel stephdl.
Prérequis pour l'installation de la Collection PHP
Référence: https://wiki.nethserver.org/doku.php?id=php-scl.
Il faut installer les référentiels stephdl et remi pour pouvoir installer la Collection PHP.
Référentiel stephdl
Référence: https://wiki.nethserver.org/doku.php?id=stephdl_repository.
On vérifie si le référentiel stephdl est déjà installé.
[root@tchana ~]# rpm -qa | grep nethserver-stephdl nethserver-stephdl-1.0.7-1.ns7.sdl.noarch [root@tchana ~]#
Si ce n'est déjà fait, on installe ce référentiel.
[root@tchana ~]# yum install -y http://mirror.de-labrusse.fr/NethServer/7/x86_64/nethserver-stephdl-1.0.7-1.ns7.sdl.noarch.rpm ... Transaction Summary ============================================================================================ Install 1 Package Total size: 40 k Installed size: 40 k ... Installed: nethserver-stephdl.noarch 0:1.0.7-1.ns7.sdl Complete! [root@tchana ~]#
Vérification.
[root@tchana ~]# rpm -qa | grep stephdl nethserver-stephdl-1.0.7-1.ns7.sdl.noarch [root@tchana ~]#
Référentiel remi
On vérifie si le référentiel remi est déjà installé.
[root@tchana ~]# rpm -qa | grep remi remi-release-7.6-2.el7.remi.noarch [root@tchana ~]#
Si ce n'est déjà fait, on installe ce référentiel.
[root@tchana ~]# yum install -y http://rpms.famillecollet.com/enterprise/remi-release-7.rpm ... Transaction Summary ============================================================================================ Install 1 Package Total size: 19 k Installed size: 19 k ... Installed: remi-release.noarch 0:7.6-2.el7.remi Complete! [root@tchana ~]#
On vérifie.
[root@tchana ~]# rpm -qa | grep remi remi-release-7.6-2.el7.remi.noarch [root@tchana ~]#
Installation de la Collection PHP
[root@tchana ~]# yum install -y nethserver-php-scl --enablerepo=stephdl ... Résumé de la transaction ============================================================================================ Installation 1 Paquet (+127 Paquets en dépendance) Taille totale des téléchargements : 47 M Taille d'installation : 134 M ... Installation : scl-utils-20130529-19.el7.x86_64 1/128 ... Installation : nethserver-php-scl-1.2.4-1.ns7.sdl.x86_64 128/128 Vérification : 1:enchant-1.6.0-8.el7.x86_64 1/128 ... Vérification : php72-php-tidy-7.2.18-1.el7.remi.x86_64 128/128 Installé : nethserver-php-scl.x86_64 0:1.2.4-1.ns7.sdl Dépendances installées : enchant.x86_64 1:1.6.0-8.el7 ... tcl.x86_64 1:8.5.13-8.el7 Terminé ! [root@tchana ~]#
Usage
Normalement, l'interface Web devrait être complète et vous ne devriez pas devoir utiliser la ligne de commande. Si vous pensez que Stéphane de Labrusse pourrait améliorer les paramètres PHP en apportant plus d'options, veuillez le lui demander: stephd arobas de-labrusse point fr.
Les réglages sont répartis à deux endroits.
- À la page Gestion → Hôtes virtuels.
Là, après avoir créé un hôte virtuel, vous pouvez choisir la version que vous utiliserez pour l'Ibay/virtualhost (par défaut, la version PHP d’Apache).
- Vu que NethServer utilise un script CGI pour gérer la version de PHP, vous ne pourrez pas ajuster les paramètres PHP avec le module nethserver-phpsettings; vous devez régler les paramètres à l'aide du fichier php.ini
correspondant. Stéphane de Labrusse voulait coder quelque chose de “cool” afin que tous les paramètres ne soient pas basés uniquement sur des commandes de BD… Il a alors crée une page de configuration.
- À la page Configuration → Paramètres PHP.
Là, vous pouvez choisir la version PHP que vous souhaitez utiliser pour l’ensemble du serveur.
- Lorsqu'Apache est le gestionnaire de PHP, vous pouvez alors définir les paramètres PHP avec le module nethserver-phpsettings. En d'autres termes, si vous souhaitez utiliser le module nethserver-phpsettings et que vous avez besoin d'une version spécifique de PHP, vous devez utiliser cette version pour tout le serveur. Bien sûr, vous pouvez revenir à la version par défaut en cas de problème avec une ancienne application Web. Dans d’autres parties de cette page, vous pouvez ajuster les paramètres PHP pour toutes les versions de PHP.
Répertoire d'installation
Toutes les versions PHP de la Collection proviennent du référentiel remi-safe et sont installées dans le répertoire
/opt/remi
.
[root@tchana ~]# yum repolist | grep remi * remi-safe: mirror.team-cymru.com remi-safe Safe Remi's RPM repository for Enterprise Lin 3 191 [root@tchana ~]#
On vérifie le répertoire /opt
.
[root@tchana ~]# ls -ls /opt total 0 0 drwxr-xr-x. 7 root root 81 Jan 4 09:16 puppetlabs 0 drwxr-xr-x 7 root root 71 May 10 17:06 remi 0 drwxr-xr-x 2 root root 6 Oct 30 2018 rh [root@tchana ~]#
On affiche le répertoire /opt/remi
.
[root@tchana ~]# ls -ls /opt/remi total 0 0 dr-xr-xr-x 3 root root 32 16 mai 13:03 php56 0 dr-xr-xr-x 3 root root 32 16 mai 13:03 php70 0 dr-xr-xr-x 3 root root 32 16 mai 13:03 php71 0 dr-xr-xr-x 3 root root 32 16 mai 13:03 php72 0 dr-xr-xr-x 3 root root 32 16 mai 13:03 php73 [root@tchana ~]#
PHP72 par défaut après une connexion à la ligne de commande
Référence: http://appdev.oit.umn.edu/2015/02/11/scl/
On crée le fichier d'activation qui sera lu lors d'une connexion à la console du Serveur NethServer.
Prendre tout le contenu de l'encadré pour la commande.
cat > /etc/profile.d/activer-php72.sh <<'EOT' #!/bin/bash source /opt/remi/php72/enable if [[ "$X_SCLS" != *php72* ]]; then src="`scl enable php72 'echo $X_SCLS'`" pkgs=(${src// / }) uniq=($(printf "%s\n" "${pkgs[@]}" | sort -u)); export X_SCLS="${uniq[@]}" fi EOT
On rend le fichier exécutable.
[root@tchana ~]# chmod +x /etc/profile.d/activer-php72.sh [root@tchana ~]#
On vérifie.
[root@tchana ~]# ls -als /etc/profile.d/activer-php72.sh 4 -rwxr-xr-x 1 root root 215 16 mai 13:11 /etc/profile.d/activer-php72.sh [root@tchana ~]#
Vérification si PHP72 est le défaut
On ferme la connexion PuTTY et on en ouvre une nouvelle.
On vérifie l'installation de la Collection.
[root@tchana ~]# rpm -qa | grep scl- centos-release-scl-rh-2-3.el7.centos.noarch centos-release-scl-2-3.el7.centos.noarch nethserver-php-scl-1.2.4-1.ns7.sdl.x86_64 scl-utils-20130529-19.el7.x86_64 [root@tchana ~]#
Collections installées.
[root@tchana ~]# scl -l php56 php70 php71 php72 php73 [root@tchana ~]#
Quel est le PHP par défaut?
[root@tchana ~]# which php /opt/remi/php72/root/usr/bin/php [root@tchana ~]#
Quelle est sa version?
[root@tchana ~]# php --version PHP 7.2.18 (cli) (built: Apr 30 2019 14:41:03) ( NTS ) Copyright (c) 1997-2018 The PHP Group Zend Engine v3.2.0, Copyright (c) 1998-2018 Zend Technologies [root@tchana ~]#
Notre fichier activer-php72.sh
fonctionne correctement.
Sauvegarde du fichier d'activation
On vérifie si le nom du fichier /etc/profile.d/activer-php72.sh
est déjà présent dans le fichier d'inclusion de la sauvegarde des données: /etc/backup-data.d/custom.include
, sinon on l'insère.
Prendre tout le contenu de l'encadré pour la commande.
NouvelleInclusion="/etc/profile.d/activer-php72.sh" if grep -Fxq "$NouvelleInclusion" /etc/backup-data.d/custom.include then # L'entrée a été trouvée dans custom.include echo -e "\nLe fichier custom.include contient déjà l'entrée:\n$NouvelleInclusion \n" else # L'entrée n'a pas été trouvée dans custom.include echo -e "$NouvelleInclusion" >> /etc/backup-data.d/custom.include echo -e "\nL'entrée: $NouvelleInclusion a été ajoutée\n" fi
On vérifie.
[root@tchana ~]# cat /etc/backup-data.d/custom.include | grep /etc/profile.d/activer-php72.sh /etc/profile.d/activer-php72.sh [root@tchana ~]#
Ci-dessus, il n'y a pas de ligne vide avant /etc/profile.d/activer-php72.sh. Nous en avons inséré une afin de faciliter la copie de la commande.
Mise à jour de la Collection
NethServer-7.6.1810 utilise intrinsèquement le référentiel remi-safe. Ce qui signifie qu'il est activé par défaut. Lancez simplement la commande suivante pour mettre à jour la Collection PHP:
[root@tchana ~]# yum update -y nethserver-php-scl --enablerepo=stephdl Loaded plugins: changelog, fastestmirror, nethserver_events Loading mirror speeds from cached hostfile * ce-base: it.centos.contactlab.it * ce-extras: it.centos.contactlab.it * ce-updates: it.centos.contactlab.it * epel: epel.mirror.constant.com * nethforge: mirror.nethserver.org * nethserver-base: mirror.nethserver.org * nethserver-updates: mirror.nethserver.org * remi-safe: rpms.remirepo.net No packages marked for update [root@tchana ~]#
S'il y avait une mise à jour, elle serait installée avec cette commande.
La mise à jour du Serveur NethServer s'occupe aussi de celle de la Collection PHP.
Ajustement des paramètres PHP
Les valeurs de certains paramètres de PHP ne sont pas suffisants pour certains ajouts. Ces paramètres sont: MemoryLimit
, PostMaxSize
et UploadMaxFilesize
. Il faut les ajuster.
Affichage des paramètres par défaut.
[root@tchana ~]# config show php72 php72=configuration AllowUrlFopen=On ExposePhp=0 MaxExecutionTime=30 MaxFileUpload=20 MaxInputTime=60 MemoryLimit=128 PostMaxSize=20 UploadMaxFilesize=10 [root@tchana ~]#
Il faut obligatoirement que le paramètre
PostMaxSize
soit plus grand que celui de UploadMaxFilesize
. Si on modifie l'un, il faut vérifier l'autre pour que la correspondance des grandeurs soit respectée.
Nous allons ajuster:
MemoryLimit
(250M) > PostMaxSize
(100M) > UploadMaxFilesize
(75M).
MemoryLimit
Chaque fois qu'un client fait une requête au serveur Web, PHP génère un processus PHP. Le travail de ce processus est de générer du code HTML qu'il envoie au client. Le processus fournit un temps d'exécution à un script qui crée la réponse à la requête. La limite de mémoire MemoryLimit
est la quantité maximale de mémoire que ce processus peut utiliser. Si la limite est atteinte ou dépassée, le processus échoue et Apache signale une erreur HTTP 500.
PostMaxSize
Le paramètre PostMaxSize
définit la taille maximale autorisée pour les données d'un post. Ce paramètre affecte également le téléchargement de fichiers. Pour télécharger des fichiers volumineux, cette valeur doit absolument être toujours supérieure à UploadMaxFilesize
.
UploadMaxFilesize
Pour certaines extensions telles qu'entre autres WooCommerce, WordPress doit autoriser le téléversement de fichiers et la grandeur de ceux-ci ne peut dépasser la limite définie par le paramètre UploadMaxFilesize
de PHP.
La limite ci-contre, est celle de WordPress.
Version PHP par défaut
On définit la version PHP par défaut pour Apache.
Configuration → Paramètres PHP → onglet Version PHP Apache → cliquer Php72 SCL Version → SOUMETTRE.
Ajustements des paramètres de la version PHP-7.2
Onglet Php V7.2 SCL
Ajuster tel que ci-contre (250M - 100M - 75M)
→ SOUMETTRE.
Vérifications à la ligne de commande
MemoryLimit
[root@tchana ~]# cat /etc/opt/remi/php72/php.ini | grep -i Memory_Limit memory_limit = 250M [root@tchana ~]#
PostMaxSize
[root@tchana ~]# cat /etc/opt/remi/php72/php.ini | grep -i post_max_size post_max_size = 100M [root@tchana ~]#
UploadMaxFilesize
[root@tchana ~]# cat /etc/opt/remi/php72/php.ini | grep -i upload_max_filesize upload_max_filesize = 75M
Comme on le voit ci-dessus, les grandeurs maximales pour PHP-7.2 sont maintenant de:
MemoryLimit
(250M) > PostMaxSize
(100M) > UploadMaxFilesize
(75M).
Instantané VirtualBox
À ce stade-ci, on peut prendre un instantané de la machine virtuelle afin de pouvoir y revenir en cas d'une future erreur de manipulation.
Les prérequis pour le Serveur NethServer sont tous remplis.
Installation de git
On installe git
qui nous aidera pour les mises à jour de notre version DokuWiki.
[root@tchana ~]# yum install -y git ... Installation de 2 paquet(s) Taille totale des téléchargements : 4.6 M Taille d'installation : 15 M ... Installé: git.x86_64 0:1.7.1-9.el6_9 Dépendance(s) installée(s) : perl-Git.noarch 0:1.7.1-9.el6_9 Terminé ! [root@tchana ~]#
Création de l'hôte virtuel dokuwiki
Gestion → Hôtes virtuels → CRÉER NOUVEAU → onglet Général.
NOM
On peut utiliser n'importe quel mot pour NOM, mais il est préférable d'utiliser dokuwiki, car un nouveau répertoire sera créé pour le nouvel hôte virtuel et il portera ce nom.
C'est dans ce répertoire qu'on installera DokuWiki.
On entre les informations demandées.
SOUMETTRE.
- Onglet Paramètres PHP.
- On ajuste tel que ci-dessous.
*** Autoriser l'accès PHP aux fichiers distants est une faille de sécurité.
- SOUMETTRE.
On vérifie le résultat.
Vérification du répertoire dokuwiki
La création de l'hôte virtuel a produit un nouveau répertoire: /var/lib/nethserver/vhost/dokuwiki
. Ce répertoire prend le nom utilisé à la section NOM.
[root@tchana ~]# ls -alsd /var/lib/nethserver/vhost/dokuwiki 0 drwxr-sr-x 2 ftp apache 7 juin 13:01 /var/lib/nethserver/vhost/dokuwiki [root@tchana ~]#
On voit que le propriétaire est ftp au cas où on utiliserait le service FTP pour la manipulation des fichiers du site. DokuWiki a son propre processus de téléchargement et il n'a pas besoin d'un service FTP externe. De plus, avoir ftp comme propriétaire interfère avec certains logiciels tel WordPress. C'est pour cette raison qu'on n'active jamais FTP sur nos serveurs NethServer.
On change le propriétaire.
[root@tchana ~]# chown apache /var/lib/nethserver/vhost/dokuwiki [root@tchana ~]#
On vérifie.
[root@tchana ~]# ls -alsd /var/lib/nethserver/vhost/dokuwiki 0 drwxr-sr-x 2 apache apache 7 juin 13:01 /var/lib/nethserver/vhost/dokuwiki [root@tchana ~]#
Création d'une entrée DNS pour l'hôte dokuwiki
Configuration → DNS → onglet Hôtes → CRÉER NOUVEAU.
On coche wildcard dns record et ainsi on pourra accéder à l'hôte virtuel en utilisant tous ses CNAME dont un des plus importants est
mail
pour accéder à la messagerie électronique.
Le Nom d'hôte est le FQDN qu'on utilisera pour accéder à notre DokuWiki.
L'adresse IP est celle de l'interface du réseau LOCAL du Serveur NethServer.
SOUMETTRE.
On vérifie le résultat.
Configuration de la messagerie électronique
Si on veut que DokuWiki puisse envoyer et recevoir des courriels, il faut configurer le domaine de l'hôte virtuel en tant que serveur de messagerie électronique.
On vérifie le résultat.
Création d'un alias pour l'utilisateur michelandre
Il nous faur créer un alias de messagerie pour l'utilisateur michelandre qui sera l'administrateur du site DokuWiki. Ainsi, il pourra recevoir des courriels en provenance de DokuWiki et autres hôtes virtuels.
- On entre les informations demandées.
- Destination, on entre michelandre, on clique Ajouter et on choisit michelandre@micronator-dev.org.
- SOUMETTRE.
On vérifie le résultat.
L'utilisateur michelandre pourra voir ses courriels en se connectant à:
Redirection par le module Proxy inverse
Référence: http://docs.nethserver.org/en/v7/ui/ProxyPass.html.
On installe le module Proxy Inverse qui s'occupera de rediriger les accès à DokuWiki vers le bon endroit.
Installation
Configuration du mandataire inversé
Passerelle → Proxy inverse → onglet Hôtes virtuels → CRÉER NOUVEAU.
On configure le Serveur NethServer en tant que mandataire inversé pour:
- On entre les informations demandées.
- SOUMETTRE.
On vérifie le résultat.
Vérification de la connexion redirigée et sécurisée
On vidange l'historique de notre navigateur et le cache DNS du poste de travail, puis on s'assure que java script et les témoins soient activés.
On se rend à l'URL https://www.dokuwiki.micronator-dev.org.
Si on utilisait seulement le protocole http, il serait transformé en https, car lors de la configuration à l'onglet Hôtes virtuels, nous avons coché: ☑ Nécessite une connexion SSL chiffrée.
C'est la page Web par défaut de NethServer qui s'affiche. C'est le comportement normal, car nous n'avons encore aucun fichier dans le répertoire de DokuWiki.
Même si le protocole affiché est https, la connexion n'est pas sécurisée, car le certificat ne contient pas le CNAME dokuwiki. La prochaine section règlera ce problème.
Instantané VirtualBox
À ce stade-ci, on peut prendre un instantané de la machine virtuelle afin de pouvoir y revenir en cas d'une future erreur de manipulation.
Fichier httpd.conf
Le fichier /etc/httpd/conf/httpd.conf
contient toutes les directives qui contrôlent le démon httpd. Celle qui a le plus d'influence sur les fichiers .htaccess
du répertoire d'un site Web et de ses sous-répertoires est la directive AllowOverride
vers la ligne 151 du fichier de configuration du démon.
Par défaut, cette directive est à None et fait en sorte que le démon httpd ne traitera aucun fichier .htaccess
qu'il trouvera; il les ignorera tous.
Plus loin, après l'installation de DokuWiki, plusieurs fichiers .htaccess
existeront.
Nous allons donc créer un fichier /etc/httpd/conf.d/y_dokuwiki.conf
pour indiquer à Apache de lire les fichiers .htaccess
qu'il rencontrera dans le répertoire dokuwiki
.
Création du ficher y_docuwiki.conf
Prendre tout le contenu de l'encadré pour la commande.
cat > /etc/httpd/conf.d/y_dokuwiki.conf <<'EOT' # ************************************** # Michel-André, 2019-06-10 10h19 # Pour permettre la lecture de fichiers .htaccess du répertoire DokuWiki <Directory "/var/lib/nethserver/vhost/dokuwiki"> # Permet de suivre les liens synboliques Options Indexes FollowSymLinks # # La directive AllowOverride ALL signifie d'écraser les directives du fichier de # configuration httpd.conf lorsque le démon rencontre des directives identiques # dans un fichier .htaccess. AllowOverride All # # Contrôle qui peut obtenir des pages de ce serveur. # Require all granted </Directory> EOT
On vérifie.
[root@tchana ~]# cat /etc/httpd/conf.d/y_dokuwiki.conf | grep -i AllowOverride # La directive AllowOverride ALL signifie d'écraser les directives du fichier de AllowOverride All [root@tchana ~]#
Sauvegarde du fichier
On vérifie si le nom du fichier /etc/httpd/conf.d/dokuwiki.conf
est déjà inclus dans le fichier d'inclusion de la sauvegarde des données: /etc/backup-data.d/custom.include
, sinon on l'insère.
Prendre tout le contenu de l'encadré pour la commande.
NouvelleInclusion="/etc/httpd/conf.d/y_dokuwiki.conf" if grep -Fxq "$NouvelleInclusion" /etc/backup-data.d/custom.include then # L'entrée a été trouvée dans custom.include echo -e "\nLe fichier custom.include contient déjà l'entrée:\n$NouvelleInclusion \n" else # L'entrée n'a pas été trouvée dans custom.include echo -e "$NouvelleInclusion" >> /etc/backup-data.d/custom.include echo -e "\nL'entrée: $NouvelleInclusion a été ajoutée\n" fi
On vérifie.
[root@tchana ~]# cat /etc/backup-data.d/custom.include | grep y_dokuwiki.conf /etc/httpd/conf.d/y_dokuwiki.conf [root@tchana ~]#
Ci-dessus, il n'y a pas de ligne vide avant /etc/httpd/conf.d/y_dokuwiki.conf. Nous en avons inséré une afin de faciliter la copie de la commande.
Lors de son lancement, Apache incorpore tous les fichiers qui se trouvent dans le répertoire
/etc/httpd/conf.d/
et qui ont l'extension .conf
. Cette incorporation des fichiers se fait par ordre alphabétique et c'est pour cette raison qu'on a nommé notre nouveau fichier de configuration y_dokuwiki.conf
.
Répertoire well-known
Référence: https://dev-notes.eu/2017/01/apache-directives-in-config-vs-htaccess/
Référence: http://httpd.apache.org/docs/current/howto/htaccess.html#page-header.
Pour un serveur branché directement à l'Internet, lors d'une demande d'un certificat de Let's Encrypt, ce dernier doit pouvoir accéder au répertoire .well-known
et à son sous-répertoire acme-challenge
.
Nous allons créer un fichier /etc/httpd/conf.d/z_well-known.conf
pour indiquer à Apache de rendre accessibles les deux répertoires en question.
Création du fichier z_well-known.conf
Prendre tout le contenu de l'encadré pour la commande.
cat > /etc/httpd/conf.d/z_well-known.conf <<'EOT' Alias "/.well-known/acme-challenge/" "/var/www/html/.well-known/acme-challenge/" <Directory "/var/www/html/.well-known/acme-challenge/"> Require all granted Options -Indexes +FollowSymLinks AllowOverride All </Directory> EOT
On vérifie.
[root@tchana ~]# ls -als /etc/httpd/conf.d/z_well-known.conf 4 -rw-r--r-- 1 root root 231 10 juin 11:03 /etc/httpd/conf.d/z_well-known.conf [root@tchana ~]#
On affiche le contenu du fichier.
[root@tchana ~]# cat /etc/httpd/conf.d/z_well-known.conf Alias "/.well-known/acme-challenge/" "/var/www/html/.well-known/acme-challenge/" <Directory "/var/www/html/.well-known/acme-challenge/"> Require all granted Options -Indexes +FollowSymLinks AllowOverride All </Directory> [root@tchana ~]#
Il n'y a pas de ligne vide au dessus de
Alias…
Ci-dessus, nous avons inséré une ligne vide pour faciliter la copie de la commande.
Sauvegarde du fichier
On vérifie si le nom du fichier /etc/httpd/conf/z_well-known.conf
est déjà inclus dans le fichier d'inclusion de la sauvegarde des données: /etc/backup-data.d/custom.include
, sinon on l'insère.
Prendre tout le contenu de l'encadré pour la commande.
NouvelleInclusion="/etc/httpd/conf/z_well-known.conf" if grep -Fxq "$NouvelleInclusion" /etc/backup-data.d/custom.include then # L'entrée a été trouvée dans custom.include echo -e "\nLe fichier custom.include contient déjà l'entrée:\n$NouvelleInclusion \n" else # L'entrée n'a pas été trouvée dans custom.include echo -e "$NouvelleInclusion" >> /etc/backup-data.d/custom.include echo -e "\nL'entrée: $NouvelleInclusion a été ajoutée\n" fi
On vérifie.
[root@tchana ~]# cat /etc/backup-data.d/custom.include | grep z_well-known.conf /etc/httpd/conf/z_well-known.conf [root@tchana ~]#
Ci-dessus, il n'y a pas de ligne vide avant /etc/httpd/conf/z_well-known.conf. Nous en avons inséré une afin de faciliter la copie de la commande.
Redémarrage du démon httpd
On redémarre le démon Apache afin qu'il relise son fichier de configuration.
[root@tchana ~]# systemctl restart httpd [root@tchana ~]#
Instantané VirtualBox
À ce stade-ci, on peut prendre un instantané de la machine virtuelle afin de pouvoir y revenir en cas d'une future erreur de manipulation.
Certificat Let's Encrypt
CNAME
On met à jour le certificat Let's Encrypt qu'on a installé selon la section
Certificat pour un domaine LOCAL
du Cahier-04: NethServer LOCAL & Certificat Let's Encrypt du “Cours NethServer-101”.
Il faut ajouter les CNAME dokuwiki chez https://www.cloudflare.com/.
On rafraîchit la page, on vérifie et on quitte cloudflare.com.
Demande d'un certificat de test
On force –force
la demande d'un certificat de TEST –test
pour notre domaine micronator-dev.org et dix de ses CNAME.
Nous avons inclus les CNAME mediawiki, car précédemment, nous avons aussi installé MediaWiki selon le Cahier-03: MediaWiki du “Cours NethServer-201”. Si vous n'avez pas MediaWiki, ne pas inclure ces CNAME dans la commande ci-dessous.
Le certificat sera “émis pour” le premier domaine -d de la liste, c.-à-d. micronator-dev.org.
[root@tchana ~]# /root/.acme.sh/acme.sh \ --issue \ --dns dns_cf \ -d micronator-dev.org \ -d www.micronator-dev.org \ -d mail.micronator-dev.org \ -d wpad.micronator-dev.org \ -d mediawiki.micronator-dev.org \ -d www.mediawiki.micronator-dev.org \ -d mail.mediawiki.micronator-dev.org \ -d dokuwiki.micronator-dev.org \ -d www.dokuwiki.micronator-dev.org \ -d mail.dokuwiki.micronator-dev.org \ -d www.mail.dokuwiki.micronator-dev.org \ --cert-file /etc/pki/tls/certs/cert.pem \ --ca-file /etc/pki/tls/certs/chain.pem \ --key-file /etc/pki/tls/private/privkey.pem \ --reloadcmd "/sbin/e-smith/signal-event certificate-update" \ --force \ --test ... [ven. juin 7 13:50:12 EDT 2019] Installing cert to:/etc/pki/tls/certs/cert.pem [ven. juin 7 13:50:12 EDT 2019] Installing CA to:/etc/pki/tls/certs/chain.pem [ven. juin 7 13:50:12 EDT 2019] Installing key to:/etc/pki/tls/private/privkey.pem [ven. juin 7 13:50:12 EDT 2019] Run reload cmd: /sbin/e-smith/signal-event certificate-update [ven. juin 7 13:50:12 EDT 2019] Reload success [root@tchana ~]#
La demande d'un certificat de test a été couronné de succès.
Demande d'un certificat officiel
On force le renouvellement pour l'obtention d'un certificat officiel.
Nous avons inclus les CNAME mediawiki, car précédemment, nous avons aussi installé MediaWiki selon le Cahier-03: MediaWiki du “Cours NethServer-201”. Si vous n'avez pas MediaWiki, ne pas inclure ces CNAME dans la commande ci-dessous.
[root@tchana ~]# /root/.acme.sh/acme.sh \ --issue \ --dns dns_cf \ -d micronator-dev.org \ -d www.micronator-dev.org \ -d mail.micronator-dev.org \ -d wpad.micronator-dev.org \ -d mediawiki.micronator-dev.org \ -d www.mediawiki.micronator-dev.org \ -d mail.mediawiki.micronator-dev.org \ -d dokuwiki.micronator-dev.org \ -d www.dokuwiki.micronator-dev.org \ -d mail.dokuwiki.micronator-dev.org \ -d www.mail.dokuwiki.micronator-dev.org \ --cert-file /etc/pki/tls/certs/cert.pem \ --ca-file /etc/pki/tls/certs/chain.pem \ --key-file /etc/pki/tls/private/privkey.pem \ --reloadcmd "/sbin/e-smith/signal-event certificate-update" \ --force ... [ven. juin 7 13:52:13 EDT 2019] Installing cert to:/etc/pki/tls/certs/cert.pem [ven. juin 7 13:52:13 EDT 2019] Installing CA to:/etc/pki/tls/certs/chain.pem [ven. juin 7 13:52:13 EDT 2019] Installing key to:/etc/pki/tls/private/privkey.pem [ven. juin 7 13:52:13 EDT 2019] Run reload cmd: /sbin/e-smith/signal-event certificate-update [ven. juin 7 13:52:16 EDT 2019] Reload success [root@tchana ~]#
La demande d'un certificat officiel a été couronné de succès.
Vérification de la connexion sécurisée
- On se rend à: https://www.dokuwiki.micronator-dev.org.
Le cadenas est vert, car le certificat a été émis par Let's Encrypt qui est une autorité de certification reconnue et la connexion est sécurisée par un chiffrement TLS/SSL.
C'est la page Web par défaut de NethServer qui s'affiche. C'est le comportement normal, car nous n'avons encore aucun fichier dans le répertoire de DokuWiki.
Si nous avions un site WordPress dans le répertoire web par défaut, c'est la page WordPress du site qui s'afficherait.
Si vous avez de la difficulté à vous connecter, vidanger le cache DNS du poste de travail et celui du navigateur Firefox.
Instantané VirtualBox
À ce stade-ci, on peut prendre un instantané de la machine virtuelle afin de pouvoir y revenir en cas d'une future erreur de manipulation.
Installation de DokuWiki
Téléchargement avec git
On se rend dans le répertoire racine de notre futur DokuWiki.
[root@tchana ~]# cd /var/lib/nethserver/vhost/dokuwiki/ [root@tchana dokuwiki]#
On vérifie.
[root@tchana dokuwiki]# pwd /var/lib/nethserver/vhost/dokuwiki [root@tchana dokuwiki]#
On indique à git
la branche et le répertoire de destination pour l'extraction.
[root@tchana dokuwiki]# git clone --branch stable \ https://github.com/splitbrain/dokuwiki.git \ /var/lib/nethserver/vhost/dokuwiki Cloning into '/var/lib/nethserver/vhost/dokuwiki'... remote: Enumerating objects: 135, done. remote: Counting objects: 100% (135/135), done. remote: Compressing objects: 100% (100/100), done. remote: Total 105612 (delta 61), reused 81 (delta 35), pack-reused 105477 Receiving objects: 100% (105612/105612), 32.98 MiB | 1.80 MiB/s, done. Resolving deltas: 100% (72692/72692), done. [root@tchana dokuwiki]#
Ajustement du propriétaire et du groupe
[root@tchana dokuwiki]# chown -R apache:apache * ; chown -R apache:apache .* [root@tchana dokuwiki]#
Ajustement des droits
On renforce la sécurité de l’accès aux fichiers f en supprimant les droits à “other”.
[root@tchana dokuwiki]# find . -type f -exec chmod 640 {} \; [root@tchana dokuwiki]#
On répète l'opération pour les répertoires d.
[root@tchana dokuwiki]# find . -type d -exec chmod 2750 {} \; [root@tchana dokuwiki]#
On vérifie.
[root@tchana dokuwiki]# ls -als total 140 4 drwxr-s--- 11 apache apache 4096 7 juin 14:30 . 0 drwxr-xr-x 4 apache apache 39 7 juin 10:10 .. 4 -rw-r-S--- 1 apache apache 1777 7 juin 14:30 appveyor.yml 0 drwxr-s--- 2 apache apache 160 7 juin 14:30 bin 4 -rw-r-S--- 1 apache apache 1062 7 juin 14:30 composer.json 20 -rw-r-S--- 1 apache apache 18058 7 juin 14:30 composer.lock 4 drwxr-s--- 2 apache apache 4096 7 juin 14:30 conf 20 -rw-r-S--- 1 apache apache 18092 7 juin 14:30 COPYING 0 drwxr-s--- 3 apache apache 36 7 juin 14:30 _cs 4 drwxr-s--- 12 apache apache 4096 7 juin 14:30 data 4 -rw-r-S--- 1 apache apache 3547 7 juin 14:30 doku.php 4 -rw-r-S--- 1 apache apache 344 7 juin 14:30 .editorconfig 20 -rw-r-S--- 1 apache apache 19141 7 juin 14:30 feed.php 0 drwxr-s--- 8 apache apache 163 7 juin 14:30 .git 4 -rw-r-S--- 1 apache apache 331 7 juin 14:30 .gitattributes 4 -rw-r-S--- 1 apache apache 1935 7 juin 14:30 .gitignore 4 -rw-r-S--- 1 apache apache 1684 7 juin 14:30 .htaccess.dist 4 drwxr-s--- 8 apache apache 4096 7 juin 14:30 inc 4 -rw-r-S--- 1 apache apache 2097 7 juin 14:30 index.php 20 -rw-r-S--- 1 apache apache 19233 7 juin 14:30 install.php 0 drwxr-s--- 8 apache apache 104 7 juin 14:30 lib 4 -rw-r-S--- 1 apache apache 306 7 juin 14:30 README 0 drwxr-s--- 6 apache apache 163 7 juin 14:30 _test 4 -rw-r-S--- 1 apache apache 1402 7 juin 14:30 .travis.yml 0 drwxr-s--- 11 apache apache 209 7 juin 14:30 vendor 4 -rw-r-S--- 1 apache apache 21 7 juin 14:30 VERSION [root@tchana dokuwiki]#
Lancement de l'installation
On se rend sur notre site: https://dokuwiki.FQDN/install.php.
Choisissez votre langue → entrez les informations demandées → Enregistrer.
On clique: votre nouveau DokuWiki.
S'identifier.
On entre le justificatif du super-utilisateur → S'identifier.
Notre DokuWiki est fonctionnel.
Instantané VirtualBox
À ce stade-ci, on peut prendre un instantané de la machine virtuelle afin de pouvoir y revenir en cas d'une future erreur de manipulation.
Victoire totale, notre site DokuWiki est fonctionnel.
Configuration
Préparation
Si nous avons installé DokuWiki plus d'une fois à cause d'une erreur, si nous avons changé l'adresse IP du serveur ou du poste de travail ou pour quelque raison que ce soit, il faudrait mieux être prudent et vidanger le cache DNS du poste de travail et celui du navigateur Firefox.
Login
Si ce n'est déjà fait, on se logue à notre DokuWiki https://www.dokuwiki.micronator-dev.org → S'identifier.
On entre le justificatif du super-utilisateur → S'identifier.
Logo
Le fichier de notre logo doit être nommé logo.png
.
Gestionnaire Multimédia → onglet Envoyer → Sélection de fichier…
On rafraîchit la page et notre logo apparaît.
Notre logo se trouve dans le répertoire: /var/lib/nethserver/vhost/dokuwiki/data/media/
.
[root@tchana ~]# ls -als /var/lib/nethserver/vhost/dokuwiki/data/media/wiki/logo.png 12 -rw-r--r-- 1 apache apache 9485 8 juin 15:44 /var/lib/nethserver/vhost/dokuwiki/data/media/wiki/logo.png [root@tchana ~]#
Relocalisation des répertoires data et conf
Par mesure de sécurité, nous allons relocaliser les répertoires data
et conf
hors du répertoire racine de DokuWiki.
Répertoire conf
On crée le répertoire de destination.
[root@tchana ~]# mkdir -p /etc/dokuwiki [root@tchana ~]#
Le répertoire de destination doit avoir
apache:apache
comme propriétaire:groupe.
[root@tchana ~]# chown apache:apache /etc/dokuwiki [root@tchana ~]#
On vérifie.
[root@tchana ~]# ls -alsd /etc/dokuwiki 4 drwxr-xr-x 2 apache apache 4096 10 juin 15:17 /etc/dokuwiki [root@tchana ~]#
On copie le contenu du répertoire conf
dans le répertoire de destination.
[root@tchana ~]# cp -a /var/lib/nethserver/vhost/dokuwiki/conf/* /etc/dokuwiki [root@tchana ~]#
On supprime le répertoire conf
original.
[root@tchana ~]# rm -rf /var/lib/nethserver/vhost/dokuwiki/conf/ [root@tchana ~]#
Pour remplacer le répertoire conf
original, on créé un lien symbolique qui pointe vers le répertoire de destination.
[root@tchana ~]# ln -s /etc/dokuwiki/ /var/lib/nethserver/vhost/dokuwiki/conf [root@tchana ~]
On vérifie.
[root@tchana ~]# ls -als /var/lib/nethserver/vhost/dokuwiki/conf 0 lrwxrwxrwx 1 root apache 14 10 juin 15:06 /var/lib/nethserver/vhost/dokuwiki/conf -> /etc/dokuwiki/ [root@tchana ~]#
Répertoire data
On crée le répertoire de destination.
[root@tchana ~]# mkdir -p /var/lib/dokuwiki/ [root@tchana ~]#
On vérifie.
[root@tchana ~]# ls -alsd /var/lib/dokuwiki/ 0 drwxr-xr-x 3 root root 18 10 juin 15:18 /var/lib/dokuwiki/ [root@tchana ~]#
Le répertoire
/var/lib/dokuwiki/
doit avoir root:root
comme propriétaire:groupe
.
On copie le répertoire complet data dans le répertoire de destination.
[root@tchana ~]# cp -a /var/lib/nethserver/vhost/dokuwiki/data /var/lib/dokuwiki/ [root@tchana ~]#
On supprime le répertoire data
original.
[root@tchana ~]# rm -rf /var/lib/nethserver/vhost/dokuwiki/data [root@tchana ~]#
Pour remplacer le répertoire data
original, on créé un lien symbolique qui pointe vers le répertoire de destination.
[root@tchana ~]# ln -s /var/lib/dokuwiki/data /var/lib/nethserver/vhost/dokuwiki/data [root@tchana ~]#
On vérifie.
[root@tchana ~]# ls -als /var/lib/nethserver/vhost/dokuwiki/data 0 lrwxrwxrwx 1 root apache 22 10 juin 15:15 /var/lib/nethserver/vhost/dokuwiki/data -> /var/lib/dokuwiki/data [root@tchana ~]#
Ajustement des droits
On renforce la sécurité de l’accès aux fichiers f en supprimant les droits à “other”.
L'option
-L
doit être avant le chemin pour suivre les Liens symboliques et le chemin doit se terminer par /.
[root@tchana dokuwiki]# find -L /var/lib/nethserver/vhost/dokuwiki/ -type f -exec chmod 640 {} \; [root@tchana dokuwiki]#
On répète l'opération pour les répertoires d.
[root@tchana dokuwiki]# find -L /var/lib/nethserver/vhost/dokuwiki/ -type d -exec chmod 2750 {} \; [root@tchana dokuwiki]#
On vérifie pour les fichiers, les répertoires et les fichiers cachés et de plus, “other” n'a aucun droits.
[root@tchana ~]# ls -als /var/lib/nethserver/vhost/dokuwiki/ total 132 4 drwxr-s--- 9 apache apache 4096 10 juin 15:18 . 0 drwxr-xr-x 4 apache apache 39 7 juin 10:10 .. 4 -rw-r-S--- 1 apache apache 1777 7 juin 14:30 appveyor.yml 0 drwxr-s--- 2 apache apache 160 7 juin 14:30 bin ... 0 lrwxrwxrwx 1 root apache 14 10 juin 15:17 conf -> /etc/dokuwiki/ ... 0 lrwxrwxrwx 1 root apache 22 10 juin 15:18 data -> /var/lib/dokuwiki/data ... 4 -rw-r-S--- 1 apache apache 344 7 juin 14:30 .editorconfig ... 4 -rw-r-S--- 1 apache apache 21 7 juin 14:30 VERSION [root@tchana ~]#
Administrer
Répertoire d'enregistrement des données
Si ce n'est déjà fait, on ajuste le chemin du répertoire data
pour celui créé ci-dessus: /var/lib/dokuwiki/data
.
- Au bas de la page, Enregistrer.
- On s'assure du succès de l'opération.
On rafraîchit la page afin de s'assurer que tout fonctionne correctement.
Mode de création des répertoires et fichiers
Paramètres d'affichage
Format de date
Référence: Fonction strftime de PHP.
On change le format de %Y/%m/%d %H:%M
pour %Y-%m-%d %H:%M
qui est plus esthétique et plus facile à lire.
Paramètres de notification
On peut spécifier une adresse courriel pour les notifications.
- Au bas de la page, Enregistrer.
- On s'assure du succès de l'opération.
On rafraîchit la page afin de s'assurer que tout fonctionne correctement.
Création d'un nouveau compte
On crée un compte pour un usager qui n'a pas d'adresse courriel dans dokuwiki.micronator-dev.org afin d'avoir une ligne de notification dans la messagerie électronique de michelandre@dokuwiki.micronator-dev.org.
On s'assure que tout s'est passé correctement.
Vérification de la connexion à Webmail
- On vérifie que Webmail fonctionne correctement en se rendant à:https://www.mail.dokuwiki.micronator-dev.org/webmail.
- L'utilisateur michelandre se connecte.
Le récepteur des notifications a bien reçu le courriel lui annonçant qu'un nouvel utilisateur venait de créer un compte dans DokuWiki.
Instantané VirtualBox
À ce stade-ci, on peut prendre un instantané de la machine virtuelle afin de pouvoir y revenir en cas d'une future erreur de manipulation.
Notre site DokuWiki est toujours fonctionnel.
Extensions pour DokuWiki
La syntaxe de DokuWiki peut être étendue par des extensions. La façon dont les extensions installées sont utilisées est décrite sur leurs pages de description appropriées.
Les extensions ci-dessous sont utilisées par le DokuWiki chez https://wwww.nethserver.org.
Référence: https://community.nethserver.org/t/solved-dokuwiki-in-nethserver-howto/12966/2.
ACL Manager by Andreas Gohr
Add New Page by Benjamin Santalucia, Sam Wilson, Michael Braun, Gerrit Uitslag, Albert Chern
Plain Auth Plugin by Andreas Gohr
Avatar by Michael Hamann, Michael Klier, Gina Haeussge
CAPTCHA Plugin by Andreas Gohr
Toolbar Code Button by Heiko Barth
Configuration Manager by Christopher Smith
Extension Manager by Michael Hamann
Gallery Plugin by Andreas Gohr
gh plugin by Andreas Gohr
include plugin by Michael Hamann, Gina Häussge, Christopher Smith, Michael Klier, Esther Brunner
Info Plugin by Andreas Gohr
Markdowku by Julian Fagir
Move plugin by Michael Hamann, Gary Owen, Arno Puschmann, Christoph Jähnigen
newline by xarkam
NoWiki Plugin by Petr Blaha
oauth plugin by Andreas Gohr
Pagelist Plugin by Matthias Schulte, Michael Hamann, Michael Klier, Gina Haeussge
Popularity Feedback Plugin by Andreas Gohr
Revert Manager by Andreas Gohr
RestructuredText plugin by Chris Green
safefnrecode plugin by Andreas Gohr
styling plugin by Andreas Gohr
Tag Plugin by Michael Hamann, Gina Häussge, Christopher Smith, Michael Klier, Esther Brunner
Translation Plugin by Andreas Gohr
DokuWiki Upgrade Plugin by Andreas Gohr
User Manager by Chris Smith
Video Sharing Site Plugin by Andreas Gohr
Wrap Plugin by Anika Henke
Mise à jour de DokuWiki
Restez à jour
Ici, mise à jour ne signifie pas de passer à une version supérieure de DokuWiki, mais seulement une mise à jour des fichiers de la branche actuelle.
Mise à jour
On se rend dans le répertoire racine de notre DokuWiki.
[root@tchana ~]# cd /var/lib/nethserver/vhost/dokuwiki/ [root@tchana dokuwiki]#
On vérifie.
[root@tchana dokuwiki]# pwd /var/lib/nethserver/vhost/dokuwiki [root@tchana dokuwiki]#
On met à jour. Toutes les dernières modifications concernant la branche que nous utilisons seront appliquées.
[root@tchana dokuwiki]# git pull remote: Enumerating objects: 38, done. remote: Counting objects: 100% (38/38), done. remote: Total 48 (delta 38), reused 38 (delta 38), pack-reused 10 Unpacking objects: 100% (48/48), done. From https://github.com/splitbrain/dokuwiki b6bcbaa..9a6c154 master -> origin/master * [new branch] master2psr2 -> origin/master2psr2 Already up-to-date. [root@tchana dokuwiki]#
Si des mises à jour avaient été disponibles, elles auraient été installées.
Ajustement des droits
Après une mise à jour, il est toujours préférable d'ajuster les droits.
On renforce la sécurité de l’accès aux fichiers f en supprimant les droits à “other”.
L'option
-L
doit être avant le chemin pour suivre les Liens symboliques et le chemin doit se terminer par /.
[root@tchana dokuwiki]# find -L /var/lib/nethserver/vhost/dokuwiki/ -type f -exec chmod 640 {} \; [root@tchana dokuwiki]#
On répète l'opération pour les répertoires d.
[root@tchana dokuwiki]# find -L /var/lib/nethserver/vhost/dokuwiki/ -type d -exec chmod 2750 {} \; [root@tchana dokuwiki]#
On vérifie pour les fichiers, les répertoires et les fichiers cachés et de plus, “other” n'a aucun droits.
[root@tchana ~]# ls -als /var/lib/nethserver/vhost/dokuwiki/ total 132 4 drwxr-s--- 9 apache apache 4096 10 juin 15:18 . 0 drwxr-xr-x 4 apache apache 39 7 juin 10:10 .. 4 -rw-r-S--- 1 apache apache 1777 7 juin 14:30 appveyor.yml 0 drwxr-s--- 2 apache apache 160 7 juin 14:30 bin ... 0 lrwxrwxrwx 1 root apache 14 10 juin 15:17 conf -> /etc/dokuwiki/ ... 0 lrwxrwxrwx 1 root apache 22 10 juin 15:18 data -> /var/lib/dokuwiki/data ... 4 -rw-r-S--- 1 apache apache 344 7 juin 14:30 .editorconfig ... 4 -rw-r-S--- 1 apache apache 21 7 juin 14:30 VERSION [root@tchana ~]#
Instantané VirtualBox
À ce stade-ci, on peut prendre un instantané de la machine virtuelle afin de pouvoir y revenir en cas d'une future erreur de manipulation.
Mise à jour des Collections
Introduction
Présentement, nous n'avons qu'une seule Collection d'installée, PHP. Elle peut être mise à jour à la console du serveur.
Mises à jour
On lance la mise à jour de la Collection.
[root@tchana ~]# yum update -y nethserver-php-scl Modules complémentaires chargés : changelog, fastestmirror, nethserver_events ... Résumé de la transaction ============================================================================================ Mettre à jour 1 Paquet Taille totale des téléchargements : 96 k ... Mis à jour : nethserver-php-scl.x86_64 0:1.2.6-1.ns7.sdl Terminé ! [root@tchana ~]#
La mise à jour disponible a été installée.
La mise à jour du Serveur NethServer s'occupe aussi de celle de la Collection PHP.
Dans la commande ci-dessus, on peut omettre l'option -y et
yum
demandera si on veut mette a jour. Il suffit de répondre y ou n pour oui ou non.
Instantané VirtualBox
À ce stade-ci, on peut prendre un instantané de la machine virtuelle afin de pouvoir y revenir en cas d'une future erreur de manipulation.
Mises à jour de NethServer
Serveur NethServer
De temps à autre, il faut mettre à jour le Serveur NethServer pour diverses raisons: suite à des mises à jour des logiciels qui composent NethServer, failles de sécurité découvertes par des utilisateurs ou des développeurs, etc.
Instantané VirtualBox
À ce stade-ci, on peut prendre un instantané de la machine virtuelle afin de pouvoir y revenir en cas d'une future erreur de manipulation.
Appendices
Écran conventionnel de démarrage
Si nous voulons voir l'écran conventionnel de démarrage tel que ci-contre, il suffit de supprimer un seul paramètre dans le fichier de configuration de grub:
/etc/default/grub
Suppression du paramètre rhgb
Ligne originale dans le fichier /etc/default/grub
.
GRUB_CMDLINE_LINUX="crashkernel=auto rd.lvm.lv=VolGroup/lv_root rd.lvm.lv=VolGroup/lv_swap nodmraid rhgb quiet"
Après avoir enlevé le paramètre rhgb.
GRUB_CMDLINE_LINUX="crashkernel=auto rd.lvm.lv=VolGroup/lv_root rd.lvm.lv=VolGroup/lv_swap nodmraid quiet"
On signale le changement en régénérant le fichier de configuration.
[root@tchana ~]# grub2-mkconfig -o /boot/grub2/grub.cfg Generating grub configuration file ... Found linux image: /boot/vmlinuz-3.10.0-957.5.1.el7.x86_64 Found initrd image: /boot/initramfs-3.10.0-957.5.1.el7.x86_64.img Found linux image: /boot/vmlinuz-3.10.0-957.el7.x86_64 Found initrd image: /boot/initramfs-3.10.0-957.el7.x86_64.img Found linux image: /boot/vmlinuz-0-rescue-8ee070fd1a7a4e8daf17a7dae9f85ac1 Found initrd image: /boot/initramfs-0-rescue-8ee070fd1a7a4e8daf17a7dae9f85ac1.img done [root@tchana ~]#
Au prochain réamorçage, le nouveau fichier
grub
sera effectif.
Nom du serveur dans l'écran de connexion à Webmail
À l'écran de connexion à Webmail, dans le champ Serveur, le nom du domaine principal du serveur apparaît.
On peut supprimer complètement l'affichage de cette ligne. Utile surtout si nous avons plusieurs domaines hébergés sur le Serveur NethServer, car peu importe le domaine auquel nous nous connectons, c'est toujours le nom du domaine principal qui est affiché.
Pour supprimer l'affichage de cette ligne, il nous faut modifier le fichier de configuration de PHP:
/etc/roundcubemail/config.inc.php
et y ajouter la ligne suivante: config['default_host'] = '127.0.0.1';
.
Par contre, si nous modifions directement ce fichier, le prochain ré-amorçage écrasera la modification lorsque le serveur assemblera les gabarits de configuration du système.
Il nous faut donc créer un gabarit personnalisé et y insérer la nouvelle ligne de configuration. Ainsi, lors de l'assemblage des gabarits, le serveur incorporera le gabarit personnalisé au gabarit standard de configuration de PHP.
Création du répertoire pour le gabarit personnalisé.
[root@tchana ~]# mkdir -p /etc/e-smith/templates-custom/etc/roundcubemail/config.inc.php [root@tchana ~]#
On crée le fichier 91CacherNomDuServeur et on y insère la ligne de configuration.
Prendre tout le contenu de l'encadré pour la commande.
cat > /etc/e-smith/templates-custom/etc/roundcubemail/config.inc.php/91CacherNomDuServeur <<'EOT' $config['default_host'] = '127.0.0.1'; EOT
On vérifie.
[root@tchana ~]# cat /etc/e-smith/templates-custom/etc/roundcubemail/config.inc.php/91CacherNomDuServeur $config['default_host'] = '127.0.0.1'; [root@tchana ~]#
Il n'y a pas de ligne vide avant $config… Nous en avons inséré une pour faciliter la copie de la commande.
On signale le changement.
[root@tchana ~]# expand-template /etc/roundcubemail/config.inc.php [root@tchana ~]#
On redémarre le démon httpd.
[root@tchana ~]# systemctl restart httpd [root@tchana ~]#
On se rend à l'URL de connexion à Webmail: https://www.micronator-dev.org/webmail/. Le domaine du serveur ne s'affiche plus.
Sauvegarde
On vérifie si le nom du fichier /etc/e-smith/templates-custom/etc/roundcubemail/
est déjà présent dans le fichier d'inclusion de la sauvegarde des données: /etc/backup-data.d/custom.include
, sinon on l'insère.
Prendre tout le contenu de l'encadré pour la commande.
NouvelleInclusion="/etc/e-smith/templates-custom/etc/roundcubemail/" if grep -Fxq "$NouvelleInclusion" /etc/backup-data.d/custom.include then # L'entrée a été trouvée dans custom.include echo -e "\nLe fichier custom.include contient déjà l'entrée:\n$NouvelleInclusion \n" else # L'entrée n'a pas été trouvée dans custom.include echo -e "$NouvelleInclusion" >> /etc/backup-data.d/custom.include echo -e "\nL'entrée: $NouvelleInclusion a été ajoutée\n" fi
On vérifie.
[root@tchana ~]# cat /etc/backup-data.d/custom.include | grep roundcube /etc/e-smith/templates-custom/etc/roundcubemail/ [root@tchana ~]#
Ci-dessus, il n'y a pas de ligne vide avant /etc/e-smith/templates-custom/etc/roundcubemail/. Nous en avons inséré une afin de faciliter la copie de la commande.
Langue à la console du serveur
On affiche les langues offertes à la console du serveur.
[root@tchana ~]# localectl list-locales | grep fr_ fr_BE fr_BE.iso88591 fr_BE.iso885915@euro fr_BE.utf8 fr_BE@euro fr_CA fr_CA.iso88591 fr_CA.utf8 fr_CH fr_CH.iso88591 fr_CH.utf8 fr_FR fr_FR.iso88591 fr_FR.iso885915@euro fr_FR.utf8 fr_FR@euro fr_LU fr_LU.iso88591 fr_LU.iso885915@euro fr_LU.utf8 fr_LU@euro [root@tchana ~]#
On ajuste la langue désirée pour l'affichage à la console du serveur.
[root@tchana ~]# localectl set-locale LANG=fr_FR.utf8 [root@tchana ~]#
Les modifications entreront en vigueur après le prochain redémarrage.
Cette commande fera en sorte que la langue par défaut à l'écran de login de l'interface Web sera Français (France).
À la console du serveur, après le prochain redémarrage, on pourra vérifier la langue d'affichage du système, en lançant la commande ci-dessous.
[root@tchana ~]# ls -als toto ls: impossible d'accéder à toto: Aucun fichier ou dossier de ce type [root@tchana ~]#
Langue de l'interface Web
On change la langue de l'interface.
Table de mappe de clavier
On affiche les différentes mappes de clavier2) “ca” disponibles.
[root@tchana ~]# localectl list-keymaps | grep ca ca ca-eng ca-fr-dvorak ca-fr-legacy ca-multi ca-multix dvorak-ca-fr es-cat ph-capewell-dvorak ph-capewell-qwerf2k6 [root@tchana ~]#
On active le clavier ca-multi.
[root@tchana ~]# localectl set-keymap ca-multi [root@tchana ~]#
On vérifie.
[root@tchana ~]# localectl System Locale: LANG=fr_FR.UTF-8 VC Keymap: ca-multi X11 Layout: us [root@tchana ~]#
Fermeture automatique de session (session timeout)
Référence: http://docs.nethserver.org/en/v7/access.html#session-timeouts.
Par défaut (à partir de NethServer 7.5.1804), une session de gestion du serveur se termine après 60 minutes d'inactivité (délai d'inactivité) et expire 8 heures après la connexion (durée de vie de la session).
La commande ci-dessous définit 2 heures de délai d'inactivité et 16 heures de durée de vie de session maximale. Le temps est exprimé en secondes.
[root@tchana ~]# config setprop httpd-admin MaxSessionIdleTime 7200 MaxSessionLifeTime 57600 [root@tchana ~]#
Désactivation des délais.
[root@tchana ~]# config setprop httpd-admin MaxSessionIdleTime '' MaxSessionLifeTime '' [root@tchana ~]#
Les nouvelles valeurs de délais affecteront les nouvelles sessions. Ils ne changent aucune session active.
Fuseau horaire
Pour le fuseau horaire, il existe un fichier pour Montréal.
[root@tchana ~]# ls -ls /usr/share/zoneinfo/America/ -> grep Montreal 4 -rw-r--r-- 3 root root 3477 1 avril 08:27 Montreal [root@tchana ~]#
Changement du fuseau horaire
On affiche le fuseau horaire actuel.
[root@tchana ~]# ls -l /etc/localtime lrwxrwxrwx 1 root root 37 19 mai 23:48 /etc/localtime -> ../usr/share/zoneinfo/America/Toronto [root@tchana ~]#
On change le fuseau horaire pour celui de Montréal.
[root@tchana ~]# timedatectl set-timezone America/Montreal [root@tchana ~]#
On vérifie.
[root@tchana ~]# ls -l /etc/localtime lrwxrwxrwx 1 root root 38 22 mai 14:02 /etc/localtime -> ../usr/share/zoneinfo/America/Montreal [root@tchana ~]#
Voilà! Le fuseau horaire Montréal est récupéré…
Certificat Let's Encrypt
Description
Un certificat émis par l'autorité de certification Let's Encrypt vous permettra de chiffrer les connexions de votre serveur avec une clé TLS/SSL reconnue mondialement. Les utilisateurs pourront utiliser https.
Référence: https://fr.wikipedia.org/wiki/Let's_Encrypt.
Let's Encrypt est une autorité de certification (CA) lancée le 3 décembre 2015 (Bêta Version Publique). Cette autorité fournit des certificats gratuits X.509 pour le protocole cryptographique TLS au moyen d'un mécanisme automatisé destiné à se passer du processus complexe actuel impliquant la création manuelle, la validation, la signature, l'installation et le renouvellement des certificats pour la sécurisation des sites Internet.
Examen du certificat
On examine le certificat émis par Let's Encrypt pour notre serveur dorgee.micronator-101.org qui est directement branché à l'Internet.
Si la demande de certificat a fonctionnée sans erreur, essayez de vous connecter à la page de l'interface Web du Serveur NethServer. Le certificat devrait incorporer tous les noms d'hôtes que vous avez inclus et être valide pour les quatre-vingt-dix prochains jours.
On se connecte à l'interface Web: https://www.micronator-101.org:980.
- Onglet Détails.
- Émis pour micronator-101.org
- Émis par Let's Encrypt Authority X3
- On voit la date de début et de fin.
- Nom alternatif du sujet du certificat.
- Tous nos CNAME choisis lors de la demande du certificat sont affichés.
- Fermer toutes les fenêtres du certificat.
Vérification par Qualsys SSLLabs
Seulement pour un serveur directement branché à l'Internet.
Une fois que vous avez obtenu votre certificat, testez-le en vous rendant chez Qualsys SSLLabs, https://www.ssllabs.com/ssltest/.
Soumettez le nom FQDN de votre domaine pour vérifier que le certificat fonctionne correctement.
Changement du mot de passe de root
Référence: https://www.rootusers.com/how-to-reset-root-user-password-in-centos-rhel-7/.
Réinitialiser le mot de passe de root est normalement une tâche simple si vous êtes déjà connecté avec les privilèges de root. Toutefois, si vous oubliez le mot de passe et devez le changer, les choses deviennent un peu plus difficiles.
Le processus a changé de la version 6 de CentOS/RHEL (Red Hat Enterprise Linux) à la version 7. Auparavant, vous démarriez en mode mono-utilisateur, puis changiez le mot de passe en tant qu'utilisateur root. À partir de la version 7, les modes équivalents sont: mode de secours et mode d’urgence. Cependant, ces modes d'opération nécessitent le mot de passe de root avant de pouvoir faire quoi que ce soit. Cette section va vous guider dans le nouveau processus pour changer le mot de passe perdu de root. Cette procédure sera exécutée à la console du système Linux, assurez-vous donc que vous y avez accès avant de commencer.
Comme pour toutes les tâches de maintenance du système, assurez-vous de disposer d'une sauvegarde/instantané du système avant de poursuivre.
Si votre système Linux est en cours d'exécution, redémarrez-le. S'il ne roule pas, démarrez-le.
Pour CentOS 7, le menu de démarrage vous laissera 5 secondes pour sélectionner le noyau du système d’exploitation à démarrer. Ces 5 secondes sont importantes, car elles permettent aux administrateurs de sélectionner différents noyaux ou d’éditer les paramètres du noyau existant avant le démarrage.
Dans le menu de démarrage, appuyez sur “e” pour modifier le noyau existant tel qu'indiqué ci-dessous.
Dans les options de grub, recherchez la ligne qui commence par linux16
et allez à la fin. Entrez rd.break
à la fin de cette ligne tel qu'indiqué ci-dessous.
rd.break
Appuyez sur [Ctrl] + [x] pour démarrer avec ces options qui vous amèneront à l'invite initramfs avec un shell root.
À ce stade, le système de fichiers racine est monté en mode lecture seule (ro) dans le répertoire /sysroot
et doit être remonté avec les autorisations de lecture/écriture (rw) pour que nous puissions réellement apporter certaines modifications. Ceci est réalisé avec la commande mount -o remount,rw /sysroot
.
switch_root:/# mount -o remount,rw /sysroot switch_root:/#
Une fois le système de fichiers remonté, changez-le en une prison chroot afin que le répertoire /sysroot
soit utilisé comme racine du système de fichiers. Ceci est nécessaire pour que toutes les commandes que nous exécuterons se rapportent à /sysroot
. La commande à lancer est chroot /sysroot
.
switch_root:/# chroot /sysroot sh-4.2#
À partir d'ici, le mot de passe de root peut être réinitialisé à l’aide de la commande passwd
.
sh-4.2# passwd Changing password for user root. New password: Nouveau-mot-de-passe-de-root Retype new passwd: Nouveau-mot-de-passe-de-root passwd: all authentification tokens updated successfully. sh-4.2#
Si vous n'utilisiez pas SELinux, vous pourriez redémarrer à ce stade et tout irait bien. Cependant, par défaut, CentOS/RHEL-7 active SELinux. Nous devons donc corriger le contexte du fichier /etc/shado
w. En effet, lorsque la commande passwd
est exécutée, elle crée un nouveau fichier /etc/shadow
. SELinux n'étant pas en cours d'exécution dans ce mode, le fichier est créé sans aucun contexte SELinux, ce qui peut entraîner des problèmes lors du redémarrage.
On crée le fichier /.autorelabel
à l’aide de touch
.
sh-4.2# touch /.autorelabel sh-4.2#
La création de ce fichier effectuera automatiquement un ré-étiquetage de tous les fichiers au prochain démarrage. Notez que cela peut prendre un certain temps en fonction de la quantité de fichiers que vous avez. Peut prendre environ 2 minutes pour un serveur CentOS-7 ordinaire.
On quitte l'environnement chroot.
sh-4.2# exit exit sh-4.2#
On quitte le shell racine initramfs (peut prendre un certain temps, être patient…). Le serveur s'amorce.
sh-4.2# exit logout ...
Vérification
À la console du serveur, vous devriez pouvoir vous connecter et utiliser le système avec le nouveau mot de passe que vous avez créé.
ERROR Failed to send host log message
Cette erreur s'affiche seulement lors de l'amorçage d'un serveur roulant sous VirtualBox.
- On arrête le Serveur NethServer.
- À l'écran VirtualBox, on sélectionne la machine → État actuel → Configuration.
Au retour, on amorce le Serveur NethServer et le message ne s'affichera plus.
Martian source
Si dans le fichier journal /var/log/messages
, vous voyez plusieurs lignes telles que ci-dessous, c'est que l'IP de la passerelle du réseau vert de la carte enp0s3 ou les Serveurs DNS ne sont corrects.
...IPv4: martian source 192.168.1.1... ...IPv4: martian source 192.168.1.1... ...IPv4: martian source 192.168.1.1...
Passerelle du réseau de la carte enp0s3
On trouve notre passerelle en lançant un traceroute
vers google.com
[root@dorgee ~]# traceroute google.com traceroute to google.com (172.217.165.14), 30 hops max, 60 byte packets 1 lo0-0-lns03-tor.teksavvy.com (206.248.155.139) 10.367 ms 11.449 ms 11.487 ms 2 ae0-2150-bdr01-tor.teksavvy.com (69.196.136.172) 11.523 ms 11.793 ms 11.826 ms 3 72.14.212.134 (72.14.212.134) 11.868 ms 12.430 ms 12.306 ms 4 74.125.244.161 (74.125.244.161) 12.736 ms 74.125.244.145 (74.125.244.145) 14.002 ms 74.125.244.161 (74.125.244.161) 13.174 ms 5 216.239.40.255 (216.239.40.255) 13.577 ms 13.923 ms 216.239.41.175 (216.239.41.175) 13.923 ms 6 yyz12s06-in-f14.1e100.net (172.217.165.14) 13.020 ms 12.009 ms 11.291 ms [root@dorgee ~]#
L'adresse IP de la ligne #1 est 206.248.155.139 et elle est donc la passerelle utilisée par notre connexion.
Configuration → Réseau → Périphérique enp0s3 → Éditer.
On change l'IP de la passerelle pour l'IP de l'interface vert / enp0s3 → 206.248.155.139.
SOUMETTRE.
Serveurs DNS
Référence: https://korben.info/1-1-1-1-ou-9-9-9-9-ou-8-8-8-8-quel-dns-choisir.html.
… Le DNS de Cloudflare est un bon DNS, car il est le plus rapide, mais aussi parce qu'ils ont pris les devants et s'engagent à ne pas revendre les données, et ne conservent pas les logs au-delà de 24h…
Le principal avantage bien sûr, c'est que contrairement au DNS de Google qui permet de mieux vous profiler pour vous balancer de la pub, on sait que Cloudflare ne trempe pas là dedans. Cela reste une boîte américaine, donc c'est évidemment à prendre avec toutes les précautions d'usage…
Référence: pour 8.8.8.8 - https://www.dnsperf.com/dns-resolver/google.
Autre référence: comparaison mondiale des performances de différents DNS:
https://medium.com/@nykolas.z/dns-resolvers-performance-compared-cloudflare-x-google-x-quad9-x-opendns-149e803734e5.
Référence: pour ci-dessous 1.1.1.1 - https://www.dnsperf.com/#!dns-resolvers.
Configuration → Réseau → Serveurs DNS.
On ajuste le DNS Primaire et Secondaire.
Le serveur DNS primaire 1.1.1.1 est le plus rapide et le plus utilisée de tout l'Internet.
Le serveur DNS secondaire 206.248.182.3 est le défaut de notre FAI.
Soumettre.
Si votre FAI filtre l'adresse 1.1.1.1, prendre 8.8.8.8 ou une de celles citées dans la référence ci-dessous:
https://medium.com/@nykolas.z/dns-resolvers-performance-compared-cloudflare-x-google-x-quad9-x-opendns-149e803734e5.
Serveur de production
Une fois que vous maîtrisez tous les aspects de: DokuWiki, Let's Encrypt, Fail2ban, ClamAV et de BackupPC, vous pouvez créer un réseau de Production incluant un serveur DokuWiki, un serveur de sauvegardes et un serveur de développement; ce qui est le but ultime que nous vous souhaitons.
Victoire totale, hissons la bannière de la victoire.
Crédits
© 2019 RF-232
Auteur: Michel-André
Remerciement: Tous les contributeurs GNU/GPL
Intégré par: Michel-André Robillard CLP
Contact: michelandre at micronator.org
Répertoire de ce document: E:\000_DocPourRF232_general\RF-232_NethServer-201\RF-232_Cours_NethServer-201-04_DokuWiki_2019-08-16_14h13.odt.
Historique des modifications:
Version | Date | Commentaire | Auteur |
---|---|---|---|
RC-0.0.1 | 2019-06-07 | Début. | Michel-André |
0.1.0 | 2019-08-15 | Ajustements pour DokuWiki. | Michel-André |
0.1.1 | 2019-08-19 | Suppression du “sticky bit” pour les fichiers | Michel-André |
12345678901 | 12345678901 |
<html><hr style=“width:50%; margin: 0 auto;”></html>
AVIS DE NON-RESPONSABILITÉ
Ce document est uniquement destiné à informer. Les informations, ainsi que les contenus et fonctionnalités de ce document sont fournis sans engagement et peuvent être modifiés à tout moment. RF‑232 n'offre aucune garantie quant à l'actualité, la conformité, l'exhaustivité, la qualité et la durabilité des informations, contenus et fonctionnalités de ce document. L'accès et l'utilisation de ce document se font sous la seule responsabilité du lecteur ou de l'utilisateur.
RF‑232 ne peut être tenu pour responsable de dommages de quelque nature que ce soit, y compris des dommages directs ou indirects, ainsi que des dommages consécutifs résultant de l'accès ou de l'utilisation de ce document ou de son contenu.
Chaque internaute doit prendre toutes les mesures appropriées (mettre à jour régulièrement son logiciel antivirus, ne pas ouvrir des documents suspects de source douteuse ou non connue) de façon à protéger le contenu de son ordinateur de la contamination d'éventuels virus circulant sur la Toile.
Toute reproduction interdite Vous reconnaissez et acceptez que tout le contenu de ce document, incluant mais sans s’y limiter, le texte et les images, sont protégés par le droit d’auteur, les marques de commerce, les marques de service, les brevets, les secrets industriels et les autres droits de propriété intellectuelle. Sauf autorisation expresse de RF-232, vous acceptez de ne pas vendre, délivrer une licence, louer, modifier, distribuer, copier, reproduire, transmettre, afficher publiquement, exécuter en public, publier, adapter, éditer ou créer d’oeuvres dérivées de ce document et de son contenu.
Avertissement
Bien que nous utilisions ici un vocabulaire issu des techniques informatiques, nous ne prétendons nullement à la précision technique de tous nos propos dans ce domaine.
Référence: https://fr.wikipedia.org/wiki/Fully_qualified_domain_name.
Référence: http://www.granddictionnaire.com/ficheOqlf.aspx?Id_Fiche=18050861#eng.