Koken

Installation de Koken avec Nginx, PHP7-FPM, MariaDB et SSL/TLS – Ubuntu Server 16.04 LTS

Vous êtes photographe ou créatif et vous souhaitez publier vos réalisations sur le web en déployant votre propre site ? Rapide, simple et gratuit, Koken est peut-être la solution qu’il vous faut…

Koken est un CMS simple d’utilisation qui permettra de présenter vos travaux en quelques clics.

Côté back office, Koken dispose de nombreuses fonctionnalités comme la gestion de collections, un système avancé de tags et catégories, une gestion privée de ressources (pour partager uniquement à votre famille ou à vos clients par exemple), une synchronisation avec Lightroom et bien sûr de nombreuses options pour personnaliser le thème et la navigation. Koken dispose notamment d’un store pour ajouter des extensions et disposer ainsi de fonctionnalités supplémentaires.

D’un point de vue front office, Koken propose plusieurs thèmes mettant en avant facilement vos photos en haute qualité. Construit pour répondre aux contraintes actuelles du web, votre site sera responsive et s’adaptera en fonction de la résolution de l’utilisateur.

Koken

1 – Nginx

Notre choix se portera sur le serveur HTTP Nginx pour une question de performances. Nginx est reconnu pour ses hautes performances, sa stabilité, son ensemble de fonctionnalités, sa configuration simple ainsi que sa faible consommation en ressources.

1.1 – Installation de Nginx

Installez le paquet nginx et ses dépendances :

1.2 – Configuration de Nginx

Modifiez les directives suivantes du fichier de configuration Nginx /etc/nginx/nginx.conf :

  • worker_processes 8; : l’un des paramètres à ajuster immédiatement est le worker_processes. Pour profiter pleinement de la puissance de votre serveur, il est recommandé de mettre autant de worker_processes que de cœurs disponibles sur votre serveur. Pour connaître le nombre de cœurs sur votre serveur, il suffit de lancer la commande :
  • server_tokens off; : pour des raisons de sécurité, il est recommandé de désactiver l’envoi d’informations telles que le numéro de version de votre Nginx. Pour cela, décommentez cette directive dans le bloc http.

2 – Installation et téléchargement de Koken

  • Téléchargez la dernière version de Koken :
  • Installez le paquet unzip si celui-ci n’est pas installé sur votre serveur :
  • Décompressez l’archive Koken :
  • Supprimez l’archive téléchargée :

3 – Droits Unix

L’archive Koken précédemment téléchargée et décompressée dans le dossier /var/www/koken contient un seul fichier index.php. Ce fichier est un script PHP d’installation qui, lors de son exécution dans votre navigateur, téléchargera automatiquement la dernière version des fichiers nécessaires au fonctionnement de Koken et créera notamment les fichiers de configuration nécessaires à la connexion à votre base de données koken.

Lors du déploiement basique d’un serveur HTTP, l’utilisateur sous lequel fonctionne ce serveur (Apache, Nginx…) est la plupart du temps www-data, nobody ou apache. Cela signifie que si plusieurs sites existent sous la même instance de Nginx, tous utilisent le même utilisateur. Or si l’un des sites s’avère corrompu par un utilisateur malveillant alors l’assaillant peut profiter pleinement de tous les droits de l’utilisateur sous lequel tourne le serveur web. Tous les sites s’avèrent donc vulnérables.

Pour des raisons évidentes de sécurité, il est donc recommandé de cloisonner ces utilisateurs et d’avoir un utilisateur dédié à la gestion du dossier koken. Cet utilisateur aura des droits aussi restreints que possible à ce répertoire.

Nous verrons un peu plus loin, dans le chapitre dédié à PHP-FPM, que les processus PHP seront lancés sous l’utilisateur koken. Cet utilisateur doit donc avoir accès aux fichiers PHP de Koken. Par ailleurs, Nginx est lancé sous l’utilisateur www-data et doit avoir accès en lecture au répertoire /var/www/koken pour lire les ressources statiques (HTML, CSS, JS, etc.). Nous allons donc attribuer le répertoire /var/www/koken à l’utilisateur koken et au groupe www-data.

  • Créez un utilisateur koken :
  • Modifiez le propriétaire et le groupe du répertoire /var/www/koken :

4 – PHP-FPM

Le module PHP-FPM permet la communication entre le serveur Nginx et PHP, basée sur le protocole FastCGI. Ce module, écoutant sur le port 9000 par défaut ou sur un socket UNIX, permet notamment l’exécution de scripts PHP dans un processus indépendant de Nginx avec des UID et GID différents. Il sera alors possible, dans le cas de la gestion de plusieurs applications sur un même serveur, de créer et configurer un groupe (appelé aussi pool) par application. Un pool définit notamment le UID/GID des processus PHP et le nombre de processus minimum, maximum ou encore le nombre de processus en attente à lancer.

4.1 – Installation

Installez le paquet php-fpm et les modules nécessaires à Koken :

Vous devez disposer d’une version de PHP égale ou supérieure à 5.3.
Pour connaître la version installée sur votre système, tapez la commande suivante :

4.2 – Création du pool koken

Créez le pool dédié à Koken en créant le fichier de configuration suivant : /etc/php/7.0/fpm/pool.d/koken.conf

Certaines valeurs sont très arbitraires et seront, en fonction des ressources disponibles sur votre serveur et celles que vous souhaiterez dédier à votre Koken, différentes d’une configuration à l’autre. Cependant ces différentes directives respectent certaines conditions :

  • [koken] : nom du pool. Il est possible de créer plusieurs pools par fichier. Chaque pool doit commencer par cette directive.
  • listen : interface d’écoute des requêtes. Les syntaxes acceptées sont ADRESSE_IP:PORT (exemple : listen = 127.0.0.1:9000) et /path/to/unix/socket (exemple : listen = /var/run/koken.sock). Le socket est représenté comme un simple fichier sur le système et permet d’interfacer des processus entre eux sans passer par la couche réseau du système, ce qui est inutile lorsque Nginx et PHP-FPM sont hébergés sur le même serveur. Je vous conseille donc d’utiliser un socket.
  • listen.owner & listen.group : affecte l’utilisateur et le groupe au socket Unix si utilisé. Ces deux paramètres peuvent être associés au paramètre listen.mode qui définit les permissions du socket (660 par défaut). Il est important que Nginx ait les doits de lecture sur le socket Unix.
  • user & group : utilisateur et groupe sous lesquels le pool de processus sera exécuté. Cet utilisateur et ce groupe doivent bien sûr exister sur votre système et surtout accéder aux fichiers PHP de votre Koken. Cela veut dire aussi que chaque fichier et répertoire créé dans Koken appartiendra à cet utilisateur et à ce groupe. Comme nous l’avons vu dans le chapitre dédié aux droits Unix, chaque fichier devra appartenir à l’utilisateur koken et au groupe www-data.
  • pm : directive acceptant les 3 valeurs suivantes : static, dynamic et ondemand.
    • static : les processus, au nombre de pm.max_children, sont continuellement actifs (quelle que soit la charge et l’affluence de votre Koken) et sont susceptibles de consommer de la mémoire inutilement. Cette directive est recommandée si Koken est l’unique application de votre serveur.
    • dynamic : le nombre de processus fils pourra varier suivant la charge. Cependant, nous gardons le contrôle sur le nombre de processus fils à créer au démarrage du serveur, le nombre de processus maximum, en attente de requêtes, etc. Les directives suivantes deviennent obligatoires : pm.max_children, pm.start_servers, pm.min_spare_servers, pm.max_spare_servers. Cette directive est recommandée si vous avez plusieurs pools avec un fort trafic (plus de 10 000 requêtes/jour).
    • ondemand : aucun processus fils n’est lancé au démarrage du serveur, les processus s’activent à la demande et auront une durée de vie définie par la directive pm.process_idle_timeout. L’intérêt de cette directive est de libérer de la mémoire en cas de faible charge mais celle-ci peut légèrement augmenter le temps de réponse de votre Koken. Cette directive est recommandée si vous avez plusieurs pools avec potentiellement une faible affluence.

    Sachant que l’utilisation de Koken est personnelle et souvent limitée à quelques utilisateurs, nous choisirons et détaillerons ici la directive ondemand.

  • pm.max_children : nombre maximum de processus fils. La valeur du paramètre pm.max_children varie d’un système à l’autre. Voici la procédure à réaliser pour déterminer la valeur de ce paramètre :
    • Arrêtez le service php-fpm :

    • Affichez la mémoire disponible (colonne available) sur votre système :

      Sur cet exemple, le système dispose de 3539Mo de RAM disponible. La quantité de RAM que vous souhaitez allouer au maximum à Koken dépend de vous et des autres services actifs que vous disposez sur ce même système. Dans notre exemple, nous partirons du principe que nous souhaitons allouer au maximum 1024Mo de RAM à Koken.

    • Affichez la mémoire utilisée par un processus fils php-fpm :

    • Déterminez le nombre de pm.max_children en appliquant la méthode de calcul suivante :

      pm.max_children = mémoire allouée / mémoire utilisée par un processus fils
      Dans notre exemple : 1024 / 18 = 56

    • Éditez à nouveau le fichier /etc/php/7.0/fpm/pool.d/koken.conf et ajustez la valeur du paramètre pm.max_children :

  • pm.process_idle_timeout : durée en secondes avant qu’un processus fils inactif soit détruit.
  • pm.max_requests : nombre de requêtes que chaque processus fils devra exécuter avant d’être détruit. Cette valeur ne doit pas être trop élevée afin de contourner d’éventuelles fuites mémoires, ni trop faible pour ne pas solliciter régulièrement le CPU à chaque création de processus fils. 500 reste une valeur recommandée.
  • env[*] : variables d’environnement nécessaires à PHP-FPM.

Redémarrez le service php-fpm afin d’activer le nouveau pool koken :

4.3 – Configuration du service php-fpm

Enfin, il est nécessaire de spécifier à PHP-FPM les permissions de chaque fichier ou répertoire nouvellement créé dans votre Koken et ainsi respecter les permissions que nous avions spécifiées dans le chapitre des droits Unix. Pour cela :

  • Tapez la commande suivante :
  • Ajoutez les lignes suivantes :
  • Réactivez le service php7.0-fpm :

5 – Création de la base de données sous MariaDB

5.1 – Installation de MariaDB

Installez les paquets suivants :

5.2 – Configuration de MariaDB

Lancez le script de configuration (recommandé) :

5.3 – Création de la base de données koken

  • Tout d’abord, connectez-vous sur l’interface MySQL avec l’utilisateur root et grâce au mot de passe saisi lors de la configuration de MariaDB :

  • Créez la base de données koken :

    Tout comme pour la gestion du répertoire koken et pour plus de sécurité, vous allez tout d’abord créer un utilisateur MySQL koken dédié à la base de données koken, renseigner un mot de passe et ensuite lui donner les droits sur cette base de données :

6 – Nom de domaine & virtual host

  • Créez le fichier suivant /etc/nginx/sites-available/koken et modifiez les lignes en surbrillance en fonction de votre configuration :
  • Activez le virtual host :
  • La nouvelle configuration sera prise en compte après redémarrage des services Nginx et PHP-FPM :

7 – SSL/TLS avec Let’s Encrypt

Let’s Encrypt est une autorité de certification libre, automatisée et ouverte. Cette autorité fournit des certificats gratuits X.509 pour le protocole cryptographique SSL/TLS au moyen d’un processus 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. En juin 2017, Let’s Encrypt a livré plus de 40 millions de certificats.

7.1 – Installation

Installez les paquets software-properties-common et certbot :

7.2 – Génération des certificats

Let’s Encrypt permet de générer de différentes façons plus ou moins automatisées un certificat. La méthode standalone permet de générer simplement un certificat. En revanche, celle-ci demande d’arrêter le serveur Nginx et ceci est valable à chaque renouvellement dudit certificat. Il existe aussi des plugins Apache et Nginx entièrement automatisés. Ces plugins mettent à jour automatiquement la configuration des virtual hosts mais le plugin Nginx est encore expérimental. Dans cet article, nous recommandons d’utiliser le plugin webroot pour Nginx qui permet de générer et renouveler son certificat sans interrompre le serveur Nginx.

Le plugin webroot crée un fichier temporaire /var/www/koken/.well-known/acme-challenge dans le dossier racine de votre Koken, celui-ci permettra aux serveurs de Let’s Encrypt de valider votre certificat en appelant ce fichier temporaire.

  • Générez votre certificat en remplaçant [email protected] et koken.mondomaine.com par vos informations personnelles :
    Vous obtiendrez 4 fichiers dans le répertoire /etc/letsencrypt/live/koken.mondomaine.com :

    • cert.pem : le certificat de votre domaine koken.mondomaine.com
    • chain.pem : le certificat Let’s Encrypt
    • fullchain.pem : les certificats cert.pem et chain.pem combinés
    • privkey.pem : la clé privée du certificat.
  • SSL/TLS utilise un système de chiffrement asymétriques (comme RSA ou Diffie-Hellman) afin de sécuriser les échanges de vos flux. Par défaut, Nginx utilise une clé de 1048 bits. En augmentant la longueur de la clé à 4096 bits, vous augmenterez ainsi la sécurité de votre protocole SSL/TLS.

    Générez une nouvelle clé Diffie-Hellman (DH) de 4096 bits et attribuez-lui un minimum de permissions :

  • Ajoutez ou modifiez les lignes en surbrillance dans votre virtual host (/etc/nginx/sites-available/koken) en remplaçant les chemins des directives ssl_certificate, ssl_certificate_key, ssl_trusted_certificate et ssl_dhparam par l’emplacement de vos certificats et de la clé DH précédemment générés :

  • Rechargez votre configuration Nginx :

7.3 – Renouvellement automatique du certificat

Les certificats délivrés par Let’s Encrypt sont valides 90 jours. L’outil certbot fournit une option renew permettant de renouveler l’ensemble des certificats présents sur votre serveur si et seulement si ceux-ci expirent dans moins de 30 jours.

Nous allons créer une règle crontab où le script de renouvellement sera planifié pour exécution tous les lundis à 23h42. Les traces liées à l’exécution du script seront enregistrées dans un fichier /var/log/le-renew.log.

  • Éditez la crontab :
  • Ajoutez la ligne suivante :
  • Sauvegardez et quittez.

8 – HTTP2

Je vous conseille vivement d’activer le nouveau protocole HTTP2 qui augmentera la sécurité et la rapidité de votre Koken.

HTTP2 permet notamment :

  • la compression des headers des requêtes et des réponses qui permet de réduire la bande passante lorsque les headers (comme les cookies) sont similaires
  • le multiplexage des requêtes au serveur consistant à faire passer de multiples informations via un seul tuyau de transmission. Ainsi, on économise les multiples connexions entre le client et le serveur. Les requêtes, quant à elles, sont effectuées simultanément par le navigateur. Les requêtes ne se suivent donc plus les unes derrière les autres (HTTP1) et les plus prioritaires (CSS par exemple) ne sont plus bloquées par les moins prioritaires (images par exemple)
  • le push des ressources du serveur au navigateur. Désormais, le serveur pourra envoyer l’ensemble des ressources référencées dans une même page (CSS, JS…), avant même que le navigateur n’ait analysé celle-ci.

L’activation du protocole HTTP2 est très simple et consiste en l’ajout de la directive http2 dans votre virtual host :

Une fois la modification effectuée, n’oubliez pas de recharger votre configuration Nginx :

9 – Améliorer les performances de votre Koken avec OPcache

OPcache (qui signifie Optimizer Plus Cache) est introduit depuis la version 5.5.0 de PHP. Il sert à cacher l’opcode de PHP, c’est-à-dire les instructions de bas niveau générées par la machine virtuelle PHP lors de l’exécution d’un script. Autrement dit, le code pré-compilé est stocké en mémoire. Cela évite ainsi l’étape de compilation à chaque requête PHP. De plus, OPcache va optimiser l’exécution du code afin d’en améliorer les performances.

  • Éditez le fichier /etc/php/7.0/fpm/php.ini, décommentez et modifiez les lignes suivantes dans la section [opcache] :
  • La nouvelle configuration sera prise en compte après redémarrage du service PHP-FPM :

10 – Koken

Lancez votre navigateur et rendez-vous à l’adresse suivante : http://koken.mondomaine.com/.

[Cliquez sur les images pour suivre chaque étape de la configuration de Koken]

A la fin de l’installation, vous serez redirigé vers l’interface d’administration et vous pourrez ainsi personnaliser votre Koken et surtout ajouter vos réalisations !

Vérifiez la force de votre protocole SSL/TLS en vérifiant votre Koken sur SSL Labs. Avec une telle configuration, vous devriez obtenir un A+.


Ubuntu 16.04.2 Server LTS (64bits)Nginx 1.10.0
PHP7-FPM 7.0.18
MariaDB 10.0.29
Koken 0.22.23

Auteur
AuteurEdouard WATTECAMPS

0 réponses

Répondre

Se joindre à la discussion ?
Vous êtes libre de contribuer !

Laisser un commentaire

Votre adresse de messagerie ne sera pas publiée. Les champs obligatoires sont indiqués avec *