Base de connaissances

Ce guide explique comment valider la double authentification, ou vérification en deux étapes, par le biais d'une app Infomaniak déjà installée sur vos appareils.

Préambule

• Prenez connaissance de cet autre guide au sujet de l'activation de la fonctionnalité de 2FA.

Recevoir une notification lors d'une demande d'autorisation de connexion via les apps Infomaniak

A partir du moment où vous activerez la 2FA en configurant l'une des méthodes proposées, ce sont automatiquement les apps Infomaniak (Mail, Euria, kDrive…) qui vous permettront de valider la connexion lors d'une connexion depuis un autre appareil:

1. Une modale s'ouvre pour vous demander de valider la connexion si celle-ci provient bien de votre fait:
   
2. Vous pouvez bien entendu demander au cas par cas de recevoir la demande de validation sur l'une des autres méthodes enregistrées:
   
3. Dans ce cas, vous accédez aux différentes méthodes 2FA déjà enregistrées sur votre compte:
   

Si vous avez activé plusieurs méthodes de validation (SMS, application OTP…), vous pouvez définir celle qui sera proposée par défaut lors de chaque connexion. Notez toutefois que la méthode prioritaire restera celle de la validation dans l'app Infomaniak installée (Mail, Euria, kDrive…) sur vos appareils:

1. La notification s'affiche en plein écran lorsque vous ouvrez l'application spécifiée, et un bouton vous permet de valider la connexion (s'il s'agit bien de vous-même):
   
2. Dans les paramètres Android des apps Infomaniak (Mail par exemple), vous pouvez choisir de n'activer que la notification de demande d'authentification de connexion:
   
3. Ainsi une notification Android vous prévient de la demande d'authentification en cours, et vous pouvez ouvrir l'app directement depuis la notification:
   

Infomaniak Authenticator est une application mobile gratuite qui améliore et simplifie la sécurité des comptes Infomaniak protégés par l'authentification à deux facteurs (ou double authentification / 2FA). C'est l'une des méthodes qui permet de sécuriser l'accès à votre compte utilisateur Infomaniak.

Préambule

• La validation en deux étapes protège votre compte et vos données personnelles lors de la connexion aux outils Infomaniak (manager.infomaniak.com et ksuite.infomaniak.com) en demandant:
  • votre mot de passe…
  • puis une seconde méthode de sécurité.
• L'app mobile Infomaniak Authenticator figure parmi ces méthodes et permet de recevoir une notification push OUI / NON afin d'autoriser ou non la connexion à votre compte Infomaniak.
• Si une autre app Infomaniak (Mail, Euria, kDrive…) est installée et que votre identifiant utilisateur y est également connecté, alors la demande d'autorisation peut se faire par ce biais ; prenez connaissance de cet autre guide à ce sujet.
• Dans tous les cas, il est recommandé de noter précieusement les codes de secours proposés au téléchargement après chaque configuration: téléchargez et conservez en sécurité une copie de ces codes car ils seront l'unique moyen d'accéder à votre compte en cas de perte de vos identifiants ou pour accéder à votre compte sans accès à votre téléphone.

Installer l'app Infomaniak Authenticator

Prérequis

• Posséder un compte Infomaniak (connaître son identifiant et son mot de passe afin de pouvoir s'y connecter).
• Posséder un appareil mobile iOS ou Android.
• Depuis votre appareil mobile iOS ou Android, téléchargez l'app Infomaniak Authenticator ici:
  
  
   

Installer et ouvrir l'application.

Ajouter l'app comme méthode de double authentification

Une fois l'app ouverte, au sein de cette dernière, connectez-vous au compte Infomaniak désiré, afin d'activer Infomaniak Authenticator comme méthode de 2FA.

Fonctionnement de l'app mobile

Lorsque vous tentez, depuis n'importe quel appareil, de vous connecter à votre compte et après avoir saisi avec succès votre mot de passe habituel, vous recevez une notification push sur votre appareil mobile qui vous demande d'autoriser la connexion ("Approuver / Décliner"), via l'app Infomaniak Authenticator:

Si la connexion est autorisée, la page initiale est automatiquement redirigée vers le compte Infomaniak. 

Migration depuis kAuth vers Authenticator

Pour cela:

1. Ouvrez Infomaniak Authenticator depuis votre appareil mobile.
2. Les comptes Infomaniak pouvant être migrés apparaîtront automatiquement puis cliquez sur Continuer:
   
3. Rentrez vos identifiants si nécéssaire:
   
4. Tout est prêt cliquez sur Continuer:
   
5. Il est recommandé d'autoriser les notifications:
   

Ajouter des comptes supplémentaires

Infomaniak Authenticator permet de gérer plusieurs comptes Infomaniak:

1. Ouvrez Infomaniak Authenticator depuis votre appareil mobile.
2. Cliquez sur le bouton bleu ‍: 
   
   En bas à droite sur Android.
3. Identifiez le compte que vous souhaitez ajouter.

Supprimer un compte de Infomaniak Authenticator

Pour supprimer votre identité Infomaniak de l'app Infomaniak Authenticator.

1. Sélectionnez le compte que vous souhaitez retirer.
2. Cliquez sur Déconnecter:
   

Ce guide liste les versions du système d'exploitation Windows qu'il est possible d'installer lors de la commande d'un VPS Cloud / VPS Lite.

Versions de Windows supportées

Lors de la commande de votre Serveur, vous pourrez choisir la version de Windows à installer.

Windows Server

Déclinaisons possibles avec Windows Server 2025, 2022 ou 2019:

• Windows Server Standard conçu pour les environnements à faible densité ou non virtualisés
• Windows Server Datacenter idéal pour les environnements de datacenter-defined et hautement virtualisés

A noter:

• En tant que partenaire Microsoft, Infomaniak fournit des VPS Cloud / VPS Lite Windows Server 2025, 2022 ou 2019 contenant une licence Microsoft Windows Server. En cas de défaut d'activation, prenez connaissance de cet autre guide.
• En tant que partenaire Microsoft, Infomaniak ne propose pas la possibilité d'utiliser votre propre licence Windows Server (ou Bring You Own Licence).
• Si vous utilisez des logiciels Microsoft au sein de Windows Server nécessitant une Licence Mobility, comme Microsoft SQL Server, Microsoft Sharepoint Server ou Microsoft Exchange Server, vous devez obligatoirement transmettre le document de Software Assurance via le formulaire de contact Infomaniak.

Windows 11 Professionnel Evaluation

Windows 11 Professionnel possède toutes les fonctionnalités de Windows 11 Famille ainsi que des fonctionnalités professionnelles pour le chiffrement, la connexion à distance, la création de machines virtuelles et bien plus.

A noter:

• Il sera nécessaire d'activer Windows, Infomaniak fournit uniquement une version d'évaluation.

Ce guide explique les différences entre les deux types de modes de paiement possibles au sein d'un partenariat (avec accès complet accordée au partenaire).

En effet, dans le contexte de l'ajout d'un Partenaire pour la gestion de vos produits, si vous accordez tous les droits, vous devrez décider s'il faut également leur confier la totalité de la partie facturation.

Modes de paiement ...

... du Client

Dans ce cas:

• Le Client gère la facturation et règle les commandes et les renouvellements effectués par le Partenaire.
• Le Partenaire:
  • Paye le prix public et recevra un revenu (cashback) dans leur compte en fonction des avantages qu'ils reçoivent en tant que revendeur Infomaniak
  • Reçoit également un revenu (remboursement) pour toute commande et tout renouvellement effectués directement par leur client.
• Les factures ne seront accessibles qu'au sein de l'organisation du Client, et le Partenaire n'y aura pas accès.
• Les produits seront installés directement au sein de l'Organisation du client.

... du Partenaire

Dans ce cas:

• Le partenaire
  • Gère la facturation et règle les commandes et les renouvellements faits pour son client
  • Bénéficie directement des rabais aux revendeurs lors de la commande et du renouvellement pour le compte de leur client
  • Reçoit également un revenu (remboursement) pour toute commande et tout renouvellement effectués directement par leur client.
• Les factures ne seront disponibles qu'au sein de l'organisation du Partenaire, et le Client n'y aura pas accès.
• Les produits seront installés directement au sein de l'organisation du client.

Modifier le mode de paiement

Dans le cadre de l'octroi du plein accès à un associé, le Client peut changer le type de mode de paiement utilisé dans le partenariat à tout moment:

1. Connectez-vous au Gestionnaire d'Infomaniak (manager.infomaniak.com).
2. Cliquez sur Partenaire dans le menu de la barre latérale gauche.
3. Cliquez sur le nom du partenaire concerné:
   
    
4. Cliquez sur l'icône du crayon en haut de la page à droite de Paiement:
   
5. Modifiez et vérifiez les informations souhaitées.

Le Partenaire recevra une notification de la modification par mail.

Prenez également connaissance de cet autre guide.

Ce guide explique comment accéder à votre box domotique Jeedom (qui se trouve derrière une adresse IP dynamique, fournie par votre FAI) avec un nom de domaine chez Infomaniak via l'option gratuite DynDNS (❓: aide).

Préambule

• L'intégration que vous installez agit comme un messager: elle surveille en permanence l'adresse IP de votre réseau local.
• Dès qu'elle détecte que votre fournisseur d'accès a changé votre IP, elle envoie instantanément un signal à Infomaniak.
• Infomaniak met alors à jour votre nom de domaine (ex: jee.domain.xyz) pour qu'il pointe vers la nouvelle adresse IP.

Lier Jeedom à un nom de domaine

Prérequis

• Posséder une installation Jeedom (sur Raspberry Pi 5 par exemple) connectée à Internet avec une adresse IP dynamique.
• Un DNS dynamique doit avoir été créé sur le domaine concerné depuis le Manager Infomaniak (❓: aide).

Ensuite:

1. Installez le plugin (❓: aide) officiel et gratuit sur votre application Jeedom depuis le Market.
2. Activez le plugin comme à votre habitude.
3. Configurez un nouvel équipement en choisissant Infomaniak dans la liste des services:
   
   • Nom d'hôte : l'URL configurée dans le Manager lors de l'ajout du Dynamic DNS (❓: aide).
   • Nom d'utilisateur : l'identifiant défini dans le Manager lors de l'ajout du Dynamic DNS (❓: aide).
   • Mot de passe : le mot de passe défini dans le Manager lors de l'ajout du Dynamic DNS (❓: aide).

Jeedom va vérifier toutes les 15 minutes l'IP externe, si celle-ci a changé alors le DNS sera mis à jour. Ainsi votre nom de domaine pointera continuellement sur votre installation domotique même si votre Fournisseur d'Accès à Internet change votre adresse IP publique.

Ce guide concerne le document technique mis à votre disposition au format PDF lorsque vous souscrivez au Support Premium.

Préambule

• Conservez précieusement sur vos installations le document PDF mis à disposition.
• Cette procédure vous permet de contacter Infomaniak dans tous les cas, même si Infomaniak ou votre connexion Internet devait momentanément être indisponible.
• Ce document contient vos informations utiles comme le code VIP :
  

Obtenir le document technique

Pour télécharger le document PDF:

1. Cliquez ici afin d'accéder à la gestion de votre produit sur le Manager Infomaniak (besoin d'aide ?).
2. Cliquez sur Télécharger le document:
   

Ce guide concerne la création de réseaux privés entre différentes offres d'hébergement Infomaniak comme VPS Cloud / VPS Lite, Public Cloud, NAS Synology, etc.

Créer un VLAN entre VPS

Il est recommandé de migrer vers l'offre Public Cloud pour créer de tels réseaux privés entre VM.

Ce guide détaille la gestion des accès et de la sécurité pour vos bases de données (MySQL, MariaDB et MongoDB) sur un Serveur Cloud managé.

Préambule

• Le pare-feu est accessible dans votre Manager même si aucun site Apache n'est configuré (utile pour les projets exclusivement Node.js par exemple).
• Concernant l'accès aux bases MySQL depuis un autre hébergement Web Infomaniak, prenez connaissance de cet autre guide.
• Concernant MongoDB:
  • Pour garantir la sécurité de vos données, le système bloque l'enregistrement si vous tentez de désactiver le mode local_only sans activer l'authentification.
  • Les sauvegardes automatiques d'Infomaniak n'incluent pas les bases de données MongoDB.

Autoriser l'accès sortant (Infomaniak → extérieur)

Depuis un hébergement Web ou un Serveur Cloud Infomaniak, les requêtes vers des bases de données externes sont autorisées par défaut sans restriction de port.

Autoriser l'accès entrant (extérieur → Infomaniak)

Pour accéder à vos bases de données depuis l'extérieur, vous devez posséder un Serveur Cloud et ouvrir les ports correspondants dans le pare-feu de votre serveur :

• MySQL / MariaDB : port 3306 (TCP)
• MongoDB : port 27017 (TCP)

Configurer l'accès distant pour MongoDB

Par défaut, MongoDB n'accepte que les connexions locales.

Pour permettre un accès distant via Fast Installer, vous devez ajuster la configuration tout en respectant des règles de sécurité strictes.

1. Cliquez ici afin d'accéder à la gestion de votre Serveur Cloud sur le Manager Infomaniak (besoin d'aide ?).
2. Cliquez directement sur le nom attribué au Serveur Cloud concerné.
3. Cliquez sur Fast Installer dans le menu latéral gauche.
4. Cliquez sur MongoDB.
5. Cliquez sur le menu d'action ⋮ à droite de l'instance et choisissez Configurer.
6. Désactivez l'option local_only.
7. Activez l'option authentification.
8. Enregistrez les modifications:
   

Ce guide explique comment modifier la configuration serveur d'un site sur Hébergement Web Infomaniak.

Préambule

• Apache est le serveur HTTP.
  • Il se configure avec un fichier .htaccess placée à la racine du site.
• PHP est un langage de programmation utilisé pour créer des pages dynamiques via un serveur HTTP.
  • Il est possible de personnaliser les directives PHP avec un fichier .user.ini lesquelles seront effectives dans les dossier et sous-dossiers de l'emplacement du fichier .user.ini.
• Prenez connaissance de cet autre guide au sujet de la création de fichiers .htaccess & .user.ini.

Modifier la configuration serveur d'un site…

… via le Manager

Pour modifier la configuration PHP et la plupart des paramètres (max_input_vars, allow_url_fopen, memory_limit, post_max_size + upload_max_filesize , etc.):

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 Gérer les paramètres avancés:
   
4. Cliquez sur les différents onglets Général, PHP / Apache et Extensions PHP pour procéder aux ajustements désirés:
   
   • Prenez connaissance de cet autre guide si vous recherchez des informations au sujet des valeurs limites et des possibilités de déblocage de ces dernières.
   • Prenez si nécessaire connaissance de cet autre guide concernant le quatrième onglet.

… via le fichier .user.ini

Pour les directives PHP qui ne sont pas présentes côté Manager, il est nécessaire de définir les valeurs souhaitées dans le fichier .user.ini par exemple:

max_file_uploads = 20

La liste des directives existantes se trouve sur le site officiel de PHP mais les éléments avec l'indication PHP_INI_SYSTEM dans la colonne Modifiable ainsi que max_input_time, memory_limit et mysqli.default_socket ne sont pas utilisables.

… en CLI

Pour personnaliser des directives PHP lors de l'exécution de scripts en ligne de commande (CLI) ou dans des tâches CRON, il est nécessaire de spécifier les valeurs souhaitées dans un fichier .user.ini.

Ensuite, pour appliquer ces configurations, on utilise l'exécutable PHP avec l'option -c suivi du chemin vers le fichier .user.ini.

Par exemple pour modifier la limite de mémoire disponible pour PHP à 1024M, on peut créer ou modifier le fichier .user.ini en utilisant la commande suivante:

echo 'memory_limit = 1024M' > .user.ini

Cette commande écrit la directive memory_limit avec la valeur 1024M dans le fichier .user.ini.

Ensuite, lors de l'exécution d'un script PHP en ligne de commande ou dans une tâche CRON, on utilisera la commande PHP avec l'option -c pour spécifier le fichier .user.ini contenant les configurations personnalisées.

L'exemple suivant active allow_url_fopen pour l'outil WP CLI (permet notamment de récupérer des extensions):

php -d allow_url_fopen=On ~/bin/wp package install trepmal/wp-revisions-cli

• php: l'exécutable PHP
• -d allow_url_fopen=On: l'option -d permet de définir une directive de configuration PHP (allow_url_fopen) avec la valeur On
• ~/bin/wp: chemin vers l'exécutable WP CLI
• package install trepmal/wp-revisions-cli: la commande spécifique pour installer le package WP CLI trepmal/wp-revisions-cli

Cela garantit que l'option allow_url_fopen est activée pendant l'exécution de la commande WP CLI spécifiée. L'activation de allow_url_fopen peut être nécessaire pour certaines opérations qui impliquent l'ouverture d'URL distantes, comme le téléchargement d'extensions ou de packages. Assurez-vous que cette option est activée de manière sécurisée et conformément aux meilleures pratiques de sécurité.

Ce guide explique comment désinstaller un Certificat SSL quel que soit son type, initialement installé depuis le Manager Infomaniak. Si votre certificat est de type payant et que vous souhaitez plutôt résilier l'offre en cours, prenez connaissance de cet autre guide.

Supprimer un certificat SSL

Pour désinstaller un certificat Infomaniak :

1. Cliquez ici afin d'accéder à la gestion de votre certificat SSL sur le Manager Infomaniak (besoin d'aide ?).
2. Cliquez directement sur le nom attribué au produit concerné:
   
3. Cliquez sur le menu d'action ⋮ situé à droite de l'élément concerné.
4. Cliquez sur Désinstaller:
   
5. Confirmez la désinstallation du certificat.

Ce guide concerne le cache de requêtes MySQL qui, lorsqu'il est activé, stocke en mémoire les résultats des requêtes déjà exécutées. 

Préambule

• MySQL Query Cache permet d'accélérer les requêtes identiques ultérieures en évitant de les exécuter à nouveau.
• Cela peut améliorer les performances globales du serveur de base de données en réduisant la charge et en diminuant le temps de réponse pour les requêtes fréquentes.

query_cache_type ON ou OFF ?

Sur les Hébergements Web mutualisés (donc hors Serveur Cloud) MySQL Query Cache n'est ni activé ni activable.

Sur Serveur Cloud, activez MySQL Query Cache par Fast Installer.

Ce guide explique comment synchroniser les contacts & calendriers Microsoft Outlook* Windows (uniquement les versions Office 365, 2024, 2021, 2019, 2016, 2013, 2010, 2007) avec les contacts & calendriers hébergés chez Infomaniak, à l'aide d'une extension pour Outlook disponible sur caldavsynchronizer.org.

Préambule

• Il existe une alternative payante pour Windows, Evo Collaborator, qui propose un profil préconfiguré pour Infomaniak.

Configurer Outlook CalDav Synchronizer

Outlook CalDav Synchronizer permet de synchroniser contacts & calendriers via protocoles CalDAV et CardDAV y compris des calendriers multiples (non partagés uniquement):

1. Téléchargez CalDav Synchronizer pour Outlook.
2. Fermez Outlook et lancez l'installation du plugin téléchargé ci-dessus:
   
3. Une fois le plugin installé, ouvrez Outlook et cliquez sur le nouvel onglet CalDav Synchronizer.
4. Cliquez sur Synchronisation Profiles.
5. Cliquez sur l'icône ＋ afin de créer un premier profil (pour le calendrier ou les contacts - il faudra créer un second profil par la suite pour synchroniser les deux):
   
6. Choisissez un type de profil générique (premier bouton radio).
7. Cliquez sur le bouton OK:
   
8. Entrez un nom de profil (nom du calendrier ou carnet d'adresses Infomaniak que vous souhaitez synchroniser par exemple).
9. Cochez la case de synchronisation.
10. Cliquez sur le bouton [ ▪ ▪ ▪ ] :
    
11. Cliquez sur le bouton Nouveau…:
    
12. Entrez un nom de nouveau dossier.
13. Choisissez le type d'éléments que contiendra le dossier (Calendrier ou Contacts).
14. Cliquez sur le dossier parent pour créer le dossier dans son arborescence.
15. Validez avec le bouton OK:
    
16. Sélectionnez dans la liste le dossier nouvellement créé.
17. Validez avec OK:
    
18. Ouvrez l'assistant https://config.infomaniak.com/ pour obtenir les informations concernant la synchronisation avec Outlook.
19. Cliquez sur le bouton pour générer un mot de passe d'application (permet de contourner la 2FA de votre compte utilisateur pour la synchronisation uniquement).
20. Copiez les informations (mot de passe, URL et nom d'utilisateur) obtenues sur config.infomaniak.com.
21. Entrez l'adresse mail, celle de votre compte Infomaniak.
22. Cliquez sur le bouton pour Tester les paramètres:
    
23. Choisissez sur la fenêtre qui s'ouvre le calendrier Infomaniak à synchroniser.
24. Cliquez sur le bouton OK:
    
25. Des informations supplémentaires pourront alors apparaitre automatiquement dans certains champs.
26. Enregistrez un second profil si nécessaire (recommencez au point 5 dans ce cas).
27. Terminez avec OK en bas à droite:
    
28. Un redémarrage d'Outlook peut être requis pour mettre à jour les informations ajoutées, qui seront alors visibles sur l'interface:
    

Résoudre des duplicatas d'évènements

Si vous constatez des évènements dupliqués dans votre calendrier Outlook sans que ceux-ci ne le soient sur ksuite.infomaniak.com/calendar, appliquez ces réglages:

1. Cliquez pour Afficher les Réglages Avancés.
2. Cliquez sur Event Mapping Configuration.
3. Cochez la case Use GlobalAppointmentID for UID attribute.
4. Cochez la case Cleanup duplicate events.
5. Sauvegardez les modifications en cliquant sur le bouton OK:
   

Cette suppression d'évènements à double et donc potentiellement de duplicata d'invitations, peut entraîner une notification de refus de l'évènement auprès de l'organisateur, cependant cela n'a pas d'impact sur le choix initial du participant.

Pour utilisateurs macOS avertis

Il existe une alternative pour Outlook / Exchange sur macOS, via le script python ews-caldav-sync:

• Contrairement à un import de fichier ICS fourni par Outlook Web qui ne comprend que les dernières semaines d'évènements, le script va importer tous les évènements du calendrier, y compris les séries d'évènements, sans les tâches.
• La synchronisation par ce script est uniquement dans un sens, de Microsoft Exchange vers le serveur CalDAV. Il est recommandé de le relancer à intervalles réguliers.

Ce guide concerne la redirection du trafic Web vers un port spécifique, y compris en cas d'utilisation d'une IP dédiée et d'une application Web spécifique (comme Node ou Varnish par exemple).

Prérequis

• Ajouter un site sur votre hébergement.
• Installer HAProxy sur le Serveur Cloud.

Rediriger le trafic Web vers un port spécifique

Par défaut, sur Serveur Cloud, le trafic Web est envoyé à Apache. Pour envoyer les requêtes vers un script Node ou un autre service (pour autant qu'il "écoute" sur un port entre 4000 et 4009), il faut passer par HAProxy.

Cela s'applique notamment pour les serveurs Express, Socket.IO, Meteor.js, Nuxt.js, Flask, Ruby on Rails, même éventuellement Java (J2E), etc. 

Pour ça, il faut vous assurer que le service écoute bien sur un port entre 4000 et 4009 (notamment avec server.listen(4000) pour Express ou un serveur HTTP Node basique, mais selon le type de projet par d'autres moyens, un fichier de configuration, dans le code ou autre) et sur toutes les interfaces (0.0.0.0).

Il sera également nécessaire de configurer HAProxy comme dans l'exemple ci-après : 

1. Cliquez ici afin d'accéder à la gestion de votre Serveur Cloud sur le Manager Infomaniak (besoin d'aide ?).
2. Cliquez directement sur le nom attribué au Serveur Cloud concerné.
3. Cliquez sur Fast installer dans le menu latéral gauche.
4. Cliquez sur le menu d'action ⋮ situé à droite de HAProxy.
5. Cliquez sur Configurer:
   
6. Choisissez les informations désirées et sauvegardez:
   

Cas particulier des alias et wildcards

La configuration de HAProxy via le Fast Installer s'applique exclusivement au domaine principal de l'hébergement.

Actuellement, les alias de domaines (qu'ils soient spécifiques ou de type wildcard comme *.domain.xyz) ne sont pas pris en charge nativement par cet outil.

Pour rediriger le trafic d'un alias vers votre application (écoutant par exemple sur le port 4000), vous devez configurer manuellement une règle de type "proxy" dans le fichier .htaccess situé à la racine de votre site :

# Redirect all traffic to the application (e.g., Node.js on port 4000)
RewriteEngine On
RewriteRule ^(.*)$ http://localhost:4000/$1 [P,L]

Sans cette directive manuelle, toutes les requêtes correspondant à vos alias ou wildcards seront dirigées par défaut vers Apache au lieu de votre application spécifique.

Récupération de l'IP source d'une requête

Lorsque vous redirigez le trafic Web vers votre application Web, le traitement des requêtes change et la requête est d'abord reçue par un reverse proxy (local au serveur) qui transfère ensuite la requête vers le port choisi. Ainsi, à cause du transfert de la requête, les méthodes permettant habituellement de récupérer l'IP du visiteur vont donner l'IP du reverse proxy au lieu de celle du visiteur.

Ainsi, pour récupérer l'IP source réelle du visiteur dans ces cas, il faut consulter un header HTTP nommé X-Forwarded-For, qui contiendra les IPs source accumulées lors de chaque redirection. Ce header contiendra donc en dernier l'adresse IP originale du client, permettant d'identifier le visiteur réel.

Attention : il est important de noter que les headers HTTP peuvent être manipulés, ce qui présente des risques de sécurité. Pour minimiser ces risques, il est recommandé de vérifier que la requête provient bien d'un serveur fiable avant de faire confiance au contenu du header X-Forwarded-For. Cette vérification peut impliquer de s'assurer que la requête a été transmise par un serveur intermédiaire de confiance, identifié par une liste préétablie d'adresses IP. Dans le cas où le site utilise une IP dédiée, les serveurs de confiance sont :

• 83.166.133.15
• 83.166.133.17
• 83.166.133.16
• 84.16.92.5
• 84.16.92.43
• 10.2.32.255
• 10.2.34.164

Ce guide explique comment mettre à jour un certificat SSL Let's Encrypt pour un site hébergé par Infomaniak.

Préambule

• Il peut être nécessaire suite à l'ajout ou suppression d'alias à un site de regénérer un certificat afin d'inclure les nouveaux noms de domaines liés au site.
• Le tableau de bord vous indiquera clairement qu'un des domaines liés au site n'est pas englobé dans le certificat SSL en place:
  

Mettre à jour un certificat Let's Encrypt

Pour accéder à la gestion des certificats :

1. Cliquez ici afin d'accéder à la gestion de votre produit sur le Manager Infomaniak (❓: aide).
2. Cliquez directement sur le nom attribué au produit concerné:
   
3. Cliquez sur le menu d'action ⋮.
4. Cliquez sur Mettre à jour le certificat:
   
5. Vérifiez ou sélectionnez les domaines concernés.
6. Cliquez sur le bouton Installer:
    

Ce guide détaille comment sauvegarder les fichiers et répertoires de votre choix à l'aide de l'application Duplicati via le protocole OpenStack Swift sur Swiss Backup la solution de sauvegarde dans un cloud suisse indépendant.

Installer le logiciel Duplicati

Pour cela:

1. Rendez-vous sur le site de Duplicati : https://www.duplicati.com/
2. Cliquez sur le bouton "Download Duplicati".
3. Choisissez la version correspondant à votre système d'exploitation ou votre distribution Linux.
4. Lancez l'installation du programme, vous pouvez conserver les choix par défaut.

Configurer le logiciel Duplicati

Prérequis

• Posséder un espace Swiss Backup Infomaniak avec un quota d'appareil disponible (minimum 1) pour une sauvegarde Cloud.
• Ajouter 1 appareil de type Cloud pour obtenir les paramètres OpenStack Swift.

Ensuite:

1. Après l'installation, une page Web a dû s'ouvrir ; si ce n'est pas le cas rendez-vous sur http://localhost:8200.
2. Cliquez sur Ajouter Sauvegarde puis sélectionnez Configurer une nouvelle sauvegarde.
3. Donnez un nom et éventuellement une description à votre plan de sauvegarde.
   • Activez ou non le chiffrement et créer une phrase de chiffrement si besoin.
4. Dans Type de Stockage sélectionnez Openstack Object Storage / Swift.
   • Remplacez SBI-XXXXXXXX et "passwd" selon les informations propres à votre appareil (prenez connaissance de cet autre guide):
     Nom du Bucket: default
     OpenStack AuthURi: https://swiss-backupXX.infomaniak.com/identity/v3 (XX = vérifiez votre compte Manager Swiss Backup et remplacez l'URL exacte)
     Version de l'API Keystone: V3
     Nom de domaine: default
     Nom d'utilisateur: SBI-XXXXXXXX
     Mot de passe: votre mot de passe
     Nom d'identité: sb_project_SBI-XXXXXXXXXX
     Clé API: laissez vide
     Région du conteneur: laissez vide
   • Cliquez sur Tester la connexion et vérifiez que vos identifiants sont corrects puis cliquez sur Suivant.
5. Sélectionnez les dossiers à sauvegarder et cliquez sur Suivant.
6. Définissez vos préférences de sauvegarde.
7. Il est recommandé de laisser l'option Taille du volume distant à sa valeur par défaut.
8. Choisissez votre préférence concernant la rétention des données.
   • L'option Rétention de sauvegarde intelligente est recommandée - sera alors conservée une sauvegarde pour chacun des 7 derniers jours, chacune des 4 dernières semaines, chacun des 12 derniers mois.
9. Cliquez sur Enregistrer.
   • Vous serez ramené à la page d'accueil ; vous pouvez lancer une sauvegarde immédiatement en cliquant sur Démarrer maintenant à côté du nom de votre sauvegarde ou attendre la prochaine sauvegarde programmée.

Restaurer un appareil avec Duplicati

Pour cela:

1. Ouvrez un navigateur comme Brave, Chrome, Edge, Firefox, Opera, Safari… et rendez-vous sur http://localhost:8200.
2. Cliquez sur le menu "Restaurer" à gauche.
   • Si Duplicati n'est pas configuré pour accéder à votre espace de sauvegarde Swiss Backup, voir ci-dessus.
3. Choisissez l'emplacement depuis lequel vous souhaitez restaurer des données.
4. Choisissez la date des données à restaurer dans le menu déroulant Restaurer depuis …
   1. Vous pouvez également vous servir du champ de recherche si vous voulez restaurer un fichier/dossier bien précis.
   2. Sélectionnez vos données à restaurer dans l'arborescence.
5. Choisissez l'emplacement de la restauration des données:
   1. Emplacement d'origine restaure les données la où elle étaient durant la sauvegarde.
   2. Choisir emplacement vous permet de restaurer des données dans un autre dossier que celui d'origine.
6. Choisissez si vous souhaitez conserver ou non les fichiers qui existent déjà sur votre machine en cas de conflit ou renommer les fichier avec leur dernière date de modification.
7. Cliquez sur Restaurer et attendre la fin du processus.

Résoudre une erreur 502 bad gateway ou 401 unauth

Avec Windows 10, les connexions au serveur Swift Infomaniak s'effectue avec TLS1.2 alors qu'avec Windows 11, cela se fait en TLS1.3 ce qui génère des erreurs. Si on restreint le choix à TLS 1.2, alors tout se passe bien.

Pour cela:

• Ajoutez l'option avancée des versions SSL autorisées :
  
• et sélectionnez Tls 1 2 :
  

Ce guide détaille l'utilisation du script FormMail sur les différentes offres d'hébergement Infomaniak.

‍Préambule

• FormMail‍ est un script CGI gratuit qui capture et traite le contenu d'un formulaire pour l'envoyer aux utilisateurs spécifiés.
• Supporté sur Hébergement mutualisé & Serveur Cloud.

Utiliser FormMail

Vous pouvez installer librement FormMail sur un hébergement afin d'envoyer des formulaires de votre site aux destinataires de votre choix:

1. Téléchargez la version remaniée (compat) du script original de Matt Wright's FormMail.
2. Placez le fichier Perl FormMail.pl dans un sous-dossier nommé cgi-bin.
3. Donnez-lui la permission exécution pour l'utilisateur:

   • chmod u+x FormMail.pl

4. Éditez le fichier FormMail.pl pour y indiquer les destinataires.

Le fichier EXAMPLE contient un exemple de formulaire que vous pourrez adapter selon vos besoins.

Ce guide explique comment réinitialiser un VPS Cloud / VPS Lite.

Préambule

• Cette procédure efface tout le contenu du volume dédié au système d'exploitation (/dev/vda).
• Dans le cas d'un VPS Cloud, le volume dédié au stockage des données (/dev/vdb) n'est pas impacté par la réinitialisation.
   

Reset de l'OS VPS Cloud / VPS Lite

Pour accéder au VPS :

1. Cliquez ici afin d'accéder à la gestion de votre VPS sur le Manager Infomaniak (besoin d'aide ?).
2. Cliquez directement sur le nom attribué au VPS concerné.
3. Cliquez sur le bouton Réinitialiser.
4. Suivez les instructions affichées pour terminer la réinitialisation.

Ce guide explique comment migrer d'un VPS Lite à un VPS Cloud en conservant toutes ses données et sans ne devoir rien reconfigurer de son installation.

Préambule

• L'adresse IP du serveur est conservée, ainsi que toutes les données du disque.
• Il n'est pas possible d'annuler ce changement ou de revenir en arrière.
• Passer d'un VPS Cloud à un VPS Lite n'est pas possible.

Effectuer une migration de VPS Lite à VPS Cloud

Pour démarrer l'opération, accédez au VPS Lite :

1. Cliquez ici afin d'accéder à la gestion de votre VPS sur le Manager Infomaniak (besoin d'aide ?).
2. Cliquez directement sur le nom attribué au VPS concerné:
   
3. Cliquez sur Faire évoluer mon offre:
   
4. Cliquez sur le bouton Mettre à niveau sur la modale qui s'affiche.
5. Terminez la commande pour faire évoluer votre VPS Lite.
6. Patientez pendant la migration, une interruption de service sera ressentie pendant le processus.

Ce guide explique comment modifier l'espace disque d'un hébergement sur Serveur Cloud.

Préambule

• Les bases de données sont installées sur le même serveur Cloud donc l'espace disque pour les bases de données n'est pas limité à la taille de l'hébergement mais à l'espace disque total du Serveur Cloud.
  • Pour modifier cet espace disque total, il est nécessaire de modifier la configuration du Serveur Cloud.

Modifier l'espace disque d'un hébergement Web

Pour accéder à l'hébergement sur Serveur Cloud :

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 menu d'action ⋮ situé à droite de l'hébergement Web concerné, dans la partie Hébergements Web.
4. Cliquez sur Modifier l'espace disque de l'hébergement:
   
5. Ajustez la taille en fonction de l'espace disque alloué et encore disponible.
6. Cliquez sur le bouton Confirmer pour valider la modification.

Ce guide détaille comment restaurer un ordinateur Apple macOS à l'aide d'Acronis sur Swiss Backup la solution de sauvegarde dans un cloud suisse indépendant.

Prérequis

• L'application Acronis doit être installée sur l'ordinateur sur lequel vous souhaitez effectuer la restauration ; utiliser les mêmes identifiants que ceux utilisés pour sauvegarder la machine lors de l'enregistrement de l'agent :
  1. Cliquez ici afin d'accéder à la Console Acronis avec les identifiants obtenus suite à l'ajout de l'appareil (besoin d'aide ?).
  2. Cliquez sur l'icône utilisateur tout en haut à droite.
  3. Cliquez sur Téléchargements:
     
  4. Choisissez le client adapté à votre machine macOS:
     

Créer une clé USB de démarrage

Pour cela:

1. Insérez une clé USB vierge d'au moins 4 Go dans votre ordinateur (attention : les données contenues sur la clé seront supprimées).
2. Ouvrez l'application Rescue Media Builder depuis le dossier Applications du Finder de votre macOS. Cette application a automatiquement été installée avec l'application Acronis.
3. Cochez la clé USB détectée et cliquez sur Create Media.

Lancer la procédure de restauration

Pour cela:

1. Redémarrez l'ordinateur macOS avec la clé USB de démarrage.
2. Selon la version macOS appuyez et maintenez une touche du clavier enfoncée (prenez connaissance de ce guide Apple pour savoir laquelle) lors du redémarrage.
3. Si nécessaire, cliquez sur la clé USB de démarrage pour démarrer dessus.

Configurer et lancer la restauration

Pour cela:

1. Sélectionnez votre clé sur Rescue Media Builder:
   
2. Cliquez sur Support de démarrage de secours:
   
3. Cliquez sur Recover:
   
4. Cliquez sur Sélectionner les données:
   
5. … puis sur Parcourir:
   
6. et sélectionnez Stockage sur le Cloud ; cliquez ensuite sur le bouton Log in:
   
7. Utilisez les identifiants de l'appareil pour vous authentifier :
8. Choisissez la machine macOS à restaurer puis cliquez sur OK pour lancer la restauration:
   
9. Si vous avez choisi de chiffrer vos sauvegardes, le mot de passe des sauvegarde vous sera demandé:
   
10. Dans la partie supérieure de l'écran, sélectionnez la sauvegarde disponible que vous souhaitez restaurer:
    
11. Une fois la sauvegarde sélectionnée, vous pourrez dans la partie inférieure de l'écran sélectionner le type d'élément à restaurer ainsi que ceux que vous souhaitez restaurer ; il est recommandé de sélectionner le type Volumes et de restaurer l'ensemble des Volumes disponibles, ceci afin de restaurer l'ensemble de votre/vos disques dur... puis lancez la restauration par le bouton OK:
    
12. La restauration est alors lancée, vous pouvez suivre l'avancement via l'onglet Progress: