Base de connaissances

Ce guide permet de résoudre les problèmes liés aux caractères spéciaux (accents, emojis, etc.) qui ne s'affichent pas correctement ou apparaissent sous forme de symboles comme ??, souvent dû à un mauvais encodage lors de la connexion à MySQL.

Préambule

• Par défaut, MySQL utilise UTF-8.
• Les serveurs MySQL récents sont généralement configurés pour utiliser UTF-8 ou UTF-8MB4 par défaut.
  • Cela convient à la majorité des cas, notamment pour les langues internationales et les emojis.
• Prenez également connaissance de cet autre guide pour apprendre à éviter de provoquer des problèmes d'encodage avec les caractères non européens et les emojis dans vos développements.

Définir le charset MySQL / MariaDB par défaut (Serveur Cloud)

Avec un Serveur Cloud Infomaniak, il est possible de définir le charset par défaut (utf8 ou utf8mb4):

1. Cliquez ici afin d'accéder à la gestion de votre produit sur le Manager Infomaniak (besoin d'aide ?).
2. Cliquez directement sur le nom attribué au produit concerné.
3. Cliquez sur MariaDB dans le menu latéral gauche.
4. Choisissez le charset par défaut:
   
   • Si vous n'avez pas encore migré vers MariaDB, le principe est le même.
5. Sauvegardez vos changements en bas de page.

Forcer un encodage spécifique (latin1 par exemple)

Si vous devez travailler avec une base de données en latin1 (ISO-8859-1), vous devez aligner explicitement l'encodage lors de la connexion, selon votre environnement.

Sur les offres actuelles, placez le code suivant dans un fichier user.ini situé à la racine de votre hébergement:

mysql.connect_charset = "latin1"
mysqli.connect_charset = "latin1"
pdo_mysql.connect_charset = "latin1"

ou en PHP (API MySQL):

mysql_query("SET CHARACTER SET latin1");

Sur les anciennes formules d'hébergement, forcez la connexion MySQL en latin1 via le fichier .htaccess situé à la racine de votre hébergement:

php_value mysql.connect_charset latin1
php_value mysqli.connect_charset latin1
php_value pdo_mysql.connect_charset latin1

Ce guide explique comment ajouter deux Certificats SSL EV ou DV différents sur un même site.

Préambule

• Comme il n'est pas possible d'installer deux certificats SSL sur un même site, il est nécessaire de créer deux sites identiques.

Création du second site

Prérequis

• Retirer tout éventuel nom de domaine alias de votre site.

Afin d'accéder à l'hébergement Web pour y ajouter un site :

1. Cliquez ici afin d'accéder à la gestion de votre produit sur le Manager Infomaniak (besoin d'aide ?).
2. Cliquez directement sur le nom attribué au produit concerné.
3. Cliquez sur le bouton Ajouter un site:
   
4. Continuez sans installer d'outil:
   
5. Cliquez sur Apache et choisissez la même version PHP que le site principal::
   
6. Choisissez entre l'utilisation d'un nom de domaine ou d'un sous-domaine.
7. Indiquez le nom du domaine ou du sous-domaine.
8. Cliquez sur Options avancées.
9. Activez (ou non) le certificat SSL Let's Encrypt sur le futur site.
10. Cochez la case Définir l'emplacement manuellement.
11. Choisissez le même emplacement que celui du site principal:
    
12. Cliquez sur le bouton bleu Suivant pour démarrer la création du site.

Installer le certificat SSL

Une fois que le second site est créé (tout ajout / modification DNS peut prendre jusqu'à 48 heures pour se propager (❓: aide)), il vous sera possible d'installer un certificat SSL (si vous avez choisi de ne pas installer le certificat au point 9 ci-dessus).

Pour accéder à la gestion du site :

1. Cliquez ici afin d'accéder à la gestion de votre produit sur le Manager Infomaniak (besoin d'aide ?).
2. Cliquez directement sur le nom attribué au produit concerné.
3. Cliquez sur Certificats SSL dans le menu latéral gauche.
4. Cliquez sur le bouton bleu Installer un certificat SSL et suivre la procédure.

Ce guide présente des pistes d'amélioration pour réduire le temps de réponse de votre Hébergement Web Infomaniak.

Préambule

• TTFB, ou *Time To First Byte*, est une unité de mesure utilisée pour évaluer la vitesse de réponse d'un serveur Web.
• Le TTFB mesure le temps entre une requête HTTP provenant d'un utilisateur ou d'un navigateur et la réception du premier byte de la page du site à consulter.
• Ce délai est particulièrement important. Il peut faire partie des critères SEO pris en compte par les moteurs de recherche comme Google.

Pistes d'amélioration du TTFB

 Pour accélérer le site et obtenir une meilleure valeur TTFB :

• Utilisez un réseau de diffusion de contenu (CDN).
• Optimisez le code du site.
• Optimisez les requêtes de la base de données.
• Limitez les requêtes HTTP.
• Incorporez du CSS et du JavaScript dans vos pages HTML pour ne pas faire appel à des ressources externes.
• Utilisez un système de cache RFPL (*Response First, Process Later*).

Prenez connaissance de l'article de Criticalcase (en anglais) pour de plus amples informations.

Tester la vitesse de réponse du serveur 

En cas de doute sur la vitesse de réponse du serveur, il est possible de créer un fichier index2.html qui sera enregistré au même niveau que le fichier index.html (ou .php), et ainsi effectuer un test d'optimisation (par exemple domain.xyz/index2.html) sans que le site/CMS principal ne soit pris en compte.

Si le temps de réponse est normal, cela signifie que les lenteurs proviennent du site et non du serveur.

Pour aller plus loin 

Prenez connaissance des ressources suivantes :

• Recommandations de Google
• Recommandations de GTmetrix
• Tester la vitesse de réponse de votre site depuis plusieurs pays
• Tester la vitesse de réponse de votre site
• Optimiser un site

Ce guide détaille l'erreur "Database connection error: could not connect to mysql" qui peut survenir lors de modifications autour d'un hébergement Infomaniak sur lequel est installé l'app Web Joomla.

Préambule

• Pour que le site refonctionne, il faut vérifier et adapter certaines informations dans le fichier configuration.php de Joomla:
  1. Le nom de la base de données — il s'agit souvent d'un préfixe qui a été ajouté devant le nom existant de la base et le nom d'utilisateur (par exemple dbname avant, abcd_dbname après).
  2. Le serveur hôte de la base de données (par exemple mysql.domain.xyz avant, abcd.myd.infomaniak.com après).
  3. Le nom d'utilisateur qui accède à la base de données (par exemple dbuser avant, abcd_dbuser après).
  4. Le chemin de deux répertoires /tmp et /logs.

Obtenir les informations actualisées

Pour les points 1, 2 et 3 du préambule ci-dessus:

1. Cliquez ici afin d'accéder à la gestion des hébergements & sites sur votre Manager Infomaniak (❓: aide).
2. Cliquez sur le nom de l'hébergement concerné.
3. Cliquez sur Base de données dans le menu latéral gauche.
4. Retrouvez et conservez vos informations MySQL actuelles (❓: aide).

Pour le point 4 du préambule ci-dessus:

1. Cliquez ici afin d'accéder à la gestion des hébergements & sites sur votre Manager Infomaniak (❓: aide).
2. Cliquez sur le nom du site concerné.
3. Cliquez sur Gérer les paramètres avancés:
   
4. Cliquez sur l'onglet PHP / Apache:
   
5. Copiez le chemin affiché dans le premier champ sous Auto Prepend File en bas:
   

Modifier le fichier configuration.php de Joomla

Prérequis

• Créer un compte FTP (❓: aide).
• Se connecter par FTP (❓: aide).

Editez ensuite le fichier configuration.php qui se trouve dans le dossier racine de votre Joomla:

1. Remplacez l'ancien chemin log et tmp par le nouveau chemin:
   
2. Trouvez les paragraphes concernés pour le reste des informations du préambule ci-dessus:
   
3. Sauvegardez le fichier ; votre Joomla se connectera désormais à la base de données correcte.

Vérifier les changements effectués

Sur l'interface de Joomla, il est possible de vérifier les chemins des dossiers /logs et /tmp:

• Pour le dossier /logs: allez sous Système / Configuration puis Logs:
  
• Pour le dossier /tmp: allez sous Système / Configuration puis Serveur:
  

Ce guide concerne les messages envoyés depuis Site Creator (formulaire de contact ou module e-commerce par exemple).

Préambule

• Par défaut, les e-mails sont envoyés par le protocole PHP mail() non authentifié (❓: aide).
• Il est recommandé d'utiliser la méthode SMTP authentifiée à la place (❓: aide).

Modifier la méthode d'envoi

Prérequis

• Avoir une adresse mail valide ou en créer une (❓: aide my kSuite  |  Service Mail/kSuite).
• Créer un mot de passe d'appareil (❓: aide my kSuite  |  Service Mail/kSuite) nommé par exemple “Site Creator” (ou “SC2026”, etc. peu importe) pour cette adresse mail:
  
• Vérifier la configuration adéquate du domaine (❓: aide Service Mail/kSuite).

Commencez par vous connecter au Manager Infomaniak avec votre identifiant (utilisateur disposant des droits nécessaires sur le produit concerné):

1. Cliquez ici afin d'accéder à la gestion des hébergements & sites (filtrée pour n'afficher que Site Creator).
   • Si rien ne s'affiche, vous n'êtes peut-être pas dans l’Organisation à laquelle votre site est rattaché (❓: aide).
2. Cliquez sur le nom du Site Creator concerné:
   
3. Cliquez sur le bouton pour éditer votre site:
   

Une fois dans Site Creator, pour modifier la méthode d'envoi des e-mails:

1. Cliquez sur le bouton Réglages dans le menu latéral gauche.
2. Cliquez sur Paramètres généraux:
   
3. Choisissez la méthode SMTP puis complétez les cases avec comme le de serveur SMTP puis les informations relatives à votre adresse mail et son mot de passe:
   • Serveur SMTP sortant = mail.infomaniak.com
   • Port SMTP: 587
   • Nom d'utilisateur/username = l'adresse mail complète & entière (❓: aide)
   • Mot de passe/password = celui généré pour l'adresse mail que vous voulez consulter (❓: aide my kSuite  |  Service Mail/kSuite).
   • Prenez connaissance de cet autre guide si vous recherchez des informations au sujet d'autres ports compatibles.
4. Une fois tous les champs remplis, cliquez sur le bouton Vérifier.
5. Si tout est correct, le bouton Enregistrer s'affiche et vous pouvez cliquer dessus pour enregistrer vos paramètres mail:
   

Ce guide explique comment interdire l'accès aux flux de Streaming vidéo Infomaniak grâce à une clé unique (hash).

Préambule

• Cette méthode offre le meilleur niveau de protection et permet par exemple de restreindre vos diffusions à un espace membre nécessitant une authentification.
• La manière de générer ce code étant propre à chaque site, il sera nécessaire d'implémenter les fonctions PHP requises et d'adapter le code d'intégration de votre lecteur en conséquence.

Restreindre l'accès aux diffusions par clé unique (hash)

Pour cela:

1. Cliquez ici afin d'accéder à la gestion de votre produit sur le Manager Infomaniak (besoin d'aide ?).
2. Cliquez directement sur le nom attribué au produit concerné.
3. Cliquez sur Paramètres dans le menu latéral gauche.
4. Cliquez sur Restrictions dans le menu latéral gauche.
5. Cliquez sur l'onglet (ou l'élément du menu déroulant) Restriction par hash unique:
   

Fonctionnement des restrictions

Cette méthode nécessite de récupérer des informations liées à la configuration de votre flux et à l'internaute qui se connecte.

Il est dans un premier temps nécessaire de créer un mot de passe (une clé) au niveau du Manager Infomaniak. Dès l'ajout de cette clé, les spectateurs connectés et ceux qui tentent de visionner votre flux seront instantanément bloqués (prenez connaissance de cet autre guide pour personnaliser l'image de remplacement proposée aux spectateurs bloqués).

Voici le principe à suivre pour autoriser l'accès à votre flux :

• Conception d'un système d'authentification par vos soins (par exemple un espace membre).
• Prendre le mot de passe configuré ci-dessus sur le Manager.
• Récupérer l'IP des internautes via $_SERVER["REMOTE_ADDR"] par exemple.
• Prendre l'identifiant du flux à cibler.
• Récupérer la date ainsi que l'heure courante (sans les minutes et les secondes).

Ces éléments seront ensuite hashés par le code fourni dans le Manager afin de générer un token unique et propre à chaque utilisateur qui sera transmis au flux au moment de son chargement. La plateforme de streaming vérifiera ensuite la validité du hash afin d'autoriser ou de rejeter la connexion.

Remarques importantes

• Afin de garantir la sécurité de l'accès au flux, la validité de chaque token est limitée dans le temps.
• Il est important de désactiver le cache sur les pages qui permettent d'accéder au flux ; en effet, si la génération du token est mis en cache, d'autres utilisateurs tenteront de s'authentifier avec le hash de quelqu'un d'autre, ce qui provoquera leur rejet même s'ils ont l'autorisation de consommer le flux.

Ce guide détaille l'erreur de messagerie "bogus HELO" afin de vous permettre de comprendre son origine et de la corriger.

Quand et pourquoi cette erreur ?

Le protocole SMTP (utilisé pour l'envoi d'e-mails) comporte plusieurs phases. La première consiste pour le serveur de l'expéditeur à se présenter au serveur du destinataire via la commande HELO (ou EHLO pour le SMTP étendu). Cette commande doit impérativement être suivie d'un nom d'hôte valide.

Si vous recevez une erreur mentionnant "bogus HELO", c'est que l'identifiant fourni par le serveur expéditeur n'est pas conforme à la RFC 5321. Cette vérification est une mesure de sécurité essentielle qui permet de filtrer une grande partie des serveurs mal configurés, souvent utilisés pour la diffusion de virus et de spams.

Infomaniak refuse tout message provenant d'un serveur qui s'identifie de manière générique (ex: "serveur") ou locale. Le serveur doit utiliser un FQDN (Fully Qualified Domain Name), c'est-à-dire un nom d'hôte complet et résolvable de type "serveur.domaine.xyz".

Exemples de configurations provoquant un rejet :

L'utilisation d'une adresse IP locale ou de bouclage (loopback) :

220 mta-gw.infomaniak.ch ESMTP Infomaniak Network Mail Servers; HELO 127.0.0.1

L'utilisation d'une adresse IP entre crochets au lieu d'un nom de domaine :

220 mta-gw.infomaniak.ch ESMTP Infomaniak Network Mail Servers; HELO [192.168.1.1]

L'utilisation d'un nom d'hôte local non qualifié :

220 mta-gw.infomaniak.ch ESMTP Infomaniak Network Mail Servers; HELO localhost 220 mta-gw.infomaniak.ch ESMTP Infomaniak Network Mail Servers; HELO mon-serveur

L'utilisation d'un nom de domaine banni ou manifestement faux :

220 mta-gw.infomaniak.ch ESMTP Infomaniak Network Mail Servers; HELO fakedomain.xyz

Dans ces cas, la transaction SMTP échouera avec le code suivant :

MAIL FROM: user@domaine.com 250 2.1.0 user@domaine.com... Sender ok RCPT TO: destinataire@infomaniak.ch 550 5.7.1 destinataire@infomaniak.ch... Access denied - bogus HELO [1]

Comment résoudre ce problème ?

Si vous utilisez un script de programmation (PHP, Python, etc.) pour envoyer des mails via SMTP, assurez-vous que la bibliothèque utilisée est configurée pour envoyer un nom de domaine valide dans la commande HELO et non l'adresse IP du serveur web.

Ce guide explique comment gérer le contenu d'un hébergement Web en accédant au serveur notamment par le protocole FTP ou via ligne de commande (CLI) en toute sécurité grâce au SSH. 

Préambule

• Pour gérer simplement & rapidement les fichiers de votre hébergement Web sans devoir installer une application ni entrer d'identifiants FTP, utilisez Web FTP depuis votre Manager Infomaniak (il permet notamment le CHOWN et la compression/décompression de fichiers zip).
• Lors de la création d'un site via un hébergement Apache/PHP un utilisateur FTP/SSH/SFTP est automatiquement créé ; vous pouvez créer des comptes FTP supplémentaires.
• En revanche, dans le cadre d'un site Node.js, aucun utilisateur SSH/SFTP n'est créé automatiquement ; il est nécessaire de créer manuellement un utilisateur disposant des droits SSH/SFTP pour accéder à votre environnement Node.js.
• Concernant les protocoles supportés par Infomaniak (FTP, SFTP, etc.) en fonction de votre offre d'hébergement (Starter, Node.js, etc.), prenez connaissance de cet autre guide.

Créer un compte FTP

Afin de gérer la partie FTP:

1. Cliquez ici afin d'accéder à la gestion des hébergements & sites sur votre Manager Infomaniak (❓: aide).
2. Cliquez sur le nom de l'hébergement concerné.
3. Cliquez sur FTP / SSH dans le menu latéral gauche.
4. Puis soit vous cliquez sur le bouton Ajouter pour créer un nouveau compte FTP / SSH…
5. soit vous cliquez sur le menu d'action ⋮ à droite d'un compte existant pour modifier son mot de passe, ou le supprimer:
   
6. Si vous possédez un site node.js sur votre hébergement, il faut choisir l'environnement désiré pour la création d'un nouveau compte FTP/SSH:
   
7. Puis entrez les informations désirées:
   1. Un compte FTP + SSH donne accès à l'utilisateur en question à tout le contenu d'un hébergement et lui permet de le gérer par FTP/SFTP et SSH.
   2. Un compte FTP permet de restreindre l'accès d'un utilisateur à un dossier et ses sous-dossiers ; si vous gérez plusieurs sites sur le même hébergement, cela permet de répartir la gestion des sites entre plusieurs webmasters par exemple.
8. Cliquez sur le bouton en bas de page pour Confirmer la création du compte:
   

Configurer un logiciel/client FTP

Grâce à un logiciel/client FTP comme Filezilla ou CyberDuck, gérez les fichiers réellement par FTP sans limite (possibilités de travail en arrière-plan, de reprise des transferts après coupure, de limitation des débits, etc.).

Ce guide explique comment installer une nouvelle Application Web (Joomla, Drupal, Typo3, PrestaShop, etc.) en quelques clics sur les offres d'Hébergement Web payantes.

Prérequis

• Posséder un hébergement Web Infomaniak (commander si nécessaire).

Guides spécifiques

Prenez connaissances de ces guides si vous êtes concernés par l'installation spécifique de:

• WordPress
• ownCloud

Guides pour toute autre Application Web

Afin d'accéder à l'Hébergement et d'y installer un nouveau site ainsi qu'une Application Web dessus:

1. Cliquez ici afin d'accéder à la gestion des hébergements & sites sur votre Manager Infomaniak (❓: aide).
2. Cliquez sur le nom de l'hébergement concerné.
3. Cliquez sur le bouton Ajouter un site:
   
4. Choisissez d'installer un site avec dessus une Application à choix.
5. Cliquez sur Suivant en bas de page:
   
6. Choisissez le nom de domaine qui devra correspondre au site et à l'application.
7. Cliquez sur Suivant:
   
8. Patientez le temps de la création du site sur l'hébergement.
9. Sélectionnez l'application à installer (si nécessaire, filtrez et recherchez).
10. Cliquez sur Suivant en bas de page:
    
11. Entrez un nom.
12. Laissez l'emplacement par défaut ou choisissez d'installer l'app dans un nouveau dossier que vous pouvez créer grâce à une icône visible à droite du point 8 sur l'image.
13. Choisissez éventuellement d'installer une version antérieure si nécessaire.
14. Cliquez sur Suivant:
    
15. Configurez nom d'utilisateur et mot de passe.
16. Spécifiez certains réglages avancés si nécessaire (type de sauvegarde notamment).
17. Prenez connaissance et acceptez les conditions d'utilisation de l'app sélectionnée.
18. Cliquez sur Suivant:
    
19. Confirmez l'installation de l'application à l'étape suivante et patientez:
    
    • Prenez connaissance d'éventuel message d'erreur à l'écran si par exemple le dossier d'installation choisi n'est pas vide ou si la version de PHP du site sur lequel vous tentez l'installation n'est pas compatible.

Désinstaller une Application Web

Afin d'accéder à l'Hébergement Web et d'y désinstaller l'application précédemment installée :

1. Cliquez ici afin d'accéder à la gestion de votre hébergement sur le Manager Infomaniak (besoin d'aide ?).
2. Cliquez directement sur le nom attribué à l'hébergement concerné:
   
   1. Si vous retirez le site de l'hébergement:
      
      • Les fichiers de l'application peuvent être à choix supprimés ou conservés sur le serveur, mais dans tous les cas le site est effacé et disparait (l'URL attribuée au site ne correspondra plus à rien).
   2. Si vous cliquez sur le nom du site en tout premier lieu:
      
      • Vous pouvez choisir la désinstallation de l'application précédemment installée:
        

En savoir plus

• Modifier le nom de domaine associé à l'Application Web
• Configurer les sauvegardes des Applications Web
• Restaurer une Application Web

Ce guide explique comment installer Nextcloud, une version améliorée de Owncloud, en quelques clics sur les offres d'Hébergement Web payantes.

Préambule

• Nextcloud fait partie des applications (non développées par Infomaniak) et permet la mise en place d'un système de stockage & partage de fichiers au sein d'un "cloud" que vous maîtrisez entièrement (gestion des utilisateurs, permissions, quotas, applications mobiles associées, etc.).
• Contrairement à d'autres hébergeurs, Infomaniak autorise l'utilisation de ce type d'app sur ses hébergements:
  • Une utilisation personnelle est autorisée sur les hébergements Web mutualisé.
  • Pour un usage intensif et professionnel, il est recommandé d'opter pour un Serveur Cloud afin d'y installer ownCloud / Nextcloud.

Installer Nextcloud

Prérequis

• Posséder un hébergement Web Infomaniak (commander si nécessaire).
• Mettre à niveau la partie Bases de données si nécessaire (surtout pour Nextcloud).
• Si un site vierge est déjà présent sur l'hébergement, cliquez sur le bouton comme sur l'image ci-dessous et sautez directement à l'étape 9:
   

Afin d'accéder à l'Hébergement Web et d'y installer un nouveau site avec l'application:

1. Cliquez ici afin d'accéder à la gestion des hébergements & sites sur votre Manager Infomaniak (❓: aide).
2. Cliquez sur le nom de l'hébergement concerné.
3. Cliquez sur le bouton Ajouter un site:
   
4. Sélectionnez l'option intermédiare pour le déploiement d'outils.
5. Cliquez sur Suivant:
   
6. Sélectionnez le domaine ou sous-domaine et les options avancées si nécessaire.
7. Cliquez sur Suivant:
   
8. Patientez quelques minutes, le temps de la création du site:
   
9. Sélectionnez l'application souhaitée (si nécessaire, filtrez et recherchez):
   
10. Cliquez sur Suivant en bas de page.
11. Laissez l'emplacement par défaut ou activez la case afin d'installer l'app dans un nouveau dossier que vous pouvez créer grâce à une icône visible à droite du point 11 sur l'image.
12. Choisissez éventuellement d'installer une version antérieure si nécessaire.
13. Cliquez sur Suivant:
    
14. Configurez nom d'utilisateur et mot de passe.
15. Spécifiez certains réglages avancés si nécessaire (type de sauvegarde notamment).
16. Prenez connaissance et acceptez les conditions d'utilisation de l'app sélectionnée.
17. Cliquez sur Suivant:
    
18. Confirmez l'installation de l'application à l'étape suivante et patientez:
    
    • Prenez connaissance d'éventuel message d'erreur à l'écran si par exemple le dossier d'installation choisi n'est pas vide ou si la version de PHP du site sur lequel vous tentez l'installation n'est pas compatible.
19. Une fois l'installation terminée, vous pouvez gérer votre application comme désiré:
    

Ce guide explique comment déplacer un Hébergement (et tous les sites qu'il contient) d'un Serveur Cloud vers un autre Serveur Cloud managé.

Préambule

• FTP & MySQL
  • Lors du déplacement d'un hébergement d'un Serveur Cloud à un autre:
    • Les accès FTP et bases de données ne changent pas.
    • Seules changent au niveau des hébergements les versions supportées de PHP et MariaDB, ainsi que les adresses IPv4 et IPv6 du serveur.
    • Les noms d'hôtes (hostnames) ne changent pas et sont automatiquement mis à jour pour pointer sur les nouvelles adresses IP.
• Interruption temporaire:
  • Les sites de l'hébergement seront indisponibles durant la migration des données.
  • Ce processus peut durer plusieurs minutes en fonction du nombre de fichiers à transférer sur le nouveau Serveur Cloud.
• Passage éventuel à HTTP/2:
  • Le HTTP/2 est actif sur les nouveaux serveurs.
  • Certaines directives éventuellement présentes dans le fichier .htaccess de votre serveur pourront nécessiter une adaptation (❓: aide).
• Redirection du trafic:
  • Un proxy est mis en place durant 7 jours pour rediriger le trafic de l'ancien serveur vers le nouveau.
  • Il convient donc d'y penser durant cette période notamment pour les crons (lire ci-dessous).
• Crons non migrés:
  • Les crons par SSH ne sont pas migrés.
  • Les fichiers et les crons ne sont généralement pas supprimés immédiatement, ce qui peut entraîner des doublons.
  • La gestion des crons relève de votre responsabilité ; en fonction de l'avancement de votre migration, il vous appartient de:
    • désactiver et d'activer les crons via SSH si vous en possédez, afin d'éviter tout conflit d'exécution,
    • vérifier vos crons,
    • vous assurer qu'ils sont configurés de manière appropriée sur votre nouveau Serveur Cloud.

Déplacer l'hébergement

Prérequis

• Les deux serveurs doivent se trouver dans la même Organisation et être accessible à l'utilisateur réalisant l'opération.

Une fois que le second Serveur Cloud est en service:

1. Cliquez ici afin d'accéder à la gestion de l'hébergement sur le Manager Infomaniak (besoin d'aide ?).
2. Cliquez directement sur le nom attribué à l'hébergement concerné.
3. Cliquez sur le bouton Gérer.
4. Cliquez sur Déplacer sur un autre serveur dans le menu qui s'affiche:
   
5. Choisissez le serveur de destination souhaité.
6. Cliquez sur Valider.

Adapter la zone DNS et terminer

Si vos noms de domaine ne sont pas gérés chez Infomaniak ou dans la même Organisation que le Serveur Cloud:

• Adaptez l'enregistrement A des domaines concernés (❓: aide).
  • Tout ajout / modification DNS peut prendre jusqu'à 48 heures pour se propager (❓: aide).
  • Il est donc recommandé de ne pas résilier l'ancien Serveur Cloud avant ce délai.
• Résiliez l'ancien Serveur Cloud si nécessaire (❓: aide).

Ce guide explique comment protéger une partie d'un site sur un Hébergement Web en rendant obligatoire la saisie d'un mot de passe avant de consulter un répertoire (sous-répertoires inclus) depuis un navigateur comme Brave, Chrome, Edge, Firefox, Opera, Safari….

Méthode simple

Afin de protéger par mot de passe (authentification Digest) un répertoire en utilisant l'outil "Protection de dossiers":

1. Cliquez ici afin d'accéder à la gestion des hébergements & sites sur votre Manager Infomaniak (❓: aide).
2. Cliquez sur le nom de l'hébergement concerné.
3. Cliquez sur Sécurité dans le menu latéral gauche.
4. Cliquez sur Protection de dossiers.
5. Cliquez sur le répertoire à protéger.
6. Activez la protection par le bouton à bascule (toggle switch) puis créez un ou plusieurs utilisateurs*: 
   
   • * Les utilisateurs sont définis par répertoire ; l'outil ne permet pas de gérer des groupes d'utilisateurs:
7. Cliquez sur le bouton Ajouter.
8. Cliquez sur le bouton pour Ajouter l'accès d'un utilisateur supplémentaire si nécessaire.
9. Cliquez sur le menu d'action ⋮ situé à droite de l'utilisateur concerné pour le modifier ou le retirer.
10. Cliquez à nouveau sur le bouton à bascule (toggle switch) afin de désactiver complètement la protection du répertoire:

Méthode manuelle via .htaccess

Afin de protéger un dossier par un mot de passe en utilisant le fichier .htaccess de votre site:

1. Connectez-vous à votre hébergement via un logiciel/client FTP ou le Web FTP.

2. Dans le dossier à protéger, créez un fichier appelé password.php et adaptez le contenu suivant à l'intérieur en remplaçant 12345 par le mot de passe désiré:

   <?php
   $password = "12345";
   echo password_hash($password, PASSWORD_DEFAULT); // Displays the hashed password
   ?>

3. Ouvrez un navigateur et affichez le fichier password.php (exemple: domain.xyz/dossier-à-protéger/password.php).
4. Le navigateur affiche votre mot de passe chiffré ; copiez le mot de passe chiffré, il y en aura besoin par la suite…

Dans le dossier à protéger, créez un fichier appelé .htaccess et adaptez le contenu suivant à l'intérieur:

AuthName "Protected Administration Page"
AuthType Basic
AuthUserFile "/example/.htpasswd"
Require valid-user

Remplacez /example/ par le chemin absolu du dossier à protéger. Exemple:

AuthUserFile "/home/clients/0f83c7afb710e5ae2645a1b704d8772f/web/protected_folder/.htpasswd"

Dans le dossier à protéger, créez un fichier appelé htpasswd.txt et adaptez le contenu suivant à l'intérieur:

username:hashed_password

• Remplacez username par le login souhaité.
• Remplacez hashed_password par le mot de passe chiffré copié à l'étape 1 de ce guide.

Une fois le fichier htpasswd.txt sauvegardé, renommez-le comme suit: .htpasswd.

Ouvrez un navigateur et essayez d'afficher l'une des pages contenues dans le dossier protégé. Si le guide a bien été suivi, le login et le mot de passe (non chiffré) choisis permettent d'accéder au dossier protégé.

D'autres restrictions peuvent également être apportées par .htaccess.

Ce guide explique comment activer ou désactiver le mode maintenance sur un site d'un Hébergement Infomaniak.

Préambule

• Le mode maintenance permet d'afficher un message personnalisé à vos visiteurs par exemple pendant la résolution d'un problème technique.
• Il est également possible de spécifier des adresses IP qui pourront contourner cette page.
• Un e-mail est envoyé aux utilisateurs de l'Organisation.

Activer le mode maintenance

Pour activer une page qui remplace temporairement votre page d'accueil habituelle:

1. Cliquez ici afin d'accéder à la gestion des hébergements & sites sur votre Manager Infomaniak (❓: aide).
2. Cliquez sur le nom du site concerné.
3. Cliquez sur le bouton à bascule (toggle switch) pour activer la page de maintenance.
4. Validez l'avertissement.
5. Cliquez sur le bouton pour activer:
   

Personnaliser la page de maintenance

Pour mettre en place une page avec le message de votre choix:

1. Cliquez ici afin d'accéder à la gestion des hébergements & sites sur votre Manager Infomaniak (❓: aide).
2. Cliquez sur le nom du site concerné.
3. Cliquez sur Page et maintenance dans le menu latéral gauche.
4. Cliquez sur ‍ Créer une page ou sur le bouton Personnaliser si elle existe déjà:
   
5. Mettez en page le texte de votre choix.
6. Configurez l'affichage à l'aide des éléments sur la droite.
7. Cliquez sur Enregistrer & activer pour publier la page:
   

Autoriser des adresses IP à contourner la suspension

Il est possible d'afficher le site réel même avec le mode maintenance activé. Pour cela, il est nécessaire de renseigner les adresses IP des ordinateurs qui doivent pouvoir contourner le mode maintenance:

1. Activez le mode maintenance selon la procédure ci-dessus.
2. Revenez sur la page de configuration de la page de maintenance (cf procédure ci-dessus).
3. Sous Maintenance à droite, cliquez sur Insérer mon adresse IP pour autoriser votre ordinateur à afficher le site sans mode maintenance:
   
   • Il est également possible de saisir manuellement les IP à autoriser.
4. Cliquez sur Enregistrer et publier.

Désactiver le mode maintenance

Pour désactiver le message qui s'affiche sur votre site pendant la maintenance:

1. Cliquez ici afin d'accéder à la gestion des hébergements & sites sur votre Manager Infomaniak (❓: aide).
2. Cliquez sur le nom du site concerné.
3. Cliquez soit sur le bouton Désactiver ou sur le bouton à bascule (toggle switch) pour désactiver la page de maintenance:
   
4. Confirmez la désactivation de la maintenance.

Méthode alternative pour WordPress

Il n'est pas recommandé d'activer la page de maintenance Infomaniak ci-dessus pour travailler ensuite dans WordPress.

Il est recommandé d'installer une extension WordPress (il en existe des dizaines) dédiée à la mise en maintenance au sein du CMS lui-même.

Vous pouvez sinon ajouter le code <?php $upgrading = time(); ?> dans un nouveau fichier vide nommé .maintenance (le point avant le nom du fichier est important) placé sur le serveur à la racine de votre site, ce qui désactivera toutes vos pages sauf la page d'accueil de WordPress.

Ce guide détaille CHMOD (abréviation de change mode) qui permet de changer les permissions d'accès d'un fichier ou d'un répertoire.

Modifier les droits FTP

Les droits (prenez connaissance de cet autre guide Wikipedia) disponibles pour chaque personne/groupe sont les suivantes: 

• lecture: donne le droit de lister (nécessite aussi le droit exécution) et lire dans un répertoire et/ou lire un fichier
• écriture: donne le droit de créer, modifier, renommer, supprimer des fichiers et/ou répertoires
• exécution: pour un répertoire : donne le droit de le traverser pour lire ses sous-répertoires -> Pour un fichier : donne le droit de l'exécuter si c'est un programme ou un script par exemple.
• set uid (?): sur un fichier avec les droits d'exécution cela aura pour effet de l'exécuter avec les droits du propriétaire s'il utilise l'appel système execve ou setuid
• set gid (?): tous les nouveaux fichiers créés appartiendront au groupe du répertoire et sur un fichier avec les droits d'exécution cela aura pour effet de l'exécuter avec les droits du groupe
• sticky bit (?): sur un répertoire, les fichiers du répertoire pourront être renommés ou supprimés uniquement par le propriétaire, même si les autres utilisateurs ont le droit d'écriture. Droit pas vraiment utile sur les fichiers

Le Web FTP sur le Manager permet de changer les permissions des fichiers (y compris celui de /web).

La plupart des logiciels/clients FTP permettent de changer les droits d'accès aux fichiers; la fonction s'appelle généralement "CHMOD" et se trouve sous "Propriétés", "Permissions" ou "Attributs" (en général en faisant clic droit sur le fichier ou dossier à modifier). Une case permet souvent d'appliquer les permissions à tous les sous-répertoires et fichiers dans le dossier, en mode récursif.

Lorsque vous avez coché les permissions qui vous intéressent, validez et les droits seront modifiés sauf ceux que vous n'avez pas l'autorisation de modifier ou plutôt que l'utilisateur sous lequel vous êtes identifié n'a pas le droit de modifier.

En savoir plus

Lorsqu'on parle de changer des permissions, en général il s'agit de faire un "chmod 777", "chmod 666" ou autre. Donc trois chiffres dont:

• le premier correspond aux droits du propriétaire
• le deuxième correspond aux droits du groupe
• le troisième chiffre correspond aux droits des autres utilisateurs.

Et les droits se décomposent ainsi:

• "4" pour le droit de lecture (read)
• "2" pour le droit d'écriture (write)
• "1" pour le droit d'exécution (execute)

Il suffit ensuite d'additionner ces chiffres. Par exemple si vous voulez tous les droits pour le propriétaire mais aucun droit pour les autres, vous ferez "chmod 700" (4 + 2 + 1 = 7). Si vous voulez uniquement les droits de lecture et écriture pour tout le monde (4 + 2 = 6), vous ferez un "chmod 666".

Ces valeurs sont connues de tout bon logiciel/client FTP, donc vous aurez la possibilité de mettre directement le nombre dans votre logiciel/client FTP pour que les permissions soient changées.

Pour changer les permissions sur des fichiers ou répertoires en PHP, vous pouvez également le faire avec la fonction “chmod”, comme sur l'exemple suivant: 

chmod ("/a_folder/a_file", 0755)

Notez que la valeur à appliquer doit être en octale, d'où le zéro devant obligatoire. Attention si vous stockez la valeur dans une variable, vous allez avoir un problème de type de données, que vous pouvez contourner avec la fonction octdec(), comme sur l'exemple suivant:

$mode = 0755;chmod("a_folder/a_file", octdec($mode))

Ce guide concerne les informations d'écoute de Streaming Radio Infomaniak qui peuvent être exportées grâce au protocole FTP ; ces logs (dont sont également issus les statistiques d'écoute (❓: aide) après “épuration" ou "nettoyage”) sont alors automatiquement transférés par FTP pour être ensuite traités.

Préambule

• Les logs de votre radio seront fournis sous forme de fichier compressé xyz.mp3-20140805.log.gz (la date du log est sous forme YYYYMMDD).
• Chaque log commence à 04:00 heure suisse et finit à 03:59:59 le lendemain.
• Le log est sous la forme ip user-identifier authuser [date-time] "request" status octets "referer" "useragent" listening-time:

  • 81.56.215.98 - - [09/Apr/2019:08:23:18 +0200] "GET /toto.mp3 HTTP/1.1" 200 1211297 "-" "Mozilla/5.0 (X11; U; Linux i686; en-US; rv:1.9.0.8) Gecko/2019032711 Ubuntu/8.10 (intrepid) Firefox/3.0.8" 69

  • Il peut arriver que la ligne de log soit mal formée, à cause d'un referer trop long par exemple ; ce comportement d'Icecast ne peut être modifié.
• Les adresses de la rangée IP 84.16.67.128/25 doivent être ignorées car ce sont les serveurs de streaming.
• Depuis la page des paramètres sur le Manager, vous pouvez redemander les logs des jours passés.
• Vous pouvez également directement les exporter vers ACPM (❓: aide) ou Mediapulse (❓: aide).

Activer l'envoi de logs par FTP

Pour cela:

1. Cliquez ici afin d'accéder à la gestion de votre produit sur le Manager Infomaniak (besoin d'aide ?).
2. Cliquez directement sur le nom attribué au produit concerné.
3. Cliquez sur le nom du flux audio concerné.
4. Cliquez sur Paramètres dans le menu latéral gauche.
5. Activez l'export de logs par FTP avec le bouton à bascule (toggle switch).
6. Entrez un nom d'hôte: adresse du serveur FTP.
7. Entrez un nom d'utilisateur: nom du compte FTP.
8. Entrez un mot de passe: celui du compte FTP.
9. Entrez le répertoire sur le serveur dans lequel stocker les logs.
10. Cliquez sur le bouton Enregistrer en bas de page:
    

Traiter les logs

Le mieux est d'utiliser une expression régulière comme celle ci-dessous: 

"/^(\S+)\s(.+)\s(\S+)?\s\[((\d\d)\/([a-zA-Z]{3,3})\/(\d\d\d\d)\:(\d\d)\:(\d\d)\:(\d\d)\s\+\d\d\d\d)\]\s"GET\s\/([\-a-z0-9]{1,40}(\.)?(mp3|aac|ogg){0,1})(.*)?"\s(\d{3,3})\s(\d+)\s"(.+)"\s"(.+)"\s(\d+)$/i";

Cette syntaxe est celle de la fonction PHP preg_match et devra être adaptée si d'autres fonctions/langages sont utilisés.

La fonction preg_match donne un tableau dont voici les positions significatives:

Ce guide détaille l'envoi d'e-mail authentifié depuis un site / CMS hébergé par Infomaniak.

Préambule

• Configurer l'envoi d'e-mails de votre site via un serveur SMTP authentifié permet d'améliorer la fiabilité et la sécurité des envois, par rapport à la fonction PHP mail() utilisée sans authentification:
  • meilleure fiabilité de livraison des e-mails,
  • sécurité renforcée,
  • détection plus précise des erreurs d'envoi,
  • meilleure compatibilité avec les services de messagerie,
  • et meilleure traçabilité des envois.

Exemples de configuration SMTP

Prérequis

• Posséder un service de messagerie.
  • Vous avez la possibilité d'utiliser le Service Mail proposé par Infomaniak ou tout autre service de messagerie à votre convenance.
• Créer un mot de passe d'appareil (❓: aide my kSuite  |  Service Mail/kSuite).
• Utiliser les paramètres recommandés:
  • Serveur SMTP sortant = mail.infomaniak.com
  • Port SMTP & protocole de chiffrement et commande/méthode pour activer ce protocole: 587 + STARTTLS
  • Nom d'utilisateur/username = l'adresse mail complète & entière (❓: aide).
  • Mot de passe/password = celui généré pour l'adresse mail que vous voulez utiliser
  • Authentification obligatoire pour l'envoi des e-mails:
    • Elle s'active dans les paramètres SMTP de votre CMS.
    • Cochez "utiliser les mêmes paramètres que le serveur entrant" ou selon les CMS, remettez un nom d'utilisateur (= adresse mail complète & entière) et le mot de passe généré.

WordPress

Pour permettre à votre site d'envoyer des e-mails, utilisez une adresse mail de son domaine (par exemple e-mail@domain-site.xyz) et renseignez les paramètres SMTP (cf prérequis):

1. Connectez-vous au tableau d'administration WordPress.
2. Installez une extension SMTP (WP Mail SMTP fonctionne).
3. Configurez l'extension, par exemple:
   ‍

Dès lors, un e-mail envoyé depuis un formulaire de contact présent sur le site (formulaire par défaut Divi par exemple) le sera via une méthode SMTP.

Pour s'en assurer, il suffit de regarder les en-têtes d'un message parvenu par ce biais notamment la ligne x-mailer qui pourra mentionner par exemple WPMailSMTP/Mailer/smtp au lieu de PHPMailer.

Prestashop

Pour permettre à votre site d'envoyer des e-mails, utilisez une adresse mail de son domaine (par exemple e-mail@domain-site.xyz) et renseignez les paramètres SMTP (cf prérequis):

1. Connectez-vous au tableau d'administration Prestashop.
2. Allez sous Paramètres avancés puis E-mail.
3. Configurez l'envoi via SMTP:
   

Vérifiez ensuite (afin d'éviter une erreur type Could not instantiate mail function ou sender mismatch) que l'adresse que vous avez configuré dans ces paramètres avancés corresponde bien à l'adresse qu'utilise Prestashop lors des envois. Pour cela:

1. Connectez-vous au tableau d'administration Prestashop.
2. Allez sous Paramètres de la boutique.
3. Cliquez sur Contact dans le menu latéral gauche.
4. Sur l'onglet Contacts, vérifiez que l'adresse mail mentionnée soit la même que celle configurée précédemment.
5. Éditez les adresses mail si nécessaire:
   
6. Cliquez sur l'onglet Magasins.
7. Vérifiez (et corrigez si nécessaire pour) que l'adresse mail mentionnée soit la même que celle configurée précédemment:
   

Joomla

Pour permettre à votre site d'envoyer des e-mails, utilisez une adresse mail de son domaine (par exemple e-mail@domain-site.xyz) et renseignez les paramètres SMTP (cf prérequis):

1. Connectez-vous au tableau d'administration Joomla.
2. Cliquez sur Système dans le menu latéral gauche.
3. Cliquez sur Configuration générale.
4. Cliquez sur l'onglet Serveur:
   
5. Configurez l'envoi via la méthode d'envoi SMTP:
   

Ce guide explique comment installer un nouveau site WordPress Infomaniak inclus dans les offres d'Hébergement Web payantes. Vous trouverez 2 différentes façons de créer un site WordPress ainsi que des explications au sujet de la désinstallation.

Créer un site WordPress sur un hébergement existant

Afin d'accéder à l'Hébergement Web et d'y ajouter un nouveau site en installant WordPress en même temps :

1. Cliquez ici afin d'accéder à la gestion de votre hébergement sur le Manager Infomaniak (besoin d'aide ?).
2. Cliquez directement sur le nom attribué à l'hébergement concerné.
3. Cliquez sur le bouton pour ajouter un site:
   
4. Choisissez d'installer WordPress.
5. Cliquez sur le bouton Suivant:
   
6. Cliquez sur le bouton pour utiliser un nom de domaine déjà présent dans votre Organisation (ou sur l'autre bouton si vous devez d'abord commander un nouveau domaine).
7. Sélectionnez le nom de domaine parmi vos domaines déjà acquis.
   1. Les options avancées permettent notamment de choisir un emplacement personnalisé sur le serveur de l'hébergement, et une version antérieure de PHP.
8. Cliquez sur le bouton Suivant:
   
9. Patientez quelques minutes le temps de la création du site sur l'hébergement:
   
10. Entrez les informations demandées, elles vous serviront à vous connecter dans le tableau de bord WordPress (il est possible de modifier ces informations en tout temps après l'installation).
11. Cliquez sur le bouton Suivant:
    
12. Entrez les informations relatives à votre site (il est possible de modifier ces informations en tout temps après l'installation).
13. Cliquez sur le bouton Suivant:
    
14. Choisissez entre le thème Divi et le thème officiel de la version WordPress la plus récente (il est possible de modifier ces informations en tout temps après l'installation).
15. Cliquez sur Suivant:
    
16. Confirmez l'installation depuis la page de résumé.
17. Vous pourrez ensuite vous connecter sur le tableau de bord WordPress ou revenir sur la gestion du site.

Installer WordPress sur un site vierge existant

Afin d'accéder au site vierge existant sur l'hébergement et d'y installer WordPress :

1. Cliquez ici afin d'accéder à la gestion de votre site sur le Manager Infomaniak (besoin d'aide ?).
2. Cliquez directement sur le nom attribué au site concerné.
3. Cliquez sur le bouton pour ajouter une applcation:
   
4. Choisissez d'installer WordPress:
   
5. Cliquez sur le bouton Suivant tout en bas de la page.
6. Entrez les informations demandées, elles vous serviront à vous connecter dans le tableau de bord WordPress (il est possible de modifier ces informations en tout temps après l'installation).
7. Cliquez sur le bouton Suivant:
   
8. Continuez ainsi comme à partir du point 12 du chapitre précédent ci-dessus.
   

Désinstaller WordPress Infomaniak

Vous pouvez effacer un site WordPress:

1. en supprimant le site complètement de l'hébergement (et en gardant ou non les données WordPress, bases de données, etc.)
2. en conservant le site sur l'hébergement mais en retirant l'app WordPress…

Option 1

1. Cliquez ici afin d'accéder à la gestion de votre site WordPress sur le Manager Infomaniak (besoin d'aide ?).
2. Cliquez sur le menu d'action ⋮ situé à droite de l'élément concerné.
3. Cliquez sur Délier le site:
   
4. Choisissez si vous souhaitez tout effacer ou conserver malgré tout une trace des données WordPress sur le serveur de l'hébergement:
   1. Si vous activez la case à cocher, il n'y aura plus rien côté Manager (hormis les sauvegardes):
      
      et plus rien côté serveur:
      
   2. Si vous ne cochez pas la case, il n'y aura plus rien côté Manager (hormis les sauvegardes):
      
      mais les fichiers WordPress seront encore accessibles sur le serveur:
      
      Et vous obtiendrez une erreur si par la suite vous tentez la réinstallation d'un nouveau site WordPress au même endroit avec le même nom de domaine:
      
5. Confirmez la suppression.
6. Cliquez pour supprimer et patientez.

Option 2

1. Cliquez ici afin d'accéder à la gestion de votre site WordPress sur le Manager Infomaniak (besoin d'aide ?).
2. Cliquez directement sur le nom attribué au site concerné:
   
3. Cliquez sur le menu d'action ⋮ situé à droite de l'élément concerné.
4. Cliquez sur Supprimer l'app:
   
5. Confirmez le suppression et patientez, votre hébergement contiendra toujours un site mais sans application installée:
   

En savoir plus

• Voir toutes les FAQ WordPress
• Installer un certificat SSL gratuit
• Installer une autre application Web

Ce guide vous permet de découvrir rapidement les fonctions essentielles de Euria, l'intelligence artificielle à votre disposition au sein de kSuite, performante notamment avec l'app Web kDrive Infomaniak (service en ligne ksuite.infomaniak.com/kdrive).

✘ INDISPONIBLE‍ avec
kSuite Free / kSuite Standard
my kSuite / my kSuite+ (ik.me, etik.com, ikmail.com)
kDrive Solo / kDrive Team / kDrive Pro

Utiliser l'IA pour vos fichiers sur kDrive

Prérequis

• Être au minimum Administrateur de l'Organisation (❓: aide).
• Activer Euria à tous les utilisateurs de votre kDrive concerné: suivre l'assistant qui s'ouvre à la connexion du kDrive (❓: aide).
• Lire et comprendre cet autre guide au sujet du modèle utilisé et des responsabilités de chacun.

Pour accéder à Euria sur kDrive:

1. Cliquez ici afin d'accéder à kDrive sur votre kSuite Infomaniak (❓: aide).
2. Ouvrez un document PDF (Euria est également disponible avec d'autres types de fichier texte / code : .md, .txt, .json, .php, etc.) ou effectuez un clic-droit sur le fichier en question:
   
3. Euria va s'ouvrir dans un volet latéral droite ; si vous le fermez, Euria reste accessible via l'icône ronde située en haut à droite:
   

Comment Euria peut aider?

Euria vous aide à exploiter efficacement le document que vous avez ouvert (et uniquement celui-ci) ; elle peut notamment:

• répondre à vos questions sur son contenu (détails, statistiques, changements)
• en résumer les points clés (voire même le vulgariser et encore plus si vous précisez “pour un enfant de 10 ans”…)
• le traduire
• fournir des métadonnées (taille, date de création ou de modification)
• expliquer les termes ou acronymes qui y figurent

Par exemple si le document est un long rapport de société sur l'année écoulée, vous pouvez demander la taille actuelle du département Développement, quels sont les projets en priorité absolue, ou encore la dernière date de modification du document…

Créer un évènement pour votre agenda

Avec un document mentionnant un rendez-vous (médical par exemple), vous pouvez demander à Euria de créer un bout de code qui, une fois copié-collé dans un fichier adéquat, vous permettra d'ajouter un évènement sur votre calendrier. Exemple de formulation: “Crée un event au format ics en prenant les détails de ce rendez-vous”.

Euria peut également extraire des évènements à partir d'un document plus complexe:

Euria va vous expliquer ce qu'il a fait (un code VCALENDAR) et ce qu'il vous faudra faire: créer un nouveau fichier avec l'extension .ics contenant le code qu'il a généré, et l'ouvrir sur votre ordinateur afin de l'importer dans votre app d'agenda habituelle ou l'importer sur votre calendrier kSuite (❓: aide)…

Créer un arbre généalogique des personnages

Avec un livre stocké sur votre kDrive, vous pouvez demander à Euria de faire un arbre généalogique précis et complet pour montrer les liens entre tous les personnages. Vous obtiendrez ainsi une liste de noms/prénoms avec leurs relations.

Mais vous pouvez pousser l'expérience plus loin en demandant ensuite un diagramme “Mermaid” basé sur cette liste. Il vous suffira de copier-coller le code proposé par Euria dans un outil comme mermaid.live:

Analyser une enquête, rédiger un article de blog

A partir d'un document de type enquête / reportage, vous pouvez demander à Euria de rédiger un nouvel article au ton que vous souhaitez et adressé à la cible désirée. Exemple: “A partir de tout ça, écris un article de blog avec un titre accrocheur et un texte de max 400 mots, pour un public cible de femmes de 30 à 40 ans”.

Mais vous pouvez également lui demander de trouver “quels sont les biais de cette enquête” ou "quels éléments mériteraient d'être approfondis ou vérifiés". Euria peut ainsi vous aider à adopter une posture critique face à une enquête ou un reportage, en pointant les éventuelles lacunes, exagérations ou partis pris.

Elle peut aussi reformuler les conclusions de l'enquête pour différents publics (professionnels, adolescents, lecteurs curieux…), suggérer des angles alternatifs pour un article dérivé, ou encore générer des titres, introductions ou synthèses selon le niveau de complexité souhaité.

L'objectif est de tirer un maximum de valeur éditoriale d'un même contenu source, en diversifiant les formes, les tons et les points de vue.

Ce guide explique comment maintenir un contrôle sur vos flux de Streaming Radio MP3/AAC ou HLS en activant la protection par clé unique (token) afin de décider par exemple si un auditeur peut écouter votre radio ou non.

Préambule

• A chaque connexion, vous effectuerez une requête vers l'API Infomaniak qui vous renverra en retour un token unique avec une durée de vie limitée et paramétrable.
• Ce token autorisera quiconque le possède à consommer le flux pendant cette période.
• Vous pouvez protéger un flux MP3/AAC ou HLS indépendamment l'un de l'autre (idem pour la géolocalisation d'ailleurs).
• L'activation de la restriction implique un changement de la configuration du flux qui peut prendre quelques minutes pour être répliquée sur les serveurs.

Protéger un flux audio par clé unique

Pour ce faire, il suffit de se rendre dans les paramètres de restrictions et d'activer la protection par token sur le flux que vous souhaitez sécuriser:

1. Cliquez ici afin d'accéder à la gestion de votre produit sur le Manager Infomaniak (besoin d'aide ?).
2. Cliquez directement sur le nom attribué au produit concerné:
   
3. Cliquez:
   1. soit sur le nom de la radio:
      
   2. soit sur Restrictions dans le menu latéral gauche pour appliquer des restrictions au produit entier:
      
4. Lors du choix  a  ci-dessus, cliquez ensuite sur Restrictions dans le menu latéral gauche.
5. Choisissez HLS si nécessaire.
6. Cliquez sur le menu d'action ⋮ situé à droite de l'élément concerné.
7. Cliquez sur Restriction par token:
   
    

Activez ensuite la protection.

Attention, au moment où vous allez activer cette option, l'accès au flux sera instantanément bloqué pour les nouvelles connexions. Adaptez vos Players pour prendre en compte la restriction, comme illustré dans l'exemple ci-dessous :

Créer un token API Radio

Pour avoir accès à l'API Radio, vous devez en premier lieu vous authentifier grâce à un token application. Cette étape n'est à faire qu'une seule fois. Pour créer ce token d'application, prenez connaissance de cet autre guide.

Le scope est radio et la durée de vie illimité pour éviter de devoir régénérer un code de manière régulière. Une fois le token généré, le copier afin de le coller dans l'exemple ci-dessous.

Exemple d'utilisation en langage PHP

Pour MP3/AAC ou HLS, le code peut être sensiblement le même, seule l'URL appelée en POST change au niveau de sa forme.

if (!defined('API_TOKEN')) {
     define('API_TOKEN', 'AYF5lSh3c7Xy5974Fs12RTkTThujT-L9R4Xk2ZfGyP6sV7QqJ1oC3jD8nFtKzIxUeMw5oNzR6');
}
/**
 * Fonction générique pour executer des requêtes cURL
 *
 * @param string $method Méthode HTTP (GET, POST, PUT, etc...)
 * @param string $url Url de l'api a requêter
 * @param array $headers Liste des en-têtes HTTP (l'autorisation doit être passée ici avec un ['Authorization: Bearer ']
 * @param array $payload Un tableau contenant les données pour créer un token
 * @return mixed
 */

function request(string $method, string $url, array $headers = [], array $payload = []): mixed{
    // prepare options array
    $opts = [
        CURLOPT_HTTPHEADER => $headers,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_URL => $url,
        CURLOPT_CUSTOMREQUEST => strtoupper($method),
    ];

    // add payload if relevant
    if ($payload && $method !== 'GET') {
        $opts[CURLOPT_POSTFIELDS] = json_encode($payload);
    }
    $ch = curl_init();
    curl_setopt_array($ch, $opts);
    $result = curl_exec($ch);
    if(curl_errno($ch)){
        throw new Exception(curl_error($ch));
    }
    $data = json_decode($result, true);
    if ($data['result'] === 'error') {
        throw new Exception($data['error']['description'] ?? 'an error occured');

    }
    return $data['data'];
}

On va créer le token, l'URL de création du token se décompose comme suit :

• Pour un flux MP3 / AAC

POST https://api.infomaniak.com/1/radios/acl/streams/mountpoint.mp3/token

Exemple pour protéger https://newradiotest.ice.infomaniak.ch/newradiotest-128.aac la route sera: https://api.infomaniak.com/1/radios/acl/streams/newradiotest-128.aac/token

• Pour un flux HLS

POST https://api.infomaniak.com/1/radios/acl/hls_streams/<stream>/token

Exemple pour protéger https://myradiostream.radiohls.infomaniak.com/myradiostream/manifest.m3u8 la route sera: https://api.infomaniak.com/1/radios/acl/hls_streams/myradiostream/token

Exemple dans le cas du MP3 / AAC, pensez à ajuster :

$token = request(
    'POST',
   'https://api.infomaniak.com/1/radios/acl/streams/newradiotest-128.aac/token',
    // en-tête d'authorization
    [
        'Authorization: Bearer ' . API_TOKEN,
        'Content-Type: application/json',
    ],
    /**
     * payload pour créer le token, vous pouvez passer les valeurs suivantes
     * window     | 300               | optionnel | durée de validité du token (default: 5 minutes)
     */

    [
        'window' => 3600, // 1h validity
    ]
);

Il est important de noter que si ce code est généré au moment du chargement de la page, l'auditeur aura "window" secondes pour lancer la lecture du flux. Au-delà de ce délai, le token expirera, et le flux ne pourra plus être lancé à moins que la page ne soit rechargée. Selon vos besoins et votre cas d'utilisation, il sera nécessaire d'ajuster ce délai de la meilleure manière possible.

Il faudra également remplacer ci-dessous l'URL de lecture de votre flux à la place de celle indiqué tout en conservant le paramètre $token à la fin. Et pour finir, on affiche le Player (ici une simple balise html5, mais on peut ajouter bien sûr n'importe quelle surcouche après, le token étant passé dans les paramètres $_GET de l'url).

$streamUrl = "https://newradiotest.ice.infomaniak.ch/newradiotest-128.aac?$token";
echo "<audio controls=""><source src="$streamUrl"></audio>";