Ce guide explique comment insérer une image, un logo, un filigrane, un watermark, sur vos diffusions de Streaming vidéo afin de renforcer votre image de marque et protéger votre contenu contre la copie ou d'éventuels détournements.

Ajouter l'image sur le flux

Vous avez la possibilité d'ajouter une image qui apparaitra sur votre flux vidéo:

1. soit depuis la configuration d'un Player (gratuit)…
   • Le logo est superposé sur la vidéo et ne sera pas visible si le flux est intégré en dehors du Player.
2. soit en inscrustant le logo via un transcodage (option payante)…
   • Le logo est incrusté dans la vidéo et sera visible dans tous les cas ; cela nécessite le réencodage complet du ou des flux par un serveur de transcodage, ce qui explique le coût de cette méthode.

Dans les deux cas il est possible de personnaliser les paramètres suivants:

• Position du logo (dans l'un des quatre coins du player, espacement depuis le bord, etc.).
• Taille du logo (par exemple un logo à 50% sera deux fois plus petit):
  • Il est recommandé d'utiliser la taille native pour optimiser le chargement et la qualité du rendu.
  • Dans le cas du transcodage vidéo, la taille du logo est calculée par rapport à la vidéo source (ou qualité maximum) ; le logo sera redimensionné automatiquement si des qualités inférieurs sont présentes afin de conserver un ratio identique.
• Opacité du logo.

1. Superposer un logo via le Player (gratuit)

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 Intégration dans le menu latéral gauche.
4. Cliquez sur Players dans le menu latéral gauche.
5. Cliquez sur le nom du Player à personnaliser.
6. Cliquez sur l'onglet (ou menu déroulant) Apparence.
7. Ajoutez le logo souhaité au format png, jpg ou gif (non animé) et sauvegardez en bas de page:
   

2. Activer l'option watermark (option payante)

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 Options depuis le menu latéral gauche.
5. Activez l'option Watermark:
   
6. Ajoutez le logo souhaité au format png, jpg ou gif (non animé).

Ce guide explique comment créer un relais de flux sur le Streaming radio Infomaniak.

Préambule

• Premièrement, pour créer un flux standard, vous devez disposer d'un encodeur radio.
  • Les paramètres de configuration fournis à la fin de la procédure de création du flux vous permettent de configurer votre encodeur.
  • Une fois cette opération effectuée, le flux sera envoyé depuis votre encodeur vers les serveurs d'Infomaniak.
• Ensuite, vous avez la possibilité de spécifier le relais d'un flux quel qu'il soit (Webradio quelconque par exemple).
  • Dans ce cas, Infomaniak ne reçoit plus la radio via un encodeur qui se connecte sur le serveur master mais relaie le flux que diffuse un autre serveur.
  • Si vous créez ce relais de flux, votre flux est déjà disponible et accessible via une adresse hôte (nom de domaine ou adresse IP).
  • Cette adresse devra être spécifiée sur le Manager afin que les serveurs d'Infomaniak puissent récupérer votre flux.
• Au même endroit vous pouvez activer l'option de flux de secours.
  • Ainsi si votre flux principal devient indisponible, le flux de secours prendra automatiquement le relais.

Créer un relais de flux

Afin d'accéder au service de Streaming radio :

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 ensuite sur le nom de la radio:
   
4. Cliquez sur le bouton Configurer les flux:
   
5. Cliquez sur le bouton Ajouter un flux:
   
6. Sélectionnez Relais de flux.
7. Cliquez sur le bouton Continuer:
   

La configuration demande 3 champs:

1. nom de serveur
2. port
3. point de montage

Si le flux que vous devez relayer se compose ainsi: http://server.com:82/music.mp3 alors indiquez:

1. server.com
2. 82
3. music.mp3

Cela dit, dans certains cas le champ point de montage peut être vide et l'extension pas forcément nécessaire. S'il n'y a pas de port dans l'URL avec http, il faut mettre simplement "80".

Cliquez sur le bouton bleu pour valider le flux puis cliquez sur Enregistrer en bas à droite.

Vous pouvez également ajouter un relais de flux en tant que flux de secours si vous activez cette option lors de l'ajout d'un flux standard:

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 générer une demande de certificat (CSR) pour un nom de domaine et tous ses sous-domaines avec un Hébergement Web (hors hébergement gratuit de type Starter), permettant ainsi de chiffrer la connexion à votre nom de domaine et à tous ses sous-domaines via un certificat SSL unique.

Préambule

• La configuration permet d'avoir un "site nommé" et un "site backup" ; pour que cela fonctionne sans conflit, assurez-vous que le wildcard et vos sous-domaines précis ne se chevauchent pas sur le même hébergement Web:
  • Niveau DNS la priorité est naturelle: si un sous-domaine spécifique existe (ex: prive.domain.xyz), c'est lui qui est sollicité, sinon, la requête est redirigée vers le wildcard (*.domain.xyz).
  • Niveau Serveur il est nécessaire d'être vigilant: si le wildcard et le sous-domaine spécifique se trouvent sur le même serveur, c'est l'implémentation logicielle (Apache) qui décide ; Apache traite les requêtes selon l'ordre d'évaluation des fichiers de configuration.
  • Le risque : si le wildcard est évalué en premier, il "capture" tout le trafic, rendant votre sous-domaine spécifique inaccessible, même s'il existe par ailleurs.
  • Par conséquent il ne faut pas mettre le wildcard sur le même hébergement qu'un sous-domaine plus précis le chevauchant.

Mettre en place un certificat Wildcard

1. Ajouter un domaine alias avec astérisque *

Afin d'ajouter un alias de type * à votre site Web:

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 ensuite sur le chevron ‍ pour développer la partie Domaines de ce site.
4. Cliquez sur le bouton Ajouter un domaine:
   
5. Saisissez le nom de domaine à ajouter sous cette forme:
   • *.domain.xyz (l'astérisque est indispensable, suivie d'un point, puis du nom de domaine du site Web qui est dans cet exemple domain.xyz)
6. Cliquez sur le bouton Confirmer pour terminer la procédure:
   

2. Installer un certificat SSL ou le mettre à jour

Exemple de mise à jour du certificat existant afin d'inclure le sous-domaine * wildcard:

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 Certificat SSL dans le menu latéral gauche.
4. Cliquez sur le menu d'action ⋮ situé à droite.
5. Cliquez sur Mettre à jour le certificat:
   
6. Veillez à ce que le sous-domaine récemment ajouté soit bien sélectionné.
7. Cliquez sur le bouton Installer en bas:
   
8. Patientez le temps de la création ou de la mise à jour.

Ce guide explique comment ajouter et configurer un module de boutique en ligne sur votre site créé avec Site Creator Infomaniak pour vous lancer dans le e-commerce et proposer vos produits à la vente.

Prérequis

• Accéder à Site Creator:
  • Cliquer ici afin d'accéder à la gestion de votre produit sur le Manager Infomaniak (besoin d'aide ?).
  • Cliquer directement sur le nom attribué au Site Creator concerné.
  • Cliquer sur le bouton Éditer mon site pour démarrer l'éditeur:
    

Ajouter le magasin en ligne sur Site Creator

Thèmes dédiés

Si vous envisagez de créer un site entièrement dédié à vos produits sous la forme d'une boutique en ligne, vous pouvez choisir dès le départ d'appliquer un thème parmi ceux de la catégorie E-Commerce:

Module de boutique pour Site Creator

Si le module Shop n'est pas encore intégré à vos pages, il suffit de le rajouter à l'endroit de votre choix:

1. Cliquez sur le bouton Contenu dans la barre latérale gauche.
2. ‍Cliquez sur Applications en bas de liste puis sur Boutique:
   
3. La boutique et 3 produits d'exemple sont insérés:
   

Configurer la boutique

Prenez connaissance de cet autre guide au sujet des différentes options de configuration de la boutique Site Creator.

Ce guide explique comment lier un nom de domaine à l'offre kSuite Infomaniak.

Gérer le domaine kSuite

Pour commencer:

1. Cliquez ici afin d'accéder à la gestion de votre kSuite sur le Manager Infomaniak (besoin d'aide ?).
2. Si un domaine est déjà lié, vous pouvez intervenir sur ce dernier en cliquant sur le menu d'action ⋮ à droite du nom de la kSuite, puis Gérer les domaines:
   
3. Si aucun domaine n'est encore lié, vous pouvez en ajouter 1 en cliquant sur le bouton:
   
4. Cliquez sur le bouton pour ajouter un domaine:
   
5. Choisissez le domaine à rattacher parmi ceux de votre Organisation (encore disponible, c'est-à-dire non-rattaché à quelque service que ce soit) ou entrez un nom de domaine externe :
   
   • Selon la situation de votre domaine (prenez également connaissance des informations ci-dessous), il vous faudra procéder au préalable à des manipulations…
     
   • … voire même à un achat de domaine si besoin:
     

Si le nom de domaine se trouve…

… chez Infomaniak, même Organisation

Si votre nom de domaine est enregistré auprès d'Infomaniak et qu'il se trouve dans le même compte utilisateur ou Organisation que la messagerie, alors il n'y a rien à faire.

Ajoutez-le simplement à votre kSuite:

Le domaine sera ainsi ajouté et visible sur le tableau de bord:

• Prenez connaissance de cet autre guide afin de vérifier et corriger d'éventuelles erreurs de configuration.

... chez Infomaniak, même Organisation et déjà lié à un Service Mail ou kDrive

Pas de souci, vous pouvez transformer vos produits existants en kSuite.

… chez Infomaniak, Organisation différente

Si votre nom de domaine est enregistré auprès d'Infomaniak mais dans un autre compte utilisateur ou Organisation, alors:

• Éditez sa zone DNS en y spécifiant le MX d'Infomaniak (+ SPF & DKIM).
  • Tout ajout / modification DNS peut prendre jusqu'à 48 heures pour se propager.

OU

• Déplacez-le au sein de la même Organisation.

En général, un message vous signalera cette situation:

… et les informations techniques, à reporter là où se trouve le domaine, vous seront proposées:

… chez Infomaniak avec des DNS externes

Si votre nom de domaine comporte des DNS qui ne sont pas ceux d'Infomaniak alors:

• Éditez la zone DNS actuelle là où elle se trouve (si nécessaire consultez l'aide du prestataire concerné) en y spécifiant le MX d'Infomaniak (+ SPF & DKIM).
  • Tout ajout / modification DNS peut prendre jusqu'à 48 heures pour se propager.

OU

• Changez les DNS actuels et sélectionnez l'utilisation des DNS Infomaniak.
  • Tout ajout / modification DNS peut prendre jusqu'à 48 heures pour se propager.
• Prenez connaissance de cet autre guide afin de vérifier et corriger d'éventuelles erreurs de configuration.

Cela vous le sera signalé (cf les images ci-dessus).

… ailleurs avec des DNS externes

Si votre nom de domaine est enregistré chez un autre registrar et comporte des DNS qui ne sont pas ceux d'Infomaniak alors:

• Éditez la zone DNS actuelle là où elle se trouve (si nécessaire prenez connaissance de l'aide du prestataire concerné) en y spécifiant le MX d'Infomaniak (+ SPF & DKIM).
  • Tout ajout / modification DNS peut prendre jusqu'à 48 heures pour se propager.

OU

• Changez les DNS actuels (si nécessaire prenez connaissance de l'aide du prestataire concerné) en y spécifiant ceux d'Infomaniak (cela implique d'avoir une zone DNS auprès d'Infomaniak.
  • Tout ajout / modification DNS peut prendre jusqu'à 48 heures pour se propager.
• Cette zone DNS auprès d'Infomaniak sera configurée correctement mais prenez connaissance de cet autre guide afin de vérifier et corriger d'éventuelles erreurs de configuration.

Cela vous le sera signalé (cf les images ci-dessus).

… ailleurs mais vous le rapatriez

Si votre nom de domaine est enregistré chez un autre registrar et que vous souhaitez le rapatrier au même endroit que votre messagerie Infomaniak, alors:

• Transférez le nom de domaine vers Infomaniak (celui-ci sera configuré correctement mais prenez connaissance de cet autre guide afin de vérifier et corriger d'éventuelles erreurs de configuration).

Sinon envisagez la commande d'un nouveau nom de domaine si nécessaire.

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 bénéficier de nouvelles versions de PHP, MySQL et de nombreux autres paquets en faisant migrer un Serveur Cloud sur une nouvelle infrastructure Infomaniak.

Préambule

• La migration est gratuite et se déroule en 3 étapes:
  1. Infomaniak met à disposition un Serveur Cloud dernière génération ayant les mêmes caractéristiques que l'actuel, au même tarif et même durée d'engagement.
  2. Vous disposez d'un mois pour déplacer vos hébergements sur le nouveau Serveur Cloud mis à disposition (lire ci-dessous).
  3. Lorsque vos hébergements sont déplacés sur le nouveau serveur, résiliez l'ancien Serveur Cloud.
• 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.
• Lors de cette opération, les statistiques sont réinitialisées.

Procédure de migration

En migrant vos données sur la nouvelle infrastructure Cloud, vous augmentez la performance et la fiabilité de vos sites qui accéderont aux dernières technologies:

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 bleu dans l'encadré "Faire évoluer votre Serveur Cloud" (ou sur Gérer):
   

Ce guide explique comment supprimer des dossiers qui apparaissent grisés sur l'app Web Mail Infomaniak (service en ligne ksuite.infomaniak.com/mail) ou dans certains logiciels/clients de messagerie comme Apple Mail, Mozilla Thunderbird ou Microsoft Outlook.

Dossiers fantômes

Certains logiciels/clients de messagerie comme Microsoft Outlook permettent de créer des sous-dossiers de dossiers inexistants. Par exemple, il est possible de créer le dossier /abc/klm/xyz alors que le dossier "klm" n'existe pas.

Sur Mail Infomaniak ou dans d'autres logiciels, les dossiers fantômes comme le dossier "klm" apparaissent en gris et ne peuvent pas être supprimés directement car ils ne sont que des "chemins" vers un sous-dossier réel.

Pour supprimer ces dossiers fantômes, il est nécessaire de supprimer leurs sous-dossiers au préalable (dans cet exemple: xyz).

Dossiers récalcitrants

Si, lors de la consultation de votre adresse mail Infomaniak sur Outlook, des dossiers fantômes persistent ou réapparaissent instantanément après suppression, voici les procédures techniques recommandées par Microsoft pour forcer la synchronisation:

1. Forcer la réinitialisation des dossiers Outlook

Parfois, la table des dossiers locale d'Outlook est corrompue. Une commande simple peut souvent corriger cela sans rien supprimer :

• Fermez Outlook complètement.
• Appuyez sur les touches Windows + R de votre clavier.
• Tapez outlook.exe /resetfolders et validez (cela restaure les dossiers manquants ou corrompus à partir du serveur).

2. Réinitialiser le cache IMAP (.ost)

Si le problème persiste, forcer Outlook à reconstruire sa base de données locale est souvent la solution la plus efficace :

• Fermez Outlook.
• Accédez au dossier : C:\Users\[Votre Nom d'Utilisateur]\AppData\Local\Microsoft\Outlook.
• Identifiez le fichier .ost portant le nom de votre adresse Infomaniak et supprimez-le (ou renommez-le en .old par sécurité).
• Relancez Outlook ; le logiciel va retélécharger l'intégralité de vos messages et dossiers proprement depuis les serveurs Infomaniak.

3. Utiliser l'outil MFCMAPI (Niveau Avancé)

MFCMAPI permet d'accéder directement à la structure MAPI de votre boîte aux lettres pour supprimer ce que l'interface standard d'Outlook refuse de toucher :

• Téléchargez la dernière version de MFCMAPI sur GitHub (Source officielle).
• Lancez MFCMAPI.exe et allez dans Session > Logon ; sélectionnez votre profil Outlook.
• Double-cliquez sur votre compte de messagerie Infomaniak dans la liste.
• Dans la nouvelle fenêtre, développez Root Container (ou Racine - Boîte aux lettres), puis IPM_SUBTREE.
• Localisez le dossier récalcitrant ; faites un clic droit et choisissez Delete folder.
• Attention : dans la boîte de dialogue, essayez d'abord la suppression simple ; si cela échoue, recommencez en cochant DELETE_HARD_DELETE (suppression définitive au niveau serveur).

4. Vérification finale via le Webmail

Si un dossier est supprimé dans Outlook mais revient toujours, vérifiez impérativement sur l'app Web Mail Infomaniak si le dossier y est présent, et supprimez-le d'abord via l'interface Web pour ensuite appliquer l'étape n°1 (resetfolders) dans Outlook.

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>";

Ce guide présente le fonctionnement des RBL, la politique discutable de certaines d'entre elles et les moyens pour résoudre un éventuel blocage mail.

Préambule

• Les RBL (Realtime Blackhole List) ou DNSBL (Black List DNS) sont des listes contenant des adresses / IP / noms de fournisseurs / serveurs, réputés comme grands émetteurs de spams.
• Il s'agit souvent de grandes listes noires généralisées (blacklist), permettant de repérer les messages considérés comme indésirables et ceux qui les envoient, que maintiennent certains prestataires (smtpcheck, uceprotect: liste non exhaustive)…

Ajout de l'adresse mail à la RBL

Lorsqu'une adresse mail est identifiée comme appartenant à un expéditeur indésirable, elle est bloquée pour prévenir la réception de messages non sollicités. Un blocage dans la RBL n'expire pas. Les adresses seront listées indéfiniment.

Si vous recevez un message indiquant que votre adresse mail est bloquée par RBL, cela signifie que le système de sécurité Infomaniak a détecté des activités suspectes ou indésirables associées à cette adresse mail. Cela peut inclure l'envoi massif de messages non sollicités, la participation à des campagnes de phishing ou d'autres comportements malveillants.

Résoudre un blocage mail (RBL)…

… si l'erreur mentionne votre adresse et RBL

Si vous obtenez des erreurs de type

anna.a@domain.xyz is rbl blacklisted - http://chk.me/rbl

lors de l'envoi d'un e-mail et que vous pensez que c’est un faux positif, contactez le support Infomaniak.

Pour éviter que votre adresse mail ne soit bloquée par le système de blocage RBL à l'avenir, respectez les bonnes pratiques d'utilisation de la messagerie:

1. N'envoyez pas de message non sollicité ni de message en masse à des destinataires inconnus.
2. Triez régulièrement la liste de destinataires utilisée.
3. Ne participez pas à des activités de phishing ou de cybercriminalité.
4. Assurez-vous du meilleur niveau de sécurité là où sont utilisés vos e-mails:
   1. mot de passe fort
   2. logiciels à jour
   3. système d'exploitation (iOS, Android, Windows, macOS, etc.) à jour
   4. configuration du domaine associé à jour

… si l'erreur mentionne un organisme comme Sorbs ou Barracuda

Si vous obtenez des erreurs de type

554 5.7.1 Client host blocked using sorbs

ou similaire:

1. Suivez la procédure de l'organisme mentionné (par exemple http://www.barracudacentral.org) pour obtenir la suppression de votre adresse de la liste.
2. Changez temporairement de fournisseur d’accès à Internet ou de méthode de connexion - WIFI vs 4G/5G - pour envoyer vos messages.
3. Informez votre correspondant et son fournisseur de messagerie de faire le nécessaire et/ou de ne plus utiliser une RBL peu fiable.
4. Patientez quelques heures et réessayez.

De moins en moins de professionnels (ISP, hébergeurs, etc.) se servent de prestataires type Backscatterer / UCEPROTECT à vocation avant tout pécuniaire et il y a énormément d'autres listes très efficaces, comme ABUSIX ou SPAMCOP, bien tenues à jour et dont le but réel est de lutter contre le spam, l'une des priorités d'Infomaniak.

Ce guide détaille les règles spécifiques à respecter lors de l'utilisation d'un mot de passe contenant le caractère “dollar” $ pour envoyer un e-mail via le SMTP Infomaniak dans un script (PowerShell, Python, etc.).

Préambule

• Si lors de l'envoi d'un e-mail via SMTP vous obtenez une erreur d'authentification (par exemple auth failed, invalid login or password) alors que le mot de passe est correct et fonctionne dans un logiciel comme Outlook, le problème peut venir du traitement du caractère $ dans votre script ou fichier de configuration.
• Pour garantir une exécution fiable de vos scripts SMTP, il est fortement conseillé d'éviter tout caractère spécial ayant une signification syntaxique, en particulier $, dans les mots de passe utilisés dans les scripts et fichiers de configuration.
• Le problème peut également survenir pour se connecter aux bases de données.

Règles à respecter

Le caractère $ est un symbole spécial dans de nombreux langages et environnements. Lorsqu'il est utilisé dans un mot de passe dans un script ou un fichier de configuration, il peut être interprété à tort comme une variable ou un caractère de contrôle.

Voici des cas fréquents où il ne faut pas utiliser le caractère $ dans un mot de passe :

• PowerShell : $ est utilisé pour déclarer des variables. Un mot de passe contenant $ peut provoquer des erreurs de syntaxe ou être tronqué.
• Bash / Shell (Linux) : $ est également un préfixe de variable. Il peut déclencher des substitutions inattendues.
• Fichiers YAML (par exemple Home Assistant, GitHub Actions, Docker Compose) : $ peut être interprété comme une variable d'environnement.
• Fichiers .env, .ini, ou autres fichiers de configuration : les outils qui lisent ces fichiers peuvent tenter d'interpréter les variables.
• Commandes ou URL avec authentification : un mot de passe contenant $ peut être mal encodé ou échoué lors de l'analyse.

Pour corriger ou prévenir ce type d'erreur :

• Évitez d'utiliser le caractère $ dans les mots de passe destinés à être utilisés dans des scripts ou systèmes automatisés.
• Si vous devez absolument l'utiliser, encadrez toujours la chaîne de mot de passe correctement selon le langage :
  • En PowerShell : utilisez des guillemets simples 'password$Test' si possible.
  • En Python : assurez-vous que la chaîne est bien entre guillemets simples ou doubles, sans interprétation.
  • En Bash : échappez le $ avec un antislash \$.

Ce guide explique comment créer un nouvel appareil (sauvegarde Cloud via OpenStack Swift) sur Swiss Backup, la solution de sauvegarde dans un cloud suisse indépendant. 

Prérequis

• Commander un espace Swiss Backup Infomaniak.
• Lors de la commande, avoir défini le quota d'appareil(s) disponible(s) (minimum 1) sous sauvegarde type Cloud:
  
• Si nécessaire, augmenter le quota d'appareil selon vos besoins.

Ajouter un appareil (pour connexion OpenStack Swift)

Pour accéder à Swiss Backup et configurer une nouvelle sauvegarde libre :

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 bleu Gérer mes appareils (dans la partie Espace de sauvegarde Cloud) :
   
4. Cliquez sur le bouton bleu Ajouter un appareil :
   
5. Choisissez le type / protocole de sauvegarde libre Swift.
6. Cliquez sur le bouton bleu Continuer :
   
7. Choisissez l'utilisateur qui recevra les informations de connexion (si nécessaire choisir un utilisateur différent du vôtre et spécifier les coordonnées de la personne à l'étape supplémentaire suivante).
8. Cliquez sur le bouton bleu Continuer :
   
9. Donnez un nom à la sauvegarde.
10. Définissez l'espace disque maximum que cet espace de sauvegarde devra représenter à partir du volume total du Swiss Backup souscrit, en augmentant si nécessaire la taille totale grâce au lien bleu.
11. Cliquez sur le bouton bleu Continuer :
    
12. Cliquez sur le bouton bleu pour afficher les informations de connexion :
    
13. Cette partie mentionne entre autre le chiffre représentant l'emplacement, utile pour compléter certaines informations que vous devrez fournir lors de la configuration de votre application de sauvegarde.
14. Cette partie donne un exemple de méthode de sauvegarde, facilitée grâce au téléchargement d'un profil de configuration.
15. Cette partie fournit l'ensemble des informations de connexion.
16. L'emplacement ou nom de serveur hôte.
17. Le mot de passe (à générer grâce au lien bleu qui va ouvrir l'assistant dans un popup du navigateur ou via le lien reçu par e-mail) ainsi que d'autres informations supplémentaires, comme le Tenant, pour certaines application de sauvegarde :
    

Et ensuite ?

Une fois l'appareil ajouté sur l'interface Swiss Backup au sein du Manager Infomaniak, vous pouvez configurer l'application de votre choix afin de commencer vos sauvegardes Cloud via le protocole mentionné dans ce guide.

Ce guide explique comment lier un nom de domaine à un Service Mail Infomaniak.

Si le nom de domaine se trouve…

… chez Infomaniak, même Organisation

Si votre nom de domaine est enregistré auprès d'Infomaniak et qu'il se trouve dans le même compte utilisateur ou Organisation que la messagerie, alors il n'y a rien à faire.

• Prenez connaissance de cet autre guide afin de vérifier et corriger d'éventuelles erreurs de configuration.

… chez Infomaniak, Organisation différente

Si votre nom de domaine est enregistré auprès d'Infomaniak mais dans un autre compte utilisateur ou Organisation, alors:

• Éditez sa zone DNS en y spécifiant le MX d'Infomaniak (+ SPF & DKIM).
  • Tout ajout / modification DNS peut prendre jusqu'à 48 heures pour se propager.

OU

• Déplacez-le au sein de la même Organisation.

… chez Infomaniak avec des DNS externes

Si votre nom de domaine comporte des DNS qui ne sont pas ceux d'Infomaniak alors:

• Éditez la zone DNS actuelle là où elle se trouve (si nécessaire consultez l'aide du prestataire concerné) en y spécifiant le MX d'Infomaniak (+ SPF & DKIM).
  • Tout ajout / modification DNS peut prendre jusqu'à 48 heures pour se propager.

OU

• Changez les DNS actuels et sélectionnez l'utilisation des DNS Infomaniak.
  • Tout ajout / modification DNS peut prendre jusqu'à 48 heures pour se propager.
• Prenez connaissance de cet autre guide afin de vérifier et corriger d'éventuelles erreurs de configuration.

… ailleurs avec des DNS externes

Si votre nom de domaine comporte des DNS qui ne sont pas ceux d'Infomaniak alors:

• Éditez la zone DNS actuelle là où elle se trouve (si nécessaire prenez connaissance de l'aide du prestataire concerné) en y spécifiant le MX d'Infomaniak (+ SPF & DKIM).
  • Tout ajout / modification DNS peut prendre jusqu'à 48 heures pour se propager.

OU

• Changez les DNS actuels (si nécessaire prenez connaissance de l'aide du prestataire concerné) en y spécifiant ceux d'Infomaniak (cela implique d'avoir une zone DNS auprès d'Infomaniak.
  • Tout ajout / modification DNS peut prendre jusqu'à 48 heures pour se propager.
• Cette zone DNS auprès d'Infomaniak sera configurée correctement mais prenez connaissance de cet autre guide afin de vérifier et corriger d'éventuelles erreurs de configuration.

… ailleurs mais vous le rapatriez

Si votre nom de domaine est enregistré chez un autre registrar et que vous souhaitez le rapatrier au même endroit que votre messagerie Infomaniak, alors:

• Transférez le nom de domaine vers Infomaniak (celui-ci sera configuré correctement mais prenez connaissance de cet autre guide afin de vérifier et corriger d'éventuelles erreurs de configuration).

Sinon envisagez la commande d'un nouveau nom de domaine si nécessaire.

Ce guide explique comment créer un modèle pour l'outil de signature pour toute votre messagerie sur l'app Web Mail Infomaniak (service en ligne ksuite.infomaniak.com/mail).

Préambule

• Un modèle permet de créer la base neutre d'un outil qui pourra être par la suite utilisé par plusieurs utilisateurs d'un même Service Mail Infomaniak, voire même personnalisé en fonction de la personne qui va s'en servir.
• Dans le cas d'un modèle de signature, le créateur du modèle créé le style de la signature, il choisit également le ou les éléments qui devront être présents, et c'est à l'utilisateur final, depuis son Mail, de terminer certains détails de sa signature.
• Vous pouvez également masquer un modèle pour ne plus qu'il soit utilisé.

Choisir le type de modèle de signature

Pour débuter la création d'un modèle:

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 Configuration globale dans le menu latéral gauche.
4. Cliquez sur l'onglet Signature.
5. Cliquez sur Ajouter un modèle de signature:‍
   
6. Sélectionnez le type de modèle (détails ci-dessous) et cliquez sur le bouton Continuer ( d ) pour accéder au modèle:
   
   1. Permet de configurer le bloc signature avec les informations habituelles ; les éléments sont détaillés plus bas dans ce guide:
      
   2. Permet de configurer le bloc signature avec les informations habituelles et la disposition des éléments peut être modifiée à l'aide de réglages prédéfinis ; les éléments sont détaillés plus bas dans ce guide:
      
   3. Permet de configurer le bloc signature en partant d'un bloc vide, et les informations peuvent être insérées sous forme de variables:
      
      • Il est également possible dans ce mode de travailler le code HTML directement:
        

Configurer la base de la signature

Selon le modèle sélectionné:

1. Définissez les champs à conserver et à insérer à l'aide des cases à cocher.
2. Paramétrez les préférences d'affichage de certaines informations comme l'ordre Prénom - Nom.
3. Certains champs peuvent être:
   
   • complétés par l'utilisateur dans ses paramètres de l'app Mail,
   • automatiquement complétés en fonction des informations présentes dans son compte Infomaniak,
   • déterminés ici et seront donc fixes et communs à tous les utilisateurs.
4. Cliquez sur le bouton Continuer en bas de page.
5. Donnez un nom au modèle.
6. Décidez si ce modèle doit être accessible et appliqué aux utilisateurs des adresses existantes sur le Service Mail.
7. Cliquez sur le bouton bleu Terminer ou sauvegardez comme brouillon:
   

Un e-mail est envoyé aux utilisateurs impactés par la création de ce modèle, les invitant à se rendre dans la gestion des signatures afin de compléter les informations si nécessaire.

• Lors de l'édition d'un modèle de signature, vous pourrez décider de notifier ou non les utilisateurs des modifications ayant eu lieu:
  

Compléter les informations utilisées par la signature

Selon le modèle utilisé, l'utilisateur final peut ajouter ses informations personnalisées sur l'app Mail pour que l'affichage de la signature soit complet:

Appliquer les signatures aux utilisateurs depuis ce modèle

Depuis la partie Signatures de la Configuration globale, cliquez sur le menu d'action ⋮ situé à droite du modèle de signature:

Vous pouvez éditer la signature, la dupliquer pour créer une signature différente pour certaines personnes à partir de ce modèle, et la supprimer.

Une autre option permet de créer les signatures pour les différents utilisateurs utilisant les adresses mail du domaine:

• Ils seront notifiés par mail qu'une nouvelle signature est disponible.
• Pour les adresses mail partagées, si vous souhaitez une signature générique qui utilise ce modèle, sans qu'elle soit associée à un utilisateur spécifique, vous devez la configurer vous-même depuis l'app Web Mail Infomaniak ou le Service Mail.

Les utilisateurs du Service Mail  pourront alors…

• … utiliser la nouvelle signature créée à partir de ce modèle
• … ajouter leurs informations personnelles

Forcer ce modèle pour les nouvelles signatures

Depuis la partie Signatures de la Configuration globale, activez le bouton à bascule (toggle switch) pour ne plus laisser la possibilité aux utilisateurs du Service Mail de créer une signature libre:

• Le modèle créé précédemment servira alors de base pour toute nouvelle signature créée par l'utilisateur:
  
• Si l'option est désactivée, le choix est laissé à l'utilisateur:
  

Activer un modèle sur une adresse mail existante

Il est nécessaire d'avoir un modèle existant pour l'activer sur une ou plusieurs adresses mail. Cela peut se réveler utile lorsque le modèle est créé après des adresses déjà existantes :

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 les cases pour sélectionner une ou plusieurs adresses mail dans le tableau qui s'affiche.
4. Cliquez sur le menu d'action ⋮ en bas de page.
5. Cliquez sur Appliquer un modèle de signature:
   
6. Sélectionnez le modèle de votre choix.
7. Cliquez sur le bouton Activer:
   

Ce guide explique comment modifier une adresse mail au sein d'un Service Mail dans le cas où vous souhaitez par exemple éditer l'orthographe de la partie venant avant l'arobase @ de votre adresse mail (= le préfixe).

Préambule

• Cela peut s'avérer utile pour les adresses “nom.prenom" en cas de changement de nom de famille (mariage par exemple) ou simplement un changement d'orthographe.
• Pour plutôt modifier la partie de votre adresse mail venant après l'arobase @, prenez connaissance de cet autre guide.

Modifier le préfixe d'une adresse mail

Pour passer d'une adresse mail de la forme adresse1@domain.xyz …

… à une adresse renommée adresse2@domain.xyz…

… et étant donné qu'il n'est pas possible de simplement modifier l'orthographe d'une adresse mail, il vous faut:

1. … soit créer un alias mail

   • puis en cas d'utilisation de logiciel/client de messagerie, reparamétrer vos configurations mail
   • et éventuellement dans Mail modifier l'adresse d'envoi dans la partie Signature

2. … soit créer une seconde adresse mail avec la nouvelle formulation

   • puis déplacer les messages de l'une à l'autre adresse
   • et supprimer la première adresse si nécessaire.

Ce guide permet de réaliser un diagnostic de votre Streaming Radio afin de trouver l'origine d'éventuels problèmes, causes de déconnexion, etc.

Préambule

• Si vous diffusez votre radio FM, contrôlez le bon fonctionnement de la carte d'acquisition.
• Si vous diffusez une Webradio, assurez-vous du bon fonctionnement de votre logiciel de diffusion.
  • Attention à la charge CPU sur votre ordinateur: veillez à ce que cela ne soit pas la saturation, en vous assurant d'avoir suffisamment de mémoire si vous faites des opérations en plus d'un encodage de flux AAC, très gourmand en mémoire.
• Il se peut que ce soit votre ligne Fibre/ADSL qui ne permet plus de suivre les données envoyées au serveur.
  • Vous devez avoir un débit en upload (donc en montant) au minimum équivalent au total des flux envoyés au serveur (par exemple une radio qui envoie un flux en 128kbs + un flux en 48kbs, cela donne 130 + 50 = 180kbit/s au minimum).
  • Généralement, les radios dédient une ligne exclusivement à la diffusion des flux audio afin d'éviter toute saturation de la bande passante en cas d'envoi simultané, comme l'envoi d'un gros e-mail avec une pièce jointe. Cette précaution garantit que l'upload ne monopolise pas la bande passante, ce qui pourrait entraîner des interruptions dans la diffusion des flux audio pendant l'écoute.
  • Votre FAI peut également générer une coupure sur la ligne, même infime mais cela aura comme effet de couper le flux radio.
• Si votre encodeur est configuré pour envoyer aux serveurs des metadatas via un fichier texte hébergé chez un autre fournisseur, et que ce dernier subit des perturbations, le flux peut également être perturbé!

Analyser les statistiques récentes

Les statistiques vous permettent de consulter d'éventuelles coupures de flux. Pour accéder à ces informations:

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 Statistiques dans le menu latéral gauche:
   
   • Les statistiques sont détaillées sur cet autre guide.

Vérifier le bon fonctionnement des éléments

La page de diagnostic radio vous permet d'accéder à diverses informations. Pour accéder à ces diagnostics:

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 Diagnostiques dans le menu latéral gauche.
   
   1. L'onglet Réseau et flux permet de tester la connexion entre votre serveur et les infrastructures Infomaniak.
   2. L'onglet Encodeurs affiche un historique des connexions des encodeurs pour analyser si les flux étaient opérationnels.
   3. L'onglet Serveurs vous renseigne sur l'état général des infrastructures réseau afin de vérifier le bon fonctionnement des serveurs de réception et de diffusion.
      • A noter que dans le cas d'une coupure générale des flux de broadcast, Infomaniak est prévenu et intervient de suite.
   4. L'onglet Stabilité du buffer est détaillé sur cet autre guide.

Ce guide explique comment protéger par clé unique des vidéos importées sur un service VOD Infomaniak.

Préambule

• Attention, la protection par token n'est effective que dans le cas d'une intégration standard par iframe et donc via l'utilisation du Player Infomaniak.
• D'autres restrictions d'accès peuvent être activées: mot de passe | geoip

Protéger une vidéo par clé unique

Vous avez la possibilité de protéger l'ensemble des médias d'un dossier avec la création d'un token. Ce dernier sera unique pour chacun de vos visiteurs et devra être passé en paramètre à votre media afin de limiter la consultation de ce dernier. Vous seul serez capable de générer la clé unique, nécessaire à chaque utilisateur pour voir les vidéos. Cette clé permet donc de n'autoriser que les personnes préalablement vérifiées par vos soins.

Cela permet de contrôler l'accès aux vidéos et de n'autoriser que certaines personnes, les autres étant refusées ; utile dans des cas tels que du pay-per-view ou des diffusions limitées. Cependant veuillez noter que c'est à vous de développer l'intégration à votre système existant. 

Si le hash n'est pas valide, l'accès à la vidéo retournera une page d'erreur "403 forbidden".

Activer la restriction sur le dossier d'importation

Lorsque le mot de passe est défini une fois pour toute au niveau du dossier de destination, toutes les nouvelles importations de médias comporteront automatiquement ce mode à leur lecture. Afin de configurer ce dossier:

1. Cliquez ici afin d'accéder à la gestion de votre VOD/AOD sur le Manager Infomaniak (besoin d'aide ?).
2. Cliquez directement sur le nom attribué au produit concerné:
   
3. Cliquez sur Médias dans le menu latéral gauche.
4. Cliquez sur Gestion des médias dans le menu latéral gauche.
5. Cliquez sur l'icône afin de créer un Nouveau dossier:
   
6. Donnez un nom au dossier.
7. Cliquez sur le bouton bleu pour Créer le dossier.
8. Cliquez sur Configuration:
   
9. Cliquez sur l'onglet Restrictions.
10. Désactivez si nécessaire le bouton à bascule (toggle switch) pour retirer l'héritage du dossier parent, ceci afin de pouvoir configurer vos propres règles sur ce dossier spécifique.
11. Activez le bouton à bascule (toggle switch) pour configurer la restriction par clé unique.
12. Cliquez sur Enregistrer une fois les différentes options souhaitées configurées:
    

1. Créer un token API VOD

Pour avoir accès à l'API VOD, vous devez en premier lieu vous authentifier grâce à un token (à ne faire qu'une seule fois - il sera commun pour l'ensemble des dossiers que vous souhaitez protéger) ; prenez connaissance de cet autre guide puis de la documentation https://developer.infomaniak.com/getting-started#authentication.

2. Créer le token de playback

Cette étape sera à faire sur votre site internet/application et ce token devra être unique, donc généré pour chaque visiteur.

Il est donc important que la page qui aura pour rôle la génération de token ne possède pas de cache, afin de garantir l’unicité du token.

POST  https://api.vod2.infomaniak.com/api/pub/v1/channel/channel_id/share/share_id/token

channel_id = 1227
share_id = correspond à l'identifiant de votre vidéo
Exemple: https://api.vod2.infomaniak.com/res/embed/1jhvl2uqa5rdf.html

La liste des paramètres est disponible dans la documentation https://developer.infomaniak.com/docs/api/post/channel/share/token

3. Utilisation du token unique sur un media

Le token récupéré au point 2 ci-dessus sera ainsi passé en paramètre au media, il sera unique donc différent pour chaque visiteur:

<iframe frameborder="0" width="720" height="360"  src="https://api.vod2.infomaniak.com/res/embed/1jhvl2uqa5rdf.html?token=st=1637143497~exp=1637143797~acl=/hls/1jhvl2uq4dnra/1jhvl2uq4dnmd/*~hmac=914aa838bdba141ec85db74266b54278572a1353a49e8851e4fd096dc6372127" allowfullscreen></iframe>

Ce guide explique comment ajouter un utilisateur à une Organisation présente dans le Manager Infomaniak. Vous pourrez ainsi autoriser cet utilisateur à accéder selon vos besoins à certains de vos produits Infomaniak.

Préambule

• Depuis que vous avez ouvert votre compte auprès d'Infomaniak, vous faites partie au moins d'une Organisation.
  • Si vous étiez seul et qu'il ne s'agissait pas d'une invitation, une Organisation a été créée à votre nom et vous en devenez automatiquement le responsable légal.
  • Sinon vous appartenez à l'Organisation qui vous a invité (à rejoindre sa kSuite, à gérer un produit, etc.).
• Vous pouvez définir si un utilisateur…
  • … fait partie de votre Organisation et s'il doit devenir:
    • Responsable légal
    • Administrateur
    • Collaborateur
  • … est externe à votre Organisation (droits limités):
    • Les utilisateurs externes ne sont pas pris en compte dans les partages des calendriers et carnets d'adresses à toute l'Organisation.

Inviter le nouvel utilisateur

Prérequis

• Basculer au préalable vers l'Organisation souhaitée si vous ne retrouvez pas la liste d'utilisateurs attendue.
• Etre Administrateur ou Responsable légal‍ au sein de l'Organisation.
• Prendre connaissance des différentes permissions (droit d'accès aux produits par exemple) et préférences de contact administratif d'un utilisateur au sein d'une Organisation.

Pour ajouter, et si nécessaire, créer le nouvel utilisateur de votre Organisation:

1. Cliquez ici afin d'accéder à la gestion des utilisateurs sur le Manager Infomaniak (besoin d'aide ?).
2. Cliquez sur le bouton Ajouter un utilisateur:
   
3. Suivez l'assistant afin de terminer la procédure :
   • Si l'utilisateur ajouté ne possède pas encore un compte utilisateur chez Infomaniak, il sera invité à en créer un.
   • Si l'utilisateur ajouté possède déjà un compte Infomaniak, il sera invité puis il pourra basculer de son Organisation d'origine vers la nouvelle.

Ce guide concerne les utilisateurs qui font des modifications autour d'un hébergement sur lequel est installé WordPress.

Préambule

• Suite à un changement d'offre de votre hébergement Web (migration de l'ancienne formule d'hébergement v1 60 Go vers les offres actuelles) il est possible que vous deviez mettre à jour la connexion entre la base de données MySQL/MariaDB et votre site WordPress (afin d'éviter l'erreur "error establishing a database connection" par exemple) et rétablir ainsi le lien entre WordPress et la base de données MySQL/MariaDB.

Modifier les éléments importants

Voici les informations à adapter dans le fichier wp-config.php pour que votre site WordPress fonctionne (en règle générale, un préfixe a simplement été ajouté devant le nom existant de la base et le nom d'utilisateur):

1. le nom de la base de données MySQL (bddname avant, abcd_bddname après par exemple)
2. le serveur hôte de la base de données MySQL (mysql.domain.xyz avant, abcd.myd.infomaniak.com après par exemple)
3. le nom d'utilisateur qui accède à la base de données MySQL (userbdd avant, abcd_userbdd après par exemple)

Modifier le fichier wp-config.php de WordPress

Pour cela:

1. Retrouvez et conservez vos informations MySQL actuelles selon la liste ci-dessus.
2. Créez un compte FTP.
3. Connectez-vous en FTP.
4. Editez le fichier wp-config.php qui se trouve dans le dossier racine de votre site WordPress.
5. Trouvez le paragraphe concerné et mettre à jour les 3 informations (selon la liste ci-dessus).
6. Sauvegardez le fichier et c'est tout, votre WordPress se connectera désormais à la base de données correcte!