Base de connaissances

Ce guide explique comment connecter les apps desktop Contacts et Calendar macOS (MacBook Pro, Neo…) avec les contacts & calendriers hébergés chez Infomaniak.

Préambule

• Votre ordinateur macOS sera automatiquement configuré par le biais de profils de configuration .mobileconfig compatibles Apple contrairement à une configuration manuelle.
• Les contacts & calendriers Infomaniak sont liés à votre compte Infomaniak ; quand vous vous connectez à ksuite.infomaniak.com/contacts ou /calendar vous avez sûrement la double validation (2FA) à effectuer lors de la connexion.
  • Dans ce cas, un mot de passe d'application est nécessaire pour établir une synchronisation entre votre appareil et les outils Infomaniak.
  • Mais pas de panique, la création d'un tel mot de passe vous est proposé en suivant l'assistant de configuration.

Installer un profil de configuration

Pour cela:

1. Cliquez ici afin d'accéder à l'outil de configuration Infomaniak (service en ligne https://config.infomaniak.com) — connectez-vous si nécessaire à votre compte Infomaniak sur l'Organisation sur laquelle sont gérés vos services à synchroniser.
2. Choisissez d'installer le profil sur cet appareil.
3. Choisissez de synchroniser les contacts & calendriers.
4. Générez un mot de passe d'application dédié à la synchronisation (afin de conserver la connexion 2FA habituelle de votre compte utilisateur):
   
5. Copiez le mot de passe d'application généré (il vous sera demandé lors de l'installation du profil Apple).
6. Téléchargez le profil Apple:
   
7. Ouvrez ce fichier nouvellement téléchargé sur votre disque dur.
8. Cliquez sur OK dans la fenêtre de confirmation:
   
9. Ouvrez les Paramètres système de l'ordinateur.
10. En principe le nouveau profil est signalé comme tel et il faut cliquer sur cet élément de menu…
    • sinon cliquez sur Général dans la barre latérale
    • puis cliquez sur Gestion de l'appareil (pour la version macOS Sequoia 15)
    • si vous avez une version inférieure ou que vous ne trouvez pas le profil, prenez connaissance de la documentation officielle en changeant en haut de page* la version de votre système si nécessaire…
11. Double-cliquez sur le profil proposé:
    
12. Cliquez sur Installer:
    
13. Entrez le mot de passe d'application relevé au point 5 ci-dessus, ceci afin de se connecter aux Calendriers.
14. Cliquez sur Suivant:
    
15. Entrez le mot de passe une seconde fois (pour les Contacts cette fois-ci) et cliquez sur Installer pour terminer.
16. Ca y est, vous pouvez ouvrir vos applications macOS Contacts et Calendrier.

Si vos applications étaient déjà ouvertes, il faut les relancer. Vous verrez alors les informations ajoutées par la synchronisation:

Particularités de la synchronisation

Prenez connaissance de cet autre guide.

Supprimer un profil Apple

Prenez connaissance de la documentation officielle en changeant en haut de page* la version de votre système si nécessaire:

*Pourquoi est-il nécessaire de choisir la version du guide correspondante exactement à votre version du système macOS / iOS ? Apple introduit des changements parfois subtils à chaque nouvelle version de son système, par exemple un chemin sur iOS 15…

… devient ceci sur iOS 18…

Ce guide donne des indications pour renforcer la sécurité d'un NAS Synology.

Nécessité de sécuriser votre Synology

Les NAS Synology rencontrent beaucoup de succès et subissent dès lors de nombreuses tentatives de piratage. Il est donc important de bien configurer votre Synology et de le protéger par un mot de passe fort sinon il pourrait être vulnérable face aux analyses automatiques qui recherchent et détectent tous les Synology connectés dans le monde qui présentent des vulnérabilités faciles à instrumentaliser.

Quelques bonnes pratiques à appliquer pour renforcer la sécurité de votre Synology:

• Mettre systématiquement à jour le système d'exploitation du Synology (le DSM).
• Ouvrir l'application Conseiller en Sécurité et faire un scan pour détecter les problèmes de sécurité ; appliquer toutes les recommandations proposées.
• Changer le port par défaut qui est réglé sur 5000 (par exemple 26753 ou 38000).
• Activer et configurer le pare-feu.
• Désactiver les services et modules qui ne sont pas utilisés et qui ne sont pas nécessaires pour votre usage.
• Dans la mesure du possible, ne pas utiliser MyDS.
• Appliquer ces recommandations Synology.

En savoir plus: https://news.infomaniak.com/securiser-acces-synology/

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

Prérequis

• Posséder une sauvegarde de l'ordinateur sur Swiss Backup (prendre connaissance de cet autre guide).
• Prendre connaissance de la documentation d'Acronis au sujet de la restauration de machines physique.
• L'ordinateur à restaurer doit être connecté à Internet par câble Ethernet (ou Wifi selon capacité de l'ordinateur).

Restaurer la sauvegarde

Pour commencer, depuis l'ordinateur concerné ou n'importe quelle autre machine:

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 Appareils dans le menu latéral gauche
3. Cliquez sur le bouton Restaurer sur votre plan de sauvegarde concerné
4. Cliquez sur les autres façons de restaurer en haut de l'interface:
   

Naviguer parmi les fichiers sauvegardés

Si nécessaire, localement ou à distance, vous pouvez dans un premier temps simplement restaurer les fichiers dont vous auriez besoin:

1. Cliquez sur le bouton Télécharger des fichiers (dans la partie Parcourez le stockage Cloud).
2. Ouvrez la sauvegarde concernée.
3. Entrez le mot de passe de chiffrement si nécessaire.
4. Parcourez l'arborescence, sélectionnez vos fichiers:
   
5. Cliquez sur Télécharger afin d'obtenir un .zip contenant vos fichiers sélectionnés.

Prenez également connaissance de cet autre guide.

Créer un disque de démarrage (sur clé USB par exemple)

Afin de créer un disque de démarrage Windows et permettre la restauration d'un ordinateur:

1. Cliquez sur le bouton Télécharger une image ISO (dans la partie Restaurer une machine entière):
   
2. Notez en lieu sûr le code de la forme AA11-BB22-CC33 qui apparait à l'écran (plus d'informations).
3. Utilisez un logiciel comme Etcher pour créer un disque de démarrage à partir du fichier .iso téléchargé.

Démarrer l'ordinateur sur le média amovible

Démarrez l'ordinateur sur ce disque de démarrage (en appuyant sur la touche requise selon votre machine: F1, F2, F10, F12, DEL, etc.) puis suivez les étapes suivantes:

1. Cliquez sur Rescue Media:
   
2. Branchez l'ordinateur par Ethernet (ou si nécessaire configurer le Wifi depuis le lien situé sur la droite de l'interface si l'ordinateut le permet) puis cliquer sur Gérer l'appareil localement:
   
3. Cliquez sur Restaurer:
   
4. Cliquez sur Sélectionner les données...
   
5. Cliquez sur le bouton Parcourir:
   
6. Sous Cloud Storage cliquez à choix sur :
   1. Log In et utilisez les identifiants Acronis (de la forme SBA-XXXX-ADMIN) pour s'authentifier (le clavier est par défaut en EN-US, assurez-vous de taper le mot en clair pour le vérifier si nécessaire):
      
   2. OU Utiliser le code d'enregistrement si vous avez la 2FA activée, en suivant la procédure proposée (qui consiste à réclamer un code provisoire (de la forme ABCD-ABCD) puis à se rendre à la page https://acronis.infomaniak.com/ui/#w=agentRegistration afin d'entrer ce code une fois connecté à votre compte Acronis):
      
7. Cliquez ensuite sur votre identifiant de compte Acronis et continuez pour accéder aux sauvegardes (le mot de passe de chiffrement sera demandé si celui-ci avait été activé - cf point 12 de ce guide).
8. Choisissez le poste, le point de restauration et les volumes (disques) à restaurer:
   
   Informations utiles :
   • Utilisez la flèche à gauche du nom des postes pour afficher les sauvegardes…
   • Le premier tableau en haut permet de choisir le poste et la sauvegarde à restaurer…
   • Le deuxième tableau permet de choisir le contenu (les disques) de la sauvegarde à restaurer…
9. Cliquez sur OK pour continuer.
10. Faites la correspondance entre les volumes d'origine et de destination:
    
    Informations utiles :
    • Pour chaque volume ou disque de la sauvegarde source, cliquez sur Requis pour choisir où restaurer les données.
    • Sous Options de restauration, il est recommandé de cocher la case Redémarrage automatique.
11. Cliquez sur OK pour lancer la restauration.

Ce guide permet de résoudre un problème sur le CMS Prestashop v9.x concernant la génération de factures PDF depuis le panneau d'administration (Back Office), particulièrement lorsque la langue française est utilisée.

Le problème

Lors de la tentative de visualisation ou de téléchargement d'une facture PDF pour une commande en langue française, PrestaShop (en version 9.x) retourne une Erreur 500. Ce dysfonctionnement est lié à une incompatibilité entre la librairie de génération de PDF (TCPDF) utilisant la police par défaut (helvetica) et les configurations d'hébergement.

Définir une police compatible

La solution consiste à forcer l'utilisation de la police freesans, plus compatible, via un fichier de configuration personnalisé.

Pour cela:

1. Accédez à votre installation PrestaShop 9.x via FTP ou le Gestionnaire de fichiers.
2. Naviguez jusqu'au répertoire /config/.
3. Créez un nouveau fichier nommé defines_custom.inc.php.

4. Éditez le fichier defines_custom.inc.php et ajoutez le contenu suivant:

   <?php
   /**
    * Avoid error PDF, force font 'freesans'.
    */
   define('PDF_FONT_NAME_MAIN', 'freesans');

5. Enregistrez le fichier et testez la génération d'une facture en français.

Ce guide explique comment utiliser PHPMailer avec les hébergements Web Infomaniak pour envoyer des e-mails depuis un site Internet.

⚠ ATTENTION ⚠‍ 

Infomaniak garantit la conformité de ses services aux protocoles standards (IMAP, S3, etc.) mais ne fournit pas d'aide supplémentaire pour les services ou logiciels externes, car leur configuration peut changer selon le fournisseur ou l'éditeur. Ce guide est donc fourni à titre indicatif et sa mise en place reste sous votre responsabilité (réf.: Politique de support / Art. 11.9 des CGU). Si besoin, une personne qualifiée peut vous accompagner. 

Préambule

• PHPMailer est une librairie PHP permettant de créer et d'envoyer des e-mails depuis un site, notamment via SMTP.
• Elle permet notamment d'envoyer des messages au format HTML, d'ajouter une version texte alternative, de gérer les pièces jointes et d'utiliser une authentification SMTP.
• Pour un envoi authentifié via SMTP, l'environnement PHP utilisé par le site doit être compatible avec une connexion chiffrée récente, notamment TLS 1.2 ou supérieur.
  • Une version trop ancienne de PHP ou de la librairie OpenSSL utilisée par PHP peut provoquer une erreur de connexion ou d'authentification, même si l'adresse mail et le mot de passe sont corrects.
  • N'utilisez pas PHP 5.3/5.4 pour ce type d'envoi ; utilisez une version de PHP récente et maintenue.
• Avec l'envoi SMTP authentifié, l'adresse utilisée comme expéditeur doit correspondre à l'adresse mail utilisée pour l'authentification SMTP.

Installer PHPMailer

Pour utiliser PHPMailer, installez la librairie dans les fichiers de votre site.

1. Téléchargez PHPMailer depuis son dépôt officiel ou installez-la avec Composer si votre projet l'utilise.
2. Copiez les fichiers de PHPMailer dans un répertoire de votre site par FTP.

3. Chargez les fichiers nécessaires dans votre script PHP, en adaptant le chemin selon l'emplacement choisi:

   use PHPMailer\PHPMailer\PHPMailer;
   use PHPMailer\PHPMailer\Exception;
   
   require **DIR** . '/PHPMailer/src/Exception.php';
   require **DIR** . '/PHPMailer/src/PHPMailer.php';
   require **DIR** . '/PHPMailer/src/SMTP.php';

Configurer l'envoi SMTP avec Infomaniak

Utilisez les paramètres SMTP authentifiés suivants:

• Serveur SMTP: mail.infomaniak.com
• Port: 465
• Chiffrement: SMTPS / SSL-TLS
• Authentification: obligatoire
• Nom d'utilisateur: l'adresse mail complète
• Mot de passe: le mot de passe de l'adresse mail utilisée

Exemple de configuration complète:

<?php

use PHPMailer\PHPMailer\PHPMailer;
use PHPMailer\PHPMailer\Exception;

require **DIR** . '/PHPMailer/src/Exception.php';
require **DIR** . '/PHPMailer/src/PHPMailer.php';
require **DIR** . '/PHPMailer/src/SMTP.php';

$mail = new PHPMailer(true);

try {
// Configuration SMTP
$mail->isSMTP();
$mail->Host       = 'mail.infomaniak.com';
$mail->SMTPAuth   = true;
$mail->Username   = '[sender@domain.xyz](mailto:sender@domain.xyz)';
$mail->Password   = 'mot_de_passe_de_l_adresse_mail';
$mail->SMTPSecure = PHPMailer::ENCRYPTION_SMTPS;
$mail->Port       = 465;
$mail->CharSet    = 'UTF-8';

```
// Expéditeur
// L'adresse doit correspondre à celle utilisée pour l'authentification SMTP.
$mail->setFrom('sender@domain.xyz', 'Nom du site');

// Destinataire
$mail->addAddress('recipient@example.com');

// Adresse de réponse facultative
$mail->addReplyTo('sender@domain.xyz', 'Nom du site');

// Contenu du message
$mail->isHTML(true);
$mail->Subject = 'Message envoyé depuis le site';
$mail->Body    = '<p>Contenu HTML du message.</p>';
$mail->AltBody = 'Contenu texte du message.';

$mail->send();
echo 'Message envoyé';
```

} catch (Exception $e) {
echo 'Le message n'a pas pu être envoyé. Erreur: ' . htmlspecialchars($mail->ErrorInfo);
}

Si votre application impose l'utilisation du port 587, utilisez STARTTLS:

$mail->SMTPSecure = PHPMailer::ENCRYPTION_STARTTLS;
$mail->Port       = 587;

Vérifier la version de PHP et la compatibilité TLS

L'envoi SMTP authentifié nécessite une connexion chiffrée récente. Si le site utilise une version trop ancienne de PHP, par exemple PHP 5.3, ou une librairie OpenSSL trop ancienne, PHPMailer peut échouer avant ou pendant l'authentification. Les erreurs peuvent alors être trompeuses, par exemple:

• SMTP connect() failed
• Could not authenticate
• stream_socket_enable_crypto()
• une erreur d'authentification alors que le mot de passe est correct

Dans ce cas, vérifiez les points suivants:

1. la version de PHP utilisée par le site;
2. la version d'OpenSSL utilisée par PHP;
3. la version de PHPMailer utilisée par votre projet;
4. la correspondance entre le port SMTP et le chiffrement choisi.

Pour une configuration fiable, utilisez une version récente de PHP, compatible avec TLS 1.2 ou supérieur, ainsi qu'une version actuelle de PHPMailer. Prenez connaissance de ces guides si nécessaire:

• Modifier la version de PHP d'un site
• Résoudre un problème PHP lié à une version obsolète
• Afficher les informations techniques du site

Résoudre une erreur Sender mismatch

L'erreur Sender mismatch SMTP code: 550 Additional SMTP info: 5.7.1 peut se produire lorsque l'adresse utilisée comme expéditeur ne correspond pas à l'adresse mail utilisée pour l'authentification SMTP. Exemple à éviter:

$mail->Username = 'sender@domain.xyz';
$mail->setFrom('another-address@domain.xyz', 'Nom du site');

Dans cet exemple, le script s'authentifie avec sender@domain.xyz, mais tente d'envoyer le message avec une autre adresse d'expéditeur.

Utilisez la même adresse mail pour l'authentification SMTP et pour l'expéditeur:

$mail->Username = 'sender@domain.xyz';
$mail->setFrom('sender@domain.xyz', 'Nom du site');

Le nom d'expéditeur peut être personnalisé, mais l'adresse mail doit rester cohérente avec le compte SMTP utilisé.

Cas d'un formulaire de contact

Si un visiteur renseigne son adresse mail dans un formulaire, ne l'utilisez pas comme adresse d'expéditeur du message. Utilisez l'adresse mail authentifiée comme expéditeur, puis ajoutez l'adresse du visiteur comme adresse de réponse.

Exemple:

$mail->Username = 'sender@domain.xyz';
$mail->setFrom('sender@domain.xyz', 'Formulaire du site');
$mail->addReplyTo($email_visiteur);

Cette configuration permet de répondre au visiteur depuis votre logiciel de messagerie sans envoyer le message avec une adresse d'expéditeur non autorisée.

Activer le mode debug temporairement

En cas d'erreur, activez temporairement le mode debug de PHPMailer afin d'obtenir plus de détails sur la connexion SMTP:

$mail->SMTPDebug = 2;
$mail->Debugoutput = 'html';

Désactivez ce mode après vos tests afin de ne pas afficher d'informations techniques aux visiteurs du site.

En savoir plus

• Mail authentifié (SMTP) depuis un site
• Mail non-authentifié via PHP mail()
• Documentation officielle PHPMailer

Ce guide concerne tous les utilisateurs souhaitant recommander les produits d'Infomaniak et gagner de l'argent sur chaque vente effectuée dans le cadre du programme d'affiliation d'Infomaniak. Chaque clic sur vos liens est une vente potentielle.

Générer rapidement des gains

Vous toucherez des commissions sur tous les produits (y compris les Serveurs Cloud et outil de Newsletter) à l'exception des noms de domaine, du Housing et de l'hébergement très haute disponibilité. Vos revenus seront plus importants sur les produits haut de gamme !

Quelques conseils et idées

Ajoutez votre lien d'affilié…

• … dans la signature de vos mails
• … lorsque vous répondez à des questions dans des groupes Facebook ou des forums
• … dans vos différents profils en ligne
• … dans vos Newsletters / mailings

Suivez des discussions Discord, Facebook, etc. ou des forums qui rassemblent des personnes intéressées par…

• … WordPress
• … plus généralement la création de sites Internet
• … l'hébergement de données

car les membres y demandent souvent des conseils pour choisir un prestataire et il est alors facile de recommander Infomaniak sur la base de votre expérience.

Testez gratuitement un hébergement Web + Service Mail et rédigez un article de test sur votre blog, Medium, Facebook, etc.

Faites une vidéo sur YouTube ou d'autres supports afin de mettre en avant les points forts des produits (thèmes WordPress Elegant Themes gratuits, 120 applications Web en 1 clic, hébergement 100% SSD, etc.) - ces points sont tous présentés sur les différentes pages de vente Infomaniak.

Ce guide vous explique comment créer une nouvelle billetterie, ou nouvelle période, dans le cadre du système de billetterie Infomaniak.

Préambule

• Vous pouvez créer plusieurs évènements dans une même billetterie:
  • Cette “période” correspond généralement à une édition, saison, ou un temps fort de votre programmation (saison 2025-2026, festival été 2026…).
  • C'est un simple cadre de regroupement ; elle n'isole pas techniquement les évènements comme le ferait une nouvelle billetterie.
• La création d'une nouvelle billetterie permet de structurer et d'organiser vos ventes de billets de façon indépendante:
  • Vous organisez des saisons récurrentes d'évènements (saisons culturelles, saisons sportives).
  • Vous gérez plusieurs clients distincts (cas des partenaires billetterie).
  • Vous souhaitez séparer vos ventes, vos réglages, ou vos statistiques d'une série d'évènements à une autre.
  • Vous avez besoin d'espaces de gestion distincts, avec des équipes ou des droits d'accès différents.
• Cette action ne doit pas être confondue avec la création d'une nouvelle Organisation Infomaniak.
• Prenez également connaissance de cet autre guide avant toute publication.

Ajouter l'outil Ticketing en ligne

Pour démarrer une nouvelle billetterie Infomaniak:

1. Cliquez ici afin d'accéder à la gestion de vos produits sur le Manager Infomaniak.
2. Cliquez sur Ticketing sous l'univers Events & Marketing.
3. Cliquez sur le bouton bleu Ajouter:
   
4. Indiquez le nom de la billetterie, les devises à utiliser ainsi que les langues à utiliser sur la billetterie.
5. Indiquez les coordonnées de l'utilisateur.
6. Choisissez l'apparence par défaut de la billetterie:
   

Ce guide permet de résoudre une erreur d'envoi d'e-mail de type "le destinataire a été refusé par le serveur" / "recipient rejected" (code : 550 5.7.1 relaying denied) ou "authentification requise" / "proper authentication required".

Résoudre une erreur Relaying denied

Vérifiez que le paramètre "Mon serveur requiert une authentification" / "My outgoing server (SMTP) requires authentication" a bien été activé dans les réglages de votre serveur sortant (SMTP) sur le logiciel de messagerie employé.

Vous trouverez généralement ce réglage sous l'une des rubriques suivantes :

• "Paramètres supplémentaires" / "More Settings"
• "Configuration avancée" / "Advanced Settings"
• "Serveur sortant SMTP" / "Outgoing Server (SMTP)"

Après avoir corrigé ce paramètre, il est important de supprimer ou déplacer les messages en attente dans votre boîte d'envoi, puis d'essayer d'envoyer un nouveau message.

Utiliser config.infomaniak.com

Vous pouvez utiliser l'outil de configuration Infomaniak pour vous aider (connectez-vous à votre compte Infomaniak si nécessaire).

Prenez également connaissance de cet autre guide de résolution d'erreurs.

Ce guide concerne le module Apache mod_auth_mysql qui permet l'authentification des utilisateurs et l'autorisation d'accès via une base de données MySQL.

Avec un hébergement mutualisé

Le module mod_auth_mysql n'est pas disponible avec les hébergements mutualisés ; il faut envisager un Serveur Cloud ou utiliser scripts PHP et sessions.

Ce guide vous aide à résoudre les erreurs de connexion sur les applications mobiles Infomaniak (kDrive, Mail, Euria, SwissTransfer, etc.) lorsque le message de sécurité «Votre appareil n'est pas reconnu comme sûr» s'affiche sur votre appareil.

Pourquoi ce message s'affiche-t-il ?

Ce blocage repose sur les protocoles de sécurité officiels des systèmes d'exploitation (tels que la Google Play Integrity API sur Android). Infomaniak utilise ces standards pour garantir que vos données ne sont pas consultées sur un appareil dont l'intégrité ou la sécurité pourrait être compromise.

Cette situation survient généralement dans les cas suivants :

• Utilisation d'un système d'exploitation non officiel (Custom ROM / LineageOS).
• Appareil "rooté" ou dont le bootloader est déverrouillé.
• Version du système d'exploitation obsolète ou non certifiée par l'éditeur.
• Appareils dépourvus des services officiels (ex : smartphones Huawei sans les services Google).

Solution de contournement immédiate

Si votre appareil est sain mais que le message persiste, vous pouvez forcer une nouvelle authentification pour contourner le blocage :

1. Sur l'écran de connexion de l'application concernée, touchez l'icône flèche / chevron vers le bas située à côté de votre compte ou de votre avatar.
2. Sélectionnez l'option « Se connecter avec un autre compte » (même s'il s'agit du même compte).
3. Saisissez manuellement vos identifiants (adresse mail Infomaniak et mot de passe).

Cette manipulation permet d'ignorer l'ancien jeton de session et de valider l'accès via une authentification sécurisée actualisée.

Ce guide est conçu pour vous aider à alléger et optimiser vos bases de données chez Infomaniak.

Préambule

• Le nombre et la taille des bases de données sont illimités.
• Toutefois, il est crucial d'optimiser vos tables (via des index) pour éviter de surcharger le serveur et garantir un affichage rapide de votre site, surtout lorsque le volume de données augmente.

Optimiser les requêtes

Les index sont essentiels pour les performances : ils fonctionnent comme le sommaire d'un livre, permettant à MySQL/MariaDB de trouver une information sans lire toutes les pages. Sans index, le serveur doit effectuer un "scan complet" de la table, ce qui est très gourmand en ressources.

Un index est particulièrement efficace sur les colonnes utilisées pour filtrer les résultats (clause WHERE), pour effectuer des jointures entre tables (JOIN) ou pour trier les données (ORDER BY).

Analyser avec EXPLAIN

Avant d'ajouter un index, il faut identifier la requête lente. La commande EXPLAIN (disponible aussi via l'interface de phpMyAdmin) permet de simuler la requête.

Observez la colonne "rows" (nombre de lignes analysées) et la colonne "key" (clé utilisée). Si "rows" est élevé et que "key" est vide (NULL), il est fortement recommandé de créer un index.

Ajouter des index

Pour ajouter un index, vous pouvez utiliser l'onglet "Structure" de phpMyAdmin ou la commande SQL suivante :

ALTER TABLE nom_de_table ADD INDEX nom_index (colonne_cible);

Note : N'indexez que les colonnes nécessaires. Trop d'index peuvent ralentir l'ajout ou la modification de données (INSERT/UPDATE).

En savoir plus / Références

Documentation MySQL 8.0 : Optimisation et Index
Documentation MySQL 8.0 : Comprendre EXPLAIN

Ce guide explique ce à quoi correspond le bouton de connexion en Single Sign-On (SSO) sur les pages de connexion Infomaniak et détaille la procédure pour configurer cette fonctionnalité au sein de votre organisation.

Préambule

• Le Single Sign-On (SSO) est un mécanisme d'authentification permettant aux utilisateurs de se connecter à plusieurs applications en utilisant un seul jeu d'identifiants.
• Le SSO simplifie l'accès aux services Infomaniak et renforce leur sécurité, en vous permettant notamment :
  • d'utiliser vos identifiants professionnels sans mot de passe supplémentaire ;
  • d'appliquer les règles de sécurité de l'organisation, notamment l'authentification multifacteur (MFA) ;
  • de centraliser la gestion des comptes, du provisionnement (SCIM) et des autorisations.
• Si vous n'êtes pas au courant de cette fonctionnalité ou si vous êtes un client privé Infomaniak, connectez-vous comme d'habitude à l'aide du bouton bleu standard.

Configurer l'intégration SSO pour votre organisation

Prérequis

• Infomaniak propose cette option sur ses différentes pages de connexion, y compris dans ses applications mobiles, pour les utilisateurs dont l'organisation a activé cette fonctionnalité.

Pour demander l'activation du SSO pour votre organisation, prenez connaissance des informations ci-dessous jusqu'à la fin puis contactez directement le support Infomaniak en ouvrant une demande depuis support.infomaniak.com. Infomaniak fournira ensuite les informations nécessaires pour connecter sa plateforme au fournisseur d'identité de votre organisation.

Fournisseurs d'identité compatibles

La connexion SSO et la gestion automatisée des utilisateurs (SCIM 2.0) sont disponibles sur les pages de connexion et applications mobiles Infomaniak avec :

• Microsoft Entra ID (anciennement Azure AD).
• Tout autre fournisseur d'identité (IdP) prenant en charge les protocoles standard SAML 2.0 et SCIM 2.0.
• Okta via l'application pré-intégrée officielle disponible dans le catalogue Okta Integration Network (OIN).

Concernant Okta, l'intégration officielle pré-configurée permet un déploiement simplifié en quelques étapes depuis leur console d'administration:

1. Connectez-vous à votre console d'administration Okta.
2. Accédez à Applications > Applications > Add Integration.
3. Recherchez Infomaniak dans le catalogue et cliquez sur Add Integration.
4. Configuration de l'authentification SSO (SAML 2.0) :
   • Dans l'onglet Sign On, récupérez l'URL des métadonnées (Metadata URL) ou le fichier de métadonnées généré par Okta.
   • Assignez l'application aux utilisateurs ou aux groupes autorisés à accéder aux services Infomaniak.
5. Configuration du provisionnement automatique (SCIM 2.0 - Optionnel) :
   • Dans l'onglet Provisioning, activez l'intégration API pour permettre la création, la mise à jour et la désactivation automatiques des comptes utilisateurs.
6. Ouvrez une demande depuis support.infomaniak.com en transmettant votre URL de métadonnées Okta pour finaliser le raccordement de votre domaine.

Ce guide vous aide à configurer votre encodeur avec le service de Streaming vidéo Infomaniak.

Préambule

• La structure de ce guide s'articule en fonction de la qualité d'encodage choisie pour votre flux:
  
• Le système d'authentification par URL proposé par Infomaniak diffère de l'authentification proposée par défaut par certains encodeurs.
• Ces informations sont uniquement données à titre indicatif et la configuration de votre encodeur peut varier selon votre appareil, votre logiciel et les options de votre produit (matériel Infomaniak par exemple).
• Guide spécifique pour OBS Studio (Open Broadcaster Software).

Configuration requise par l'encodeur

Voici comment accéder aux informations de configuration requises par votre encodeur:

1. Cliquez ici afin d'accéder à la gestion de votre produit sur le Manager Infomaniak (besoin d'aide ?).
2. Cliquez sur le menu d'action ⋮ à droite de l'objet concerné dans le tableau qui s'affiche.
3. Cliquez sur Configurer l'encodeur:
   
4. Suivez les instructions adaptées à votre situation.

1. Gestion automatique du multi-bitrate par Infomaniak

Si vous avez choisi de laisser Infomaniak gérer automatiquement la qualité de votre flux:

• Avec ce cas de figure, les informations de configuration suivantes sont disponibles:
• Dans cet exemple, le flux se nomme "DemoFAQ" et sa clé d'authentification est "B5rPcw11" :
  • Adresse du serveur :rtmp://demofaq-1.vprimary.infomaniak.com/livecast?key=B5rPcw11
  • Identifiant du flux : demofaq-1

1.1 Configuration de la qualité de la source

Les qualités de flux générés par Infomaniak dépendront de la qualité de votre source (bitrate). À titre indicatif, voici la liste des qualités qui pourraient être générées au moment de la connexion de votre encodeur :

• 1080p avec un bitrate de 3 Mbps
• 720p avec un bitrate de 1,8 Mbps
• 480p avec un bitrate de 0,8 Mbps
• 360p avec un bitrate de 0,5 Mbps
• 240p avec un bitrate de 0,3 Mbps*

* Le 240p sera proposé uniquement si votre bitrate source est inférieur à 0,8 Mbps.

Il est recommandé idéalement de définir une source de 1080p avec un bitrate de 3,2 Mbps afin de générer l'ensemble de qualités disponible. Si le bitrate de votre source est limité à 1 Mbps, seules les résolutions suivantes seront générées : 480p, 360p et 240p.

Important : vérifier que le contrôle du débit soit réglé en mode CBR (constant bitrate) au niveau de votre encodeur. Le mode ABR (adaptive bitrate) peut en effet fausser la détection du bitrate de votre source.

1.2 Votre encodeur requiert une adresse de connexion et un identifiant de flux

Si votre encodeur demande une adresse de connexion et un identifiant de flux, il vous suffit de renseigner l'adresse du serveur et l'identifiant du flux dans votre encodeur.

Dans cet exemple, il s'agirait donc des informations suivantes :

• Adresse du serveur :rtmp://demofaq-1.vprimary.infomaniak.com/livecast?key=B5rPcw11
• Identifiant du flux : demofaq-1

1.3 Votre encodeur requiert uniquement une URL

Si votre encodeur demande uniquement une URL, il est nécessaire de regrouper l'adresse du serveur et l'identifiant de connexion ; dans cet exemple, il s'agirait donc de l'URL suivante :

• rtmp://demofaq-1.vprimary.infomaniak.com/livecast?key=B5rPcw11/demofaq-1

1.4 Votre encodeur propose une configuration avancée

Si votre encodeur propose un large choix de paramètres, suivre les indications suivantes qui sont toujours basées sur le même exemple :

• Adresse serveur RTMP : demofaq-1.vprimary.infomaniak.com
• Port du serveur RTMP : 1935
• Nom d'utilisateur RTMP : laissez ce champ vide (l'authentification se fait par clé avec une clé sur l'identifiant de stream)
• Mot de passe RTMP : laissez ce champ vide (l'authentification se fait par clé avec une clé sur l'identifiant de stream)
• Nom d'Application RTMP : livecast?key=B5rPcw11
• Nom de stream RTMP : demofaq-1

2. Gestion manuelle du multi-bitrate

Si vous avez décidé de gérer manuellement les qualités de votre flux:

• Si vous utilisez l'option Transcodage dans le Cloud, prenez connaissance du point 3. Single bitrate plus bas.

Avec ce cas de figure, vous retrouverez un tableau contenant les différentes qualités (bitrate/résolutions) que vous aurez définis lors de la configuration de votre encodeur:

Dans cet exemple, il s'agirait donc des informations suivantes :

• Adresse du serveur :rtmp://demofaq-1.vprimary.infomaniak.com/livecast?key=B5rPcw11
• Identifiant du flux : demofaq-1

2.1 Votre encodeur requiert une adresse de connexion et un identifiant de flux

Si votre encodeur demande une adresse de connexion et un identifiant de flux, il vous suffit de renseigner l'adresse du serveur et l'identifiant pour chaque flux dans votre encodeur.

2.2 Votre encodeur requiert une URL par flux

Si votre encodeur requiert des configurations spécifiques par URL, il est nécessaire de regrouper l'adresse du serveur et l'identifiant de connexion pour chaque bitrate. Dans cet exemple, il s'agirait donc des URL suivantes :

• Bitrate 6000000 : rtmp://demofaq-1.vprimary.infomaniak.com/livecast?key=B5rPcw11/demofaq-1
• Bitrate 4500000 : rtmp://demofaq-1.vprimary.infomaniak.com/livecast?key=B5rPcw11/demofaq-1-1
• Bitrate 4000000 : rtmp://demofaq-1.vprimary.infomaniak.com/livecast?key=B5rPcw11/demofaq-1-2
• Bitrate 1000000 : rtmp://demofaq-1.vprimary.infomaniak.com/livecast?key=B5rPcw11/demofaq-1-3

3. Single bitrate (une seule qualité)

Prenez connaissance des indications fournies au point 1. Gestion automatique du multi-bitrate par Infomaniak en ignorant le point 1.1.

Ce guide détaille les raisons pour lesquelles l'envoi d'une Newsletter via Infomaniak peut être bloqué, ainsi que les bonnes pratiques pour prévenir ces blocages à l'avenir.

Causes fréquentes de blocage d'une Newsletter

L'envoi d'une Newsletter peut être interrompu dans les cas suivants :

• un nombre excessif d'adresses e-mail destinataires sont invalides ou inexistantes, générant un fort taux de rebonds (« bounces »).
• un taux élevé de signalements de spam (« spam complaints ») provenant des destinataires.

En tant qu'hébergeur mail et fournisseur de service d'envoi de Newsletters, Infomaniak est tenu de mettre en place des mécanismes stricts de lutte contre le spam.

En effet, si les adresses IP ou les domaines d'Infomaniak sont inscrits sur des listes noires (« blacklists »), cela compromettrait la délivrabilité de tous les e-mails envoyés par ses clients, y compris ceux conformes, et nuirait à la réputation globale du service.

Prévenir les blocages lors de l'envoi d'une Newsletter

Pour cela:

• Utilisez exclusivement des listes de contacts obtenues avec leur consentement explicite.
• Privilégiez la constitution de vos listes par des formulaires double opt-in, garantissant une validation active des abonnés.
• Nettoyez régulièrement vos listes de contacts — au minimum une fois par an — avec des services spécialisés tels que NeverBounce, Bounceless, Verifalia ou QuickEmailVerification, afin de retirer les adresses invalides ou inactives.
• Veillez à ce que vos e-mails affichent clairement votre marque ou le nom de votre société, renforçant la confiance des destinataires et la transparence de vos communications.
• Évitez d'importer des listes provenant d'autres hébergeurs sans avoir préalablement effectué un nettoyage approfondi de ces contacts.
• Vérifiez minutieusement le ciblage de votre campagne pour vous assurer que seuls les abonnés pertinents et consentants recevront la Newsletter.

Que faire en cas de blocage d'envoi ?

En cas de blocage, contactez le support Infomaniak rapidement afin de diagnostiquer la cause et d'obtenir une assistance pour finaliser l'envoi bloqué.

Ce guide vous explique comment aider les clients qui seraient bloqués lors de l'utilisation d'une carte de crédit (dans le cadre du système de billetterie Infomaniak).

Demandez des informations aux clients 

La billetterie en ligne d'Infomaniak permet aux clients de régler leurs achats de manière sécurisée avec une carte de crédit. Pour cette raison, l'authentification 3-D Secure est obligatoire pour tous les paiements par cartes de crédit et de débit.

Demandez au client quel est le souci rencontré pour tenter de le résoudre. Voici quelques exemples types qui peuvent être rencontrés:

Fenêtre ou page blanche qui s'affiche

La billetterie essaie de faire appel à la page de 3D-Secure de la banque du client. La page blanche indique que sa carte n'a pas l'option de 3D-Secure activée. Il faut que le client prenne contact avec sa banque pour demander l'activation de cette option. 

Impossible d'effectuer le paiement avec la carte de crédit

Assurez-vous que le client utilise bien une carte de crédit VISA ou MasterCard. Certaines banques émettent des cartes qui ne sont pas sur ces réseaux. Infomaniak n'accepte pas les cartes de crédit sur les réseaux American Express.

Notification pour l'authentification reçue, mais impossible à procéder

Il faudra que le client contacte sa banque ou essaie avec une autre carte.

Soucis de paiement lié à une carte de crédit

Il vous est possible d'obtenir plus d'informations sur ce genre de problème depuis le Manager Infomaniak.

Veuillez retrouver la commande au moyen du numéro de commande, adresse mail, ou toute autre information liée au client:

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é à la billetterie concernée par l'évènement.
3. Cliquez sur Ventes dans le menu latéral gauche.
4. Cliquez sur Commande dans le menu latéral gauche.
5. Cherchez la commande au moyen des informations fournies par le client.
6. Cliquez sur le numéro de commande:
   
7. Cliquez sur l'onglet Transactions.‍
8. Vérifiez les Notes ‍‍des transactions n'ayant pas abouti:
    

Cas de transactions inachevées avec des notes

Dans le cas illustré ci-dessus, il s'agit d'un échec de la double authentification par 3D-Secure, mais les raisons peuvent être diverses. Ces notes sont les messages d'erreurs transmises par la banque du client, et sont souvent juste une indication du type d'erreur. 

Cas de transactions non existantes

Si l'onglet Transactions indique un 0 et n'a aucun élément, le client n'a pas pu commencer les démarches du paiement en ligne. Il faut donc qu'il vérifie si sa carte est bien une carte VISA ou MasterCard.

Résolution du problème

Il y a deux façons d'aider le client lors de problèmes de paiement avec la carte de crédit. Il doit soit…

1. … essayer avec une autre carte de crédit ou un autre mode de paiement,
2. … contacter sa banque afin de régler le problème avec la carte utilisée.

Pour les autres cas

Veuillez vous munir d'un maximum d'information avant de contacter le support Infomaniak qui pourra entreprendre des recherches plus approfondies.

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 propose une check-list des points importants à vérifier avant la mise en ligne d'une vente de billets (dans le cadre du système de billetterie Infomaniak) pour promouvoir au mieux vos évènements auprès du public.

Parcourir la liste de vérifications

Voici la liste des éléments les plus importants à contrôler avant toute mise en ligne d'une billetterie pour votre évènement.

1. Un compte bancaire a-t-il été ajouté dans le menu Comptabilité > Encaissements Infomaniak ?
2. Le lien d'intégration a-t-il été récupéré et intégré ?
   • Attention: le lien d'intégration a son propre paramétrage permettant d'afficher/cacher les évènements dans le sous-menu “Contenu”.
   • S'assurer que les évènements qui intéressent sont en "Actifs" (seulement si le paramètre "choisir manuellement les éléments à afficher" est activé).
3. Les Tarifs, Zones, Evènements sont-ils en mode Visible ? Afin de le vérifier:
   1. Evènement : Paramètres > Evènement > texte vert/orange/rouge avec symbole d'oeil en dessous de l'event.
   2. Zone : Paramètres > Evènement > Tarification > symbole d'oeil à droite de chaque zone.
   3. Tarifs ; comme les zones, mais ouvrir les zones pour voir les tarifs qu'elles contiennent.
4. Les modes de paiement (Ventes > Modes de paiement) souhaités sont-ils activés ?
5. Les informations de l'organisateur sont-elles à jour (Paramètres > Paramètres de la billetterie > information de contact organisateur) ?
   • Un mail est obligatoire, et un numéro de téléphone joignable est fortement conseillé.
   • La TVA est-elle définie correctement?
6. Les pass/abonnements sont-ils ok ? (Programmation > Pass)
   1. Contiennent-ils tous les évènements auxquels ils donnent accès ?
   2. Leurs jauges et tarifs sont-ils ok ?
   3. Sont-ils visibles sur la boutique ? (symbole d'oeil à gauche de chaque pass dans la liste)
7. Dans le menu Paramètres > Paramètres de la billetterie :
   1. Désactivez le mode test/démo.
   2. Activez la billetterie.

Prenez également connaissance du guide de démarrage afin d'avoir une meilleure vue sur les possibilités qu'offrent votre outil de billetterie.

Ce guide permet de résoudre une erreur mail de type "535 5.7.0 authentication failed".

Résoudre une erreur Authentication failed

Le service d'authentification mail présent sur les serveurs peut rencontrer un souci durant quelques brèves secondes de façon exceptionnelle, lors d'évènements inhabituels sur l'infrastructure par exemple.

Si une erreur 535 5.7.0 authentication failed survient:

• Patientez quelques minutes puis réessayez d'envoyer le message une nouvelle fois et celui-ci devrait partir.

Si le problème persiste, vérifiez les points de cet autre guide.

Ce guide explique à quoi sert l'option "Préfixe MySQL" dans les paramètres d'un site et quelles sont ses implications pour le fonctionnement de vos applications Web (CMS) et scripts PHP.

Préambule

• Lorsque l'option "Préfixe MySQL" est activée pour un site, il n'est plus nécessaire d'ajouter le préfixe "wxyz_" devant le nom et les utilisateurs de vos bases de données MySQL.
• Un script PHP pourra ainsi se connecter à MySQL avec l'utilisateur "monuser" et une base de données "mabase" et l'accès se fera automatiquement avec l'utilisateur "wxyz_monuser" et la base de données "wxyz_mabase".
• ⚠ S‍i vous effectuez une migration depuis une ancienne offre Infomaniak:
  • Après avoir migré un site de l'ancienne console, l'option "Préfixe MySQL" est activée par défaut afin de maintenir automatiquement la connexion de vos applications Web (WordPress, Joomla, Drupal, etc.) et scripts PHP avec vos bases de données MySQL.
  • Afin d'assurer le bon fonctionnement de vos sites en cas de migration de votre hébergement sur un autre serveur, il est fortement recommandé de désactiver cette fonction et d'effectuer les ajustements que cela implique.‍

Gérer l'option Préfixe MySQL

Aller plus loin avec les variables d'environnement

Il est possible de configurer des variables d'environnement directement depuis le Manager pour l'ensemble de votre site:

1. Cliquez ici afin d'accéder à la gestion des hébergements & sites sur votre Manager Infomaniak (❓: aide).
2. Cliquez sur le nom du produit concerné.
3. Cliquez sur Gérer les paramètres avancés:
   
4. Cliquez sur l'onglet PHP / Apache:
   
5. Activez ou désactivez le bouton à bascule (toggle switch) Préfixe MySQL:
   
6. Cliquez sur le bouton Enregistrer en bas de page.
7. Effectuez les ajustements nécessaires dans les fichiers de configuration de vos applications Web et scripts PHP…

Implications et ajustements à effectuer

Après avoir désactivé l'option Préfixe MySQL pour un site, certains scripts PHP ou CMS risquent de ne plus fonctionner.

Afin de rétablir la connexion à vos bases de données, vous devrez impérativement mettre à jour les informations suivantes dans le(s) fichier(s) de configuration des scripts concernés:

• le nom de la base de données MySQL: il faudra y ajouter le préfixe de votre serveur
  • avant: dbname
  • après: wxyz_dbname
• l'utilisateur de la base de données MySQL: il faudra y ajouter le préfixe de votre serveur
  • avant: dbuser
  • après: wxyz_dbuser

Ce guide explique comment ajouter une adresse de facturation afin que les produits de votre Organisation puissent être facturés à l'avenir sous de nouvelles coordonnées, pour par exemple attribuer des factures à des personnes différentes.

Ajouter des adresses de facturation

Afin de créer des adresses de facturation supplémentaires:

1. Cliquez ici afin d'accéder à la gestion des adresses de facturation.
   • L'accès nécessite une authentification avec un utilisateur qui dispose de droits suffisants.
2. Cliquez sur le bouton Ajouter.
3. Entrez les coordonnées désirées pour l'adresse de facturation supplémentaire.
4. Si nécessaire, définissez cette adresse par défaut.
5. Cliquez sur Confirmer:
   
    

Au renouvellement d'un produit, choisissez l'adresse de facturation souhaitée.

Prenez connaissance de cet autre guide si vous recherchez des informations au sujet de l'adresse postale actuellement définie.