{{ :icons:site.png?nolink|}}
====== LES SITES WEB PERSOS (SWP) ======
===== 1-Présentation =====
{{:icons:site.png?nolink |}} **KerHost** permet l'hébergement de sites web pour les ses utilisateurs. Les sites sont hébergés sur l'instance et sont stockés directement dans le [[kerhost:home_dir|homedir]] des utilisateurs. Un site web perso c'est donc un **hébergement** de site rattaché à un sous-domaine de l'instance ou sur un sous-domaine d'un [[kerhost:domaines|domaine]] réservé par l'utilisateur.
{{popup> kerhost:mon:swp.png?400 }}{{popup> kerhost:admin:swp_admin.png?400 }}

===== 2-Gestion =====
Le panneau de gestion des sites web persos représente une liste de ses sites. Pour y accéder :\\ 
<color white/#7589DB><tab1>MON ⇒ Mes sites web ⇒ Liste de mes sites web perso hébergés sur l'instance<tab1></color>\\ 
<color white/#E72828><tab1>ADMIN ⇒ Gérer les sites persso ⇒ Sites web perso<tab1></color>\\ 
On y retrouve l'enssemble des sites appartenant à l'utilisateur côté **mon**, et l'enssemble de tout les **swp** côté **admin** :\\ 
{{popup> kerhost:mon:swp_liste.png?400 }}{{popup> kerhost:admin:swp_admin_liste.png?400 }}
Plusieurs actions sont alors disponibles :\\ 
  * {{icons:autre.png}} et le logo représentant le [[kerhost:spi|spi]] utilisé
  * {{icons:on.png}} indique que le site est [[kerhost:swp#4-Activation/Désactivation|activé]]. Cliquer dessus le désactive. Désactiver un site permet de le mettre en pause. Le site est alors indisponible
  * {{icons:off.png}} indique que le site est [[kerhost:swp#4-Activation/Désactivation|désactivé]]. Cliquer dessus le réactive
  * {{icons:edit.png}} permet de [[kerhost:swp#5-Paramètres|paramétrer]] le site
  * {{icons:backup.png}} permet de lancer une [[kerhost:sauvegardes|sauvegarde]] du site
  * {{icons:logaccess.png}} permet d'accéder au fichier [[kerhost:swp_log|log]] d'accès du site
  * {{icons:logerror.png}} permet d'accéder au fichier [[kerhost:swp_log|log]] d'erreurs du site
  * {{icons:go.png}} permet d'accéder directement au contenu du site
  * {{icons:https0.png}} indique que le site n'est pas sécurisé
  * {{icons:https1.png}} indique que le site est sécurisé avec un [[kerhost:certificats|certificat]] auto-signé
  * {{icons:https2.png}} indique que le site sst sécurisé avec un [[kerhost:certificats|certificat]] Let'sEncrypt
  * {{icons:trash.png}} permet de supprimer le site
  * {{icons:vert.png}} site utilisant une base de donnée (interface admin seulement)
  * {{icons:rouge.png}} site n'utilisant pas de base de donnée (interface admin seulement)

L'interface de gestion des sites web persos dispose de plus d'options :\\ 
  * Gérer les sites web persos
  * Ajouter un site web perso
  * Site web perso en attente de [[kerhost:swp#3-Valider un site|validation]]
  * [[kerhost:spi|Site pré-installés]] (spi)
  * Comptes [[kerhost:mysql|MySQL]]/[[kerhost:phpmyadmin|PhpMyadmin]]
  * Création d'une [[kerhost:bdd|base de donnée]] SQL
  * [[kerhost:zone_dns|Zone DNS]]
{{popup> kerhost:admin:swp_admin2.png?400 }}


===== 3-Ajouter un site =====
{{:icons:add.png?nolink |}} <color white/#7589DB><tab1>MON ⇒ Mes sites web ⇒ Demande pour ajouter un site web perso hébergé sur l'instance<tab1></color>\\ 
{{popup> kerhost:mon:swp_add.png?400 }}
L'utilisateur saisi un nom de **sous-domaine** et un **domaine** principal, soit le domaine principal de l'instance, soit un [[kerhost:domaines|domaine]] lui appartenant. Et il alors redirigé vers un nouveau formulaire afin de donné un **descriptif** de son site et si il souhaite utiliser un [[kerhost:spi|spi]] proposé. Le descriptif est important. C'est ce qui permettra aux administrateurs de valider ou non la demande de site. Si un spi est précisé, alors il sera automatiquement déployé lors de la validation. L'utilisateur accepte la [[kerhost:charte_swp|charte d'utilisation]] dès lors qu'il valide sa demande.
{{popup> kerhost:mon:swp_add_valid.png?400 }}

<color white/#E72828><tab1>ADMIN ⇒ Gérer les sites persos ⇒ Ajouter un site web perso<tab1></color>\\ 
Côté administrateur, l'ajout d'un site web perso est plus rapide vu qu'il n'y a pas de validation. Il lui suffit d'indiquer :
  * le nom du **sous-domaine**
  * choisir le **domaine** principal
  * l'**utilisateur**
  * et le choix d'un **spi**

et de valider. Le site est immédiatement créer. Si le [[kerhost:registar|registar]] n'est pas pris en charge par **KerHost**, l'adminbistrateur doit alors modifier la [[kerhost:zone_dns|zone DNS]] du domaine pour ajouter le sous-domaine.
{{popup> kerhost:admin:swp_admin_add.png?400 }}


===== 3-Valider un site =====
Une fois qu'un utilisateur valide une demande de création de swp, un administrateur valide ou refuse le site selon le [[kerhost:decisions|mode opératoire]] :\\ 
<color white/#E72828><tab1>ADMIN ⇒ Gérer les sites persos ⇒ Site web en attente<tab1></color>\\ 
En cas de refus, l'administrateur est alors invité de donner une raison qui sera automatiquement envoyée par mail au demandeur du site.
<WRAP center round info 80%>
Tant que le site n'est pas **validé**, l'utilisateur ne peut pas accéder aux options du site.
{{popup> kerhost:mon:swp_attente.png?400 }}
</WRAP>

{{popup> kerhost:admin:swp_admin_valid.png?400 }}{{popup> kerhost:admin:swp_admin_refus.png?400 }}

===== 4-Activation/Désactivation =====
{{:icons:on.png?nolink |}} **Activer/désactiver** un swp permet tout simplement de mettre le site en pause, c'est à dire de le rendre **inaccessible**. Le site indiquera alors un message d'indisponibilité tant que celui-ci ne sera pas réactivé. Ceci peut être pratique pour une maintenance ou pour des raisons de **sécurité**.

===== 5-Paramètres =====
{{:icons:edit.png?nolink |}} Le **paramétrage** d'un site est la partie la plus complexe de la gestion des swp. Il y a très exactement 15 points de paramétrages.\\ 
<color white/#7589DB><tab1>MON ⇒ Mes sites web ⇒ Liste de mes sites web perso hébergés sur l'instance ⇒ Actions : Paramétrer ce site web perso<tab1></color>\\ 
<color white/#E72828><tab1>ADMIN ⇒ Gérer les sites persso ⇒ Liste des sites web perso hébergés sur l'instance ⇒ Actions : Modifier le site web perso<tab1></color>\\ 
==== 5.1-Informations générales ====
{{:icons:info.png?nolink |}} Ce [[kerhost:bloc|bloc]] permet  d'obtenir rapidement les informations générales de son site :
  * **nom** du site
  * **identifiant** du site
  * **url** du site
  * **chemin** du répertoire racine du site
  * **chemin** du répertoire contenant le site

{{popup> kerhost:mon:swp_mod_01.png?400 }}
==== 5.2-Configuration SSL ====
La configuration SSL permet de déterminer le niveau de sécurité de votre site par **certification** :
  * type de sécurité :
    * **HTTP**, le site n'est pas sécurisé, aucun certificat
    * **HTTPS**, le site et sécurisé avec un certificat
    * **LES 2**, il est possible de joindre le site de manière non sécurisés et de manière sécurisés
  * Type de certificat :
    * **AUCUN**, pas  de certificat
    * **AUTO-SIGNÉ**
    * **LET's ENCRYPT**

(voir la [[kerhost:certificats|certification]] pour plus de détails)
{{popup> kerhost:mon:swp_mod_02.png?400 }}
==== 5.3-Configuration .htaccess ====
Le **.htaccess** permet d'ajouter une **authentification** indépendamment du site afin dans restreindre l'accès par un identifiant. Il est possible d'y ajouter un message et de choisir cet identifiant.
{{popup> kerhost:mon:swp_mod_03.png?400 }}
==== 5.4-MOD_REWRITE ====
Le **mod_rewrite** est une option d'apache permettant la **ré-écriture d'URL**. Certain site (spi) on ont besoin, comme **WordPress**. Si le site rencontre des problèmes d'URL non trouvés (404), alors il peut être nécessaire d'activer cette option.
{{popup> kerhost:mon:swp_mod_04.png?400 }}
==== 5.5-Chroot du site ====
{{:icons:chroot.png?nolink |}}Si la politique de l'instance oblige le **[[kerhost:chroot|chroot]]** des **swp**, alors le site est chrooté et il n'est pas possible de modifier ce paramètre. En revanche si ce n'est pas imposé, il est possible de l'activer. L'instance peut aussi ne pas proposer le **chroot**, et ce [[kerhost:bloc|bloc]] ne sera alors pas disponible. Les options de **chroot** sont accessible içi :\\ 
<color white/#E72828><tab1>ADMIN ⇒ Tableaux de bord ⇒ Réglages de l'instance ⇒ Chroot site web perso<tab1></color>\\ 
<WRAP center round tip 80%>
Si le **chroot** est imposé et qu'un site web perso venait à ne pas fonctionner correctement, alors un administrateur peut tout de même outre passé le **chroot** et basculer le site en fonctionnement normal.
{{popup> kerhost:admin:swp_admin_chroot.png?400 }}
</WRAP>

{{popup> kerhost:mon:swp_mod_05.png?400 }}
==== 5.6-Configuration SPI ====
Les [[kerhost:spi|SPI]] (**S**ites **P**ré-**I**nstallés) sont des applications web clé en main prêtes à être utilisés. Il en existe beaucoup de disponible sur internet. **KerHost** propose un petit panel d'applications les plus utilisées pour faciliter leur déploiement. Si le spi désiré est disponible dans liste proposée, alors il peut le déployer en un clique de souris.
{{icons:go.png}} permet d'obtenir la liste et le détail des **spi** proposés par l'instance.
{{popup> kerhost:mon:swp_mod_06.png?400 }}
==== 5.7-Configuration base de données SQL ====
{{:icons:sql.png?nolink |}}Un site internet nécessite parfois une **base de donnée** pour pouvoir fonctionner. **KerHost** propose l'utilisation de base de donnée MySQL ([[kerhost:mysql|mariaDB]]) ainsi qu'un gestionnaire de bases de données [[kerhost:phpmyadmin|PhpMyAdmin]]. Il est donc tout a fait possible d'ajouter une base de donnée et de l'associée à un **swp**. Certains spi utilisent obligatoirement une base de donnée. Pour pouvoir utiliser une base de donnée, il faut que l'utilisateur active dans un premier temps son compte [[kerhost:mysql|MySQL]]/[[kerhost:swp_phpmyadmin|PhpMyAdmin]]. Si le compte MySQL de l'utilisateur n'est pas activé, il ne sera pas possible d'utiliser de base de donnée. Une fois le compte MySQL activé, l'utilisateur peut alors activer la base de donnée de son site. Le nom de la base de donnée est constitué de l'**identifiant du site_nom du sous domaine** et ne peut être modifier.
{{popup> kerhost:mon:swp_mod_07bis.png?400 }}{{popup> kerhost:mon:swp_mod_07.png?400 }}
==== 5.8-Paramètres de la base de données SQL ====
{{:icons:sql.png?nolink |}} Ce [[kerhost:bloc|bloc]] permet de récapituler rapidement les paramètres d'utilisation de la base de donnée :
  * serveur SQL (**127.0.0.1** et non localhost !)
  * identifiants (**login** utilisateur et **mot de passe MySQL** utilisateur)
  * **nom** de la base de donnée
  * lien vers l'accès à la gestion de la base de donnée avec [[kerhost:phpmyadmin|PhpMyAdmin]]

{{popup> kerhost:mon:swp_mod_08.png?400 }}
==== 5.9-Importer un site web sur son swp ====
**Importer** un site web permet de rapatrier et d'héberger un site internet provenant d'un autre hébergement que vous souhaitez migrer sur l'[[kerhost:instance|instance]]. Option à ne pas confondre avec le [[kerhost:swp#14-Léguer mon site web perso|lègue]] et le [[kerhost:swp#15-Transférer mon site web perso vers un autre domaine|transfère]] vers un autre domaine. Il est également possible d'importer uniquement une base de donnée sans le site. L'importation d'un site nécessite toutefois pour être utilisée correctement une procédure définie à bien respecter. L'importation se fait à partir d'une archive qui doit être correctement préparée. Voici les pré-requis :\\ 

  * Avoir un accès au contenu (structure des fichiers) de votre site web (ssh, ftp...)
  * Pouvoir exporter la base de donnée (MySQL uniquement pris en charge) si le site en possède une
  * Savoir créer une archive compressée (format zip, rar ou tar.gz uniquement supporté) ou savoir utiliser le FTP

Vous avez deux façons pour transférer votre site :

  * Soit en téléversant une archive contenant votre site içi même (et la base de donnée si il y en a une). C'est la façon la plus simple et quasi automatique si vous ne savez pas manipuler le FTP/SSH
  * Soit en téléversant vous même les fichiers de votre site dans le répertoire cible /home/utilisateur/www/nom_du_swp/www directement par FTP ou SSH avec votre compte utilisateur de l'instance
__
1er cas, avec une archive :__

  * Créez une archive au format **.zip**, **.rar** ou **.tar.gz** selon le type d'archivage désiré (exemple : drupal.tar.gz). Si vous avez un accès **SSH** pour accéder aux fichiers du site web sur le serveur qui les héberge, placez vous dans le répertoire ou se trouves les fichiers de votre site et tapez ''tar zcvf drupal.tar.gz'', et récupérez localement cette archive. Si vous n'avez pas d'accès SSH mais seulement le **FTP**, connectez-vous alors par FTP sur le serveur qui héberge votre site et rapatriez localement toute la structure du site sur votre ordinateur. Il ne vous reste plus qu'à créer une archive du site à partir du transfert FTP que vous venez d’effectuer de la même manière que décrit plus haut. **ATTENTION !!!** L'archive du site doit toujours être créée à partir du répertoire racine ou se trouve les fichiers du site !
  * Si vous avez une **base de données** pour ce site, faites un export de celle-ci au format **.sql**. Vous pouvez également compresser la base aux formats **.zip**, **.rar** ou **.tar.gz** si sa taille est importante. Pour faire un export d'une base de données, en général l'hébergeur de votre site met à votre disposition un utilitaire en ligne pour le faire, comme **PhpMyAdmin**. Reportez-vous à la documentation de votre hébergeur ou demandez de l'aide si vous ne savez pas comment procéder.
  * Une fois que l'archive est prête ainsi que sa base de données, transférez-les içi dans le formulaire, validez et **KerHost** s'occupe du reste.

__2eme cas, par FTP :__

  * Récupérez localement les fichiers de votre site web par **FTP** et renvoyez-les toujours par **FTP** sur l'instance, dans le répertoire /home/utilisateur/www/nom_du_swp/www (connectez vous en FTP sur ftp.domaine_de_l_instance avec vos identifiants de l'instance). Exportez votre base de données si vous en avez une (comme indiqué dans le 1er cas)
  * Téléversez si besoin la base de données ici dans le formulaire, validez et **KerHost** s'occupe du reste.

Si le site utilise une application web disponible dans les [[kerhost:spi|spi]], alors précisez en plus dans le formulaire le type de spi correspondant. Cela permettra de le prendre en charge plus facilement pour la suite et de configurer certains paramètres automatiquement.\\ 

<WRAP center round important 80%>
Deux choses IMPORTANT !!! :\\ 

  * Cette option initialise la cible (nom_du_site.domaine_de_l_instance). Cela veut dire que si il y a déjà un site fonctionnel sur ce dernier, celui-ci sera automatiquement supprimé. Pensez à faire une [[kerhost:sauvegardes|sauvegarde]] si c'est nécessaire, ou alors assurez-vous de partir sur un site vierge. Il en va de même pour la base de données.
  * Il se peut que le site une fois transféré ne fonctionne pas bien. C'est normal vu que vous changer de **nom de domaine**. Et cela sera d'autant plus le cas si vous utiliser une application web type **CMS**. Il faudra donc probablement modifier le **fichier de configuration** du site pour que le **nouveau nom de domaine** soit pris en charge correctement (identifiant à la base données MySQL, URL...). Il est fortement conseillé de faire ces modifications avant le transfert vers l'instance, sinon vous serez obligé de passer par la **ligne de commande** en **SSH** ou par **FTP**.
</WRAP>
{{popup> kerhost:mon:swp_mod_09.png?400 }}



==== 5.10-Paramètres Analyses et Statistiques MATOMO ====
{{:icons:quota.png?nolink | }}Il est possible d'activer les statistiques et l'analyse de son site web perso avec [[kerhost:matomo|Matomo]]. Une fois activé, rendez-vous sur le service [[kerhost:matomo|Matomo]] pour visualiser en temps réel les statistiques de son site web perso et programmer les rapports automatiques par mail au format PDF (journalier, hebdomadaire ou mensuel).\\ 
Pour pouvoir utiliser **Matomo** sur votre site web perso, vous devez paramétrer celui-ci. Deux options sont possibles :

  * Vous utiliser un CMS (type **WordPress**) qui dispose d'un plugins spécialement conçu pour Matomo. Dans ce cas-là en général il suffit de lui indiquer l'**ID Matomo** du site qui vous sera indiqué içi dans ce [[kerhost:bloc|bloc]] ainsi que l'adresse du serveur de Matomo.
  * Vous insérez manuellement le **code de suivi JavaScript** sur chacune de vos pages web. Pour cela copier/coller le code fourni dans le [[kerhost:bloc|bloc]].

{{popup> kerhost:mon:swp_mod_10.png?400 }}{{popup> kerhost:mon:swp_mod_10bis.png?400 }}
==== 5.11-Paramètres Moteurs de recherche et Indexation ====
Autoriser les moteurs de recherche à **indexer** son site web perso permet tout simplement de permettre à tout les **moteurs de recherche** (Google, Bing, Yahoo...) de venir indexer son site (scanner son contenu) pour pouvoir le proposer dans ses **résultats** de recherche. Si vous ne le souhaitez pas, laisser cette option désactivée.
{{popup> kerhost:mon:swp_mod_11.png?400 }}
==== 5.12-Droit d'accès sur le répertoire d'installation par défaut ====
Ici il est possible de rétablir les droits d'accès aux fichiers du site par défaut :
  * si le site n'est pas chrooté, **760** et **utilisateur:www-data** récursif sur /home/utilisateur/www/nom_du_swp)
  * si le site est [[kerhost:chroot|chrooté]], **760** et **www-id_du_site:www-id_du_site** récursif sur /home/utilisateur/www/nom_du_swp/www)

<WRAP center round important 80%>
**Attention !** Cette option est brute de décoffrage. Il faut être sûr de ce que l'on fait en remettant les valeurs par défaut. Un SPI peut ne plus marcher. Certains SPI nécessitent des droits spéciaux pour fonctionner.
</WRAP>

{{popup> kerhost:mon:swp_mod_12.png?400 }}
==== 5.13-Droit d'accès sur le répertoire d'installation personnalisé ====
Içi c'est la même chose mais vous pouvez définir les droits d'accès à **un élément en particulier** (répertoire ou fichier) de son site web. Il suffit d'indiquer le chemin exact du **répertoire/fichier** se trouvant après /home/utilisateur/www/nom_du_swp/www/ (exemple, si le chemin est /home/john/www/nom_du_swp/www/youplatralala, on précisez uniquement youplatralala), les droits d'accès et enfin la récursivité à appliquer ou non s'il s'agit d'un répertoire. Pour plus d'infos sur les droits d'accès (ou permissions) à un répertoire ou un fichier, consultez ce lien [[http://fr.wikipedia.org/wiki/Permissions_UNIX#Repr.C3.A9sentation_des_droits|Wikipédia]].

<WRAP center round important 80%>
** ATTENTION !** Si le site est [[kerhost:chroot|chrooté]], seul l'utilisateur du chroot peut être défini comme propriétaire, à savoir www-id_du_site (id_du_site étant le numéro id du site web perso). Une mauvaise compréhension de cette fonction peut rendre le site web perso inutilisable.
</WRAP>
{{popup> kerhost:mon:swp_mod_13.png?400 }}
==== 5.14-Léguer mon site web perso support ====
Le **lègue** permet de transférer son **site web perso** à un autre utilisateur de son [[kerhost:entite|entité]] afin qu'il en devienne **propriétaire**. Si le site contient une [[kerhost:bdd|base de donnée]], seuls les utilisateurs ayant un compte [[kerhost:mysql|MySQL]] activé peuvent prétendre au **lègue**.
<WRAP center round important 80%>
**Attention !** Dans le cas ou votre site web perso fonctionne avec une **base de donnée**, il faudra que la personne à qui vous léguez le site configure celui-ci avec ses identifiants **MySQL**. En général il s'agit de modifier le fichier **config** du site. Cette procédure ne peux pas être automatisé. Une fois le lègue accompli, vous perdez tout les droits dessus. Le site est physiquement déplacé de son [[kerhost:home_dir|home directory]] à celui de l'utilisateur.
</WRAP>

Il ne faut pas oublier pas de transmettre toutes les informations nécessaires pour que le repreneur du site puisse l'administrer (login, password...). Si les statistiques [[kerhost:matomo|matomo]] sont activées pour ce site, alors elles seront transférées sur le compte matomo de l'utilisateur.
{{popup> kerhost:mon:swp_mod_14.png?400 }}
==== 5.15-Transférer mon site web perso vers un autre domaine ====
Le **transfert** de domaine permet de rattacher son **site web perso** à un autre nom de [[kerhost:domaines|domaine]] que l'on possède (du moins que son [[kerhost:entite|entité]] possède, car seul le responsable de son entité est habilité à ajouter des domaines et les gérer). Si votre entité à donc un ou des domaines supplémentaires rattaché à l'[[kerhost:instance|instance]], il est possible de **transférer** son site web perso vers un autre [[kerhost:domaines|domaine]]. Il faut entendre par transfert la prise en charge d'une nouvelle adresse du site. C'est à dire que au lieu d'avoir http://sous_domaine.domaine_de_l_instance, vous pouvez avoir http://sous_domaine.un_autre_nom_de_domaine.\\ 
 A l'inverse, il est possible de transférer un site web perso hébergé sur un de vos nom de domaine vers l'instance, c'est parfaitement réversible.\\ 

Pour procéder à un changement de domaine, il suffit de sélectionner dans le menu le nom de domaine que l'on souhaite. 

<WRAP center round important 80%>
**Attention !** Si son site web est sécurisé **https** avec un [[kerhost:certificats|certificat]] Let'sEncrypt, celui-ci sera révoqué immédiatement et un nouveau sera automatiquement régénéré en début de soirée vers 20h30. Vous disposerez alors d'un certificat **auto-signé** le temps d'obtenir le nouveau certificat certifié.
</WRAP>
{{popup> kerhost:mon:swp_mod_15.png?400 }}