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

Préambule

• L'utilisation d'un serveur SMTP authentifié pour l'envoi d'e-mails à partir de vos applicatifs présente de nombreux avantages par rapport à la fonction PHP mail() standard non authentifiée :
  • une sécurité renforcée,
  • une meilleure fiabilité de livraison,
  • une gestion d'erreurs plus précise,
  • une compatibilité optimale avec les serveurs de messagerie tiers,
  • et une traçabilité complète des envois.
• Paramètres recommandés:
  • Serveur SMTP sortant = mail.infomaniak.com
  • Port SMTP & protocole de chiffrement et commande/méthode pour activer ce protocole: 587 + STARTTLS
  • Nom d'utilisateur/username = l'adresse mail complète & entière (besoin d'aide ?)
  • Mot de passe/password = celui généré pour l'adresse mail que vous voulez consulter (besoin d'aide ?)
  • Authentification obligatoire pour l'envoi des e-mails:
    • Elle s'active dans les paramètres SMTP de votre CMS.
    • Cochez "utiliser les mêmes paramètres que le serveur entrant" ou selon les CMS, remettez un nom d'utilisateur (= adresse mail complète & entière) et le mot de passe généré.

Exemples de configuration SMTP…

Prérequis

• Posséder un service de messagerie.
  • Vous avez la possibilité d'utiliser le Service Mail proposé par Infomaniak ou tout autre service de messagerie à votre convenance.

Lorsque vous possédez une adresse mail dont le domaine est rattaché à votre site Web (e-mail@domain-site.xyz par exemple) renseignez ses détails afin de l'utiliser pour les envois depuis serveur Web via SMTP:

… sur WordPress

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

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

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

… sur Prestashop

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

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

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

… sur Joomla

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

Ce guide explique comment gérer un calendrier et ses évènements au sein de l'app mobile Google Agenda (application pour smartphone ou tablette iOS / Android) et/ou l'app Web Calendar Infomaniak (service en ligne ksuite.infomaniak.com/calendar) en gardant toutes les données entièrement synchronisées grâce à l'app mobile Infomaniak kSync (application pour smartphone ou tablette Android).

Préambule

• Prenez connaissance de cet autre guide si vous ne souhaitez que faire figurer un calendrier Infomaniak en lecture seule sur Google Agenda (app Web & mobile).
  • L'inverse est également possible si vous ne souhaitez que faire figurer un calendrier Google en lecture seule sur l'app Web Calendar Infomaniak (service en ligne ksuite.infomaniak.com/calendar).
• La procédure ci-dessous permet d'éditer les évènements du calendrier des 2 côtés mais uniquement sur la version mobile de l'app Google Agenda.

Synchroniser le calendrier Infomaniak et l'appareil mobile

Prérequis

1. Télécharger l'app mobile Android Google Agenda.
2. Télécharger l'app mobile Infomaniak kSync (application pour smartphone ou tablette Android) ici:
   
   
    
   • L'application kSync est également disponible sur F-droid.
3. Installer kSync.

Ensuite, lancez l'app kSync sur votre appareil Android, un assistant étape par étape vous aidera à configurer l'application selon vos besoins:

1. Décidez si vous souhaitez synchroniser les tâches.
2. Autorisez kSync à accéder aux éléments requis sur l'appareil, le calendrier principalement.
3. Autorisez l'application à fonctionner en arrière-plan pour une meilleure synchronisation (utilise davantage la batterie) ; les réglages sont également possibles au niveau de l'app elle-même:
   
4. L'essentiel est d'accorder les droits d'accès aux services que vous devez synchroniser:
   
5. Revenez sur l'app kSync et continuez la configuration:
   
6. Appuyez pour ajouter un compte utilisateur Infomaniak (celui avec lequel vous vous connectez à vos services Infomaniak):
   
   1. Par exemple, sur l'app Web Calendar, le menu utilisateur en haut à droite vous informe de l'e-mail de connexion employé.
   2. Il est alors possible d'accéder aux calendriers de l'Organisation à laquelle est rattachée l'utilisateur en cours:
      
   3. Ce sont ces données qui vont être synchronisées sur votre appareil lorsque vous vous connecterez au même compte Infomaniak sur kSync…
7. Entrez vos identifiants de connexion Infomaniak (cf point a ci-dessus).
8. Appuyez sur le bouton pour vous connecter:
   
9. Effectuez les étapes de double authentification comme lors de vos connexions habituelles.
10. Une fois connecté sur kSync, activez les calendriers (parmi ceux qui s'affichent, qui sont ceux liés à votre compte Infomaniak) à synchroniser depuis l'onglet CALDAV:
    
11. Lancez la synchronisation avec le bouton situé en bas à droite.
    • En savoir plus sur la configuration de kSync

Synchronisation automatique du calendrier natif

• A ce stade, c'est l'application native de votre appareil Android (Samsung Calendar par exemple sur les appareils de marque Samsung) qui sera synchronisée et affichera les évènements de votre calendrier Infomaniak (il faut parfois activer le compte sur l'application en question):
  
• Un évènement ajouté et/ou modifié sur l'une ou l'autre des interfaces sera automatiquement synchronisé partout:
  

Activer le calendrier sur Google Agenda

Pour retrouver votre calendrier Infomaniak sur Google Agenda et pouvoir éditer ses évènements:

1. Ouvrez Google Agenda sur votre appareil Android.
2. Appuyez sur le bouton de menu à trois lignes horizontales ☰ en haut à gauche de l'interface:
   
3. Appuyez sur Paramètres en bas du menu:
   
4. Appuyez sur Gérer les comptes:
   
5. Activez le compte correspondant à votre calendrier Infomaniak:
   
6. Revenez à la page précédente et vérifiez que le calendrier Infomaniak apparaisse bien parmi les comptes et modifiez la couleur si nécessaire:
   
7. C'est terminé, Google Agenda est synchronisé avec le calendrier Infomaniak, un évènement ajouté et/ou modifié sur l'une ou l'autre des interfaces sera automatiquement synchronisé partout:
   

Ce guide explique comment ajouter un utilisateur totalement externe à kChat.

Préambule

• Un administrateur kChat peut inviter un utilisateur totalement externe à votre Organisation qui ne sera pas comptabilisé comme un utilisateur.
• Ce dernier sera toutefois invité à créer un compte Infomaniak s'il n'en possède pas déjà un.
• Pour ajouter un utilisateur kChat et lui donner davantage de droits (il sera comptabilisé comme un utilisateur kSuite), prenez connaissance de cet autre guide.

Inviter un utilisateur à discuter dans un canal privé

Prérequis

• Etre administrateur kChat:
  
  • Peu importe le rôle dans l'Organisation ; être administrateur de l'Organisation dans laquelle il y a la kSuite (et donc kChat) n'est pas obligatoire, et ne suffit de toute façon pas:
    

Ensuite, pour envoyer une invitation par mail depuis kChat :

1. Cliquez ici‍ afin d'accéder à l'app Web kChat (service en ligne ksuite.infomaniak.com/kchat) ou ouvrez l'app desktop kChat (application de bureau sur macOS / Windows / Linux).
2. Cliquez sur le bouton pour Inviter des membres:
   
3. Spécifiez l'adresse mail de la personne à inviter.
4. Cliquez sur son adresse mail pour l'ajouter en tant qu'invité:
   
5. Spécifiez le ou les canaux auxquels ces personnes pourront accéder.
6. Cliquez sur le bouton bleu pour envoyer l'invitation:
   
7. La personne invitée reçoit un mail avec un lien conduisant vers l'interface kChat et le canal partagé avec lui :
   
8. Évidemment, il y a une phase d'inscription si l'utilisateur ne possède pas encore de compte Infomaniak (pendant ce temps, l'utilisateur invité est listé en attente sur le canal kChat en question):
   
   • À noter qu'il ne sera pas listé en attente au sein de kSuite ou ailleurs car il s'agit d'un utilisateur restreint et externe ; et tant qu'il n'a pas été au bout de son inscription, le quota reste de 0 utilisateur externe:
     
9. Une fois l'inscription terminée, l'invité peut accéder à kChat, une version restreinte et limitée aux canaux spécifiés par l'administrateur lors de la création de l'invitation:
   
10. Il peut commencer une conversation privée avec les autres utilisateurs:
    
    • Côté compte administrateur, une fois l'inscription de l'utilisateur externe aboutie, vous obtenez la mention d'1 utilisateur externe sur votre tableau de bord:
      
    • Et désormais vous avez bien l'indication sur kChat que l'utilisateur accède à votre canal privé :
      

Permissions de l'utilisateur invité

Les invités peuvent…

• … épingler des messages à des canaux
• … utiliser des "slash commands" (à l'exception des commandes restreintes telles que l'invitation de membres, le renommage de canaux, la modification des en‑têtes, etc.)
• … mettre un canal en favori
• … rendre silencieux un canal
• … mettre à jour leur profil
• … utiliser des méthodes d'authentification différentes de celles des autres utilisateurs
• … utiliser l'application kChat : l'invité peut ouvrir l'app (Web, mobile ou desktop) qu'il soit déjà membre d'un kChat ou non ; ce principe de fonctionnement est différent avec kDrive par exemple.

Les invités ne peuvent pas…

• … découvrir des canaux publics
• … rejoindre des groupes ouverts
• … créer des messages directs ou des messages de groupe avec des membres qui ne font pas partie du même canal
• … inviter des personnes

En cas de problème

Si vous êtes administrateur de l'Organisation, mais que malgré tout vous ne parvenez pas à inviter un nouvel utilisateur sur kChat, vérifiez que vous soyez bien administrateur au sein de kChat, car il est tout à fait possible d'être simple utilisateur / collaborateur, même étant seul utilisateur avec license sur kSuite par exemple:

1. Cliquez ici afin d'accéder à la gestion des utilisateurs de l'Organisation sur le Manager Infomaniak (besoin d'aide ?).
2. Cliquez sur votre nom d'utilisateur:
   
3. Cliquez sur le chevron ‍ pour développer les outils collaboratifs kSuite:
   
4. Sous kChat, modifiez le rôle de utilisateur à administrateur:
   

Ce guide explique comment télécharger et utiliser l'app mobile Infomaniak kSync pour appareil Android (Samsung, Huawei, Google Pixel, etc.) qui permet de synchroniser les calendriers & contacts entre appareils Android (avec les données stockées chez Infomaniak).

Préambule

• Une fois l'application kSync configuré, les éléments choisis sont automatiquement synchronisés avec les applications Contacts et Agenda, installées par défaut sur un appareil Android.
• Possibilité d'afficher ou de masquer vos différents carnets et calendriers Infomaniak directement dans ces apps.
• Toute modification (ajout, édition, suppression) effectuée sur le téléphone est répercutée sur l'interface Infomaniak, et inversement.
• Les mises à jour des données s'effectuent en continu selon l'intervalle de synchronisation configuré.
• Prenez connaissance de cet autre guide pour un exemple d'utilisation de kSync: synchroniser un calendrier Infomaniak avec un agenda Google.

Configurer kSync

Prérequis

1. Télécharger l'app mobile Infomaniak kSync (application pour smartphone ou tablette Android) ici:
   
   
    
   • L'application kSync est également disponible sur F-droid.
2. Installer kSync.

Ensuite, lancez l'app kSync sur votre appareil Android, un assistant étape par étape vous aidera à configurer l'application selon vos besoins:

1. Décidez si vous souhaitez synchroniser les tâches.
2. Autorisez kSync à accéder aux éléments requis sur l'appareil, le calendrier principalement.
3. Autorisez l'application à fonctionner en arrière-plan pour une meilleure synchronisation (utilise davantage la batterie) ; les réglages sont également possibles au niveau de l'app elle-même:
   
4. L'essentiel est d'accorder les droits d'accès aux services que vous devez synchroniser:
   
5. Revenez sur l'app kSync et continuez la configuration:
   
6. Appuyez pour ajouter un compte utilisateur Infomaniak (celui avec lequel vous vous connectez à vos services Infomaniak):
   
   1. Par exemple, sur l'app Web Calendar, le menu utilisateur en haut à droite vous informe de l'e-mail de connexion employé.
   2. Il est alors possible d'accéder aux calendriers de l'Organisation à laquelle est rattachée l'utilisateur en cours:
      
   3. Ce sont ces données qui vont être synchronisées sur votre appareil lorsque vous vous connecterez au même compte Infomaniak sur kSync…
7. Entrez vos identifiants de connexion Infomaniak (cf point a ci-dessus).
8. Appuyez sur le bouton pour vous connecter:
   
9. Effectuez les étapes de double authentification comme lors de vos connexions habituelles.
10. Une fois connecté sur kSync, sous l'onglet Agendas CalDAV, choisissez le ou les calendriers qui devront s'afficher sur votre appareil.
11. Sous l'onglet Carnets d'adresses CardDAV, choisissez le ou les carnets d'adresses qui devront s'afficher sur votre appareil.
12. Lancez la synchronisation avec le bouton situé en bas à droite:
    

Paramètres de la synchronisation kSync

Cliquez sur l'icône Paramètres ‍ en haut à droite de l'interface afin de régler certains paramètres importants de kSync:

• Intervalle de synchronisation: vous avez la possibilité de modifier la fréquence des synchronisations (15, 30, 60 minutes, etc.) pour chaque type d'informations (carnets d'adresses, calendriers, tâches).
• Synchronisation seulement par Wifi (et si oui, avec quels réseaux...).
• Limite de l'affichage des évènements passés.
• Recevoir une notification pour chaque évènement ne comportant pas de rappel spécifique, avec un délai de notification défini en amont (en minutes).
• Affichage des couleurs d'évènements et synchronisation persistante des couleurs ou non.
• Affichage des groupes de contacts.
  

Vous pouvez également appuyer sur les carnets d'adresses ou calendrier pour paramétrer certains éléments:

• Il est possible de forcer la lecture seule via kSync ce qui signifie que les éléments sont synchronisés mais ne peuvent être modifiés par l'appareil.
• Vous pouvez également supprimer un calendrier ou un carnet (hors annuaire de l'Organisation):
  

Renommer/retirer le compte Infomaniak de kSync

Appuyez sur le menu d'action ⋮ situé à droite du compte concerné:

• Vous pouvez créer un nouveau carnet d'adresses ou un calendrier.
• Vous pouvez renommer ou supprimer le compte lié à kSync:
  

Paramètres généraux de l'app kSync

Appuyez sur la flèche de retour en haut à gauche de l'écran pour revenir à la page d'accueil.

• Appuyez ensuite sur le bouton de menu à trois lignes horizontales ☰ puis sur l'élément de menu “Paramètres”:
  

Ce guide explique comment connecter l'app desktop New Outlook (application de bureau sur Windows, remplaçante de Windows Mail) à une adresse mail hébergée chez Infomaniak.

Préambule

• Bien que les e-mails eux-mêmes restent stockés sur le serveur Infomaniak, l'expérience dans New Outlook est très intégrée au cloud Microsoft:
  • Certaines informations de votre compte peuvent être utilisées par Microsoft pour une gestion centralisée et une meilleure expérience de synchronisation.
  • Si vous souhaitez avoir un contrôle total et local sur vos e-mails, envisagez d'utiliser des logiciels/clients de messagerie tiers (comme Thunderbird par exemple) qui permettent un stockage plus direct.

Ajouter l'adresse mail à l'application

Prérequis

• Créer l'adresse mail au sein de my kSuite ou d'un Service Mail / kSuite.
• Créer un mot de passe sur l'adresse mail pour l'appareil que vous allez configurer.
• Vérifiez que le Service Mail est configuré de façon optimale.

Pour configurer l'application de messagerie :

1. Ouvrez l'application.
2. Si nécessaire cliquez sur la route dentée en haut à droite (sinon passez à l'étape 4).
3. Cliquez sur Ajouter un compte:
   
4. Entrez l'adresse mail à rattacher.
5. Cliquez sur Continuer:
   
6. Entrez le mot de passe de l'adresse mail.
7. Cliquez sur le bouton Voir plus.
8. Vérifiez et complétez les informations manquantes:
   
9. Descendez avec l'ascenseur sur la page, puis vérifiez et complétez les informations manquantes.
10. Cliquez sur Continuer:
    
11. Prenez connaissance et passez les différentes fenêtres d'informations Microsoft:
    
12. Ca y est, votre adresse mail est désormais configurée dans l'application:
    

Paramètres recommandés

• Serveur IMAP entrant = mail.infomaniak.com
• Port IMAP = 993 (avec SSL)
• Serveur SMTP sortant = mail.infomaniak.com
• Port SMTP & protocole de chiffrement et commande/méthode pour activer ce protocole: 587 + STARTTLS
• Nom d'utilisateur/username = l'adresse mail complète & entière (besoin d'aide ?)
• Mot de passe/password = celui généré pour l'adresse mail que vous voulez consulter (il doit correspondre à des critères détaillés en bas de ce guide)
• Authentification obligatoire pour l'envoi des e-mails:
  • Elle s'active dans les paramètres SMTP de votre application.
  • Cochez "utiliser les mêmes paramètres que le serveur entrant" ou selon les logiciels/clients de messagerie, remettez un nom d'utilisateur (= adresse mail complète & entière) et le mot de passe généré.

Prenez connaissance de cet autre guide si vous recherchez des informations au sujet d'autres ports et protocoles de messagerie compatibles (SSL / TLS par exemple).

En cas de problème

Une solution qui semble fonctionner est la combinaison de ces 2 situations:

1. Etre connecté sur sa session Windows avec un compte Microsoft (pas uniquement un compte local).
2. Avoir ajouté l'adresse mail de connexion à Windows à cette version d'Outlook.

Créez également un nouveau mot de passe en le laissant se générer de façon aléatoire mais en vérifiant également qu'il rentre dans ces critères imposés par Microsoft:

Vérifiez que le Service Mail est configuré de façon optimale.

Les guides de dépannage vous aident à résoudre un éventuel problème:

• Prenez connaissance des solutions données dans cet autre guide au sujet de la messagerie en général.
• Cet autre guide concerne plus particulièrement Outlook.

… et si votre Outlook ne fonctionne plus depuis un changement de mot de passe mail, prenez connaissance de cet autre guide.

Ce guide explique comment mettre en place une politique DMARC pour votre messagerie hébergée par Infomaniak, élément devenu indispensable pour prévenir d'éventuels dysfonctionnements d'acheminement.

Préambule

• Le protocole DMARC (Domain-based Message Authentication, Reporting, and Conformance) renforce la sécurité de votre domaine en s'appuyant sur les vérifications SPF et DKIM.
• Il indique aux serveurs destinataires comment traiter les e-mails qui échouent à ces tests d'authenticité, avec trois politiques de protection (Aucune, Quarantaine, Reject) détaillées ci-dessous.
• En cas d'échec d'authentification, le destinataire peut vous renvoyer un rapport DMARC ; ces données sont essentielles pour identifier des erreurs de configuration ou stopper des tentatives de phishing utilisant votre nom de domaine.

Politique DMARC et pourcentage d'acceptation

Pour les ordres qu'il est possible de donner aux serveurs destinataires lorsqu'un message suspect est détecté, 3 politiques (p = policy) existent et peuvent être affinées avec un pourcentage (pct):

Aucune (none) : L'e-mail est délivré normalement (mode observation)

Avec "p=none", aucun e-mail n'est rejeté ou placé en quarantaine en fonction de la vérification DMARC. Cependant, le pourcentage de réception peut être utilisé pour collecter des données sur les e-mail non authentifiés, en indiquant combien de ces e-mail doivent être soumis à la politique DMARC. Par exemple "p=none; pct=10" signifie que 10% des e-mails non authentifiés seront soumis à la politique DMARC, tandis que les 90% restants seront acceptés.

Quarantaine (quarantine) : L'e-mail est envoyé dans les envois indésirables

Avec "p=quarantine", les e-mails non authentifiés peuvent être placés en quarantaine, mais le pourcentage de réception détermine la proportion réellement soumise à cette politique. Par exemple "p=quarantine; pct=50" signifie que 50% des e-mails non authentifiés seront placés en quarantaine, tandis que les 50% restants seront acceptés.

Rejet (reject) : L'e-mail est purement et simplement bloqué/effacé

Avec "p=reject", les e-mails non authentifiés sont rejetés. Le pourcentage de réception détermine la proportion des e-mails non authentifiés qui seront effectivement rejetés. Par exemple "p=reject; pct=20" signifie que 20% des e-mails non authentifiés seront rejetés, tandis que les 80% restants seront acceptés.

Créer un enregistrement DMARC

Il y a 2 façons de gérer le DMARC.

Si vous possédez un Service Mail auprès d'Infomaniak, le plus simple est de vous rendre sur l'outil de Sécurité globale afin de gérer votre politique de sécurité DMARC et les rapports:

Mais l'enregistrement DMARC étant un type d'enregistrement DNS, généralement de type TXT, vous pouvez également le gérer depuis la zone DNS du nom de domaine:

1. Cliquez ici afin d'accéder à la gestion de votre domaine sur le Manager Infomaniak (besoin d'aide ?).
2. Cliquez directement sur le nom attribué au domaine concerné.
3. Cliquez sur Zone DNS dans le menu latéral gauche.
4. Cliquez le bouton pour ajouter un enregistrement:
   
5. Cliquez sur le bouton radio DMARC pour ajouter un enregistrement.
6. Cliquez sur le bouton Suivant:
   
7. Laissez (ou ajoutez si nécessaire) la valeur _dmarc dans le champ Source.

8. Le champ Cible doit contenir les paramètres que vous souhaitez utiliser, séparés par des ; :

   Nom du Tag	But	Exemple
   v	Version du protocole	v=DMARC1
   pct	Pourcentage de messages soumis au filtrage	pct=20
   ruf	URI de rapport pour les rapports forensiques	ruf=mailto:authfail@domain.xyz
   rua	URI de rapport pour les rapports agrégés	rua=mailto:aggrep@domain.xyz
   p	Politique pour le domaine organisationnel	p=quarantine
   sp	Politique pour les sous-domaines du domaine organisationnel	sp=reject
   adkim	Mode d'alignement pour DKIM	adkim=s
   aspf	Mode d'alignement pour SPF	aspf=r

   ce qui peut donner par exemple v=DMARC1;p=reject;pct=100;rua=mailto:postmaster@dmarcdomain.com (source)

9. Laissez la valeur par défaut au niveau du TTL.
10. Cliquez sur le bouton Enregistrer:
    

Ce guide concerne le paramétrage de l'app mobile Infomaniak Mail (application pour smartphone ou tablette iOS / Android).

Accéder aux paramètres de l'application

Pour ouvrir les paramètres de l'app mobile Infomaniak Mail (application pour smartphone ou tablette iOS / Android) sur votre appareil:

1. Appuyez en haut à gauche de votre boite de réception:
   
2. Cliquez sur l'icône Paramètres ‍ en haut à droite du volet qui s'est ouvert:
   
3. Vous pouvez gérer les réglages depuis l'écran qui s'affiche:
   
    

a. Choix de la signature

Si vous avez plusieurs adresses mail rattachées à votre compte, appuyez sur l'adresse mail dont vous désirez changer la signature. Ensuite choisissez une autre signature parmi celles configurées.

Sur iOS, vous pouvez également gérer vos demandes d'accusés de lecture.

b. my kSuite uniquement

Permet d'avoir des renseignements sur la souscription actuelle. Exemple:

c. Verrouillage de l'application

Cette option vous permet de protéger l'application par une des méthodes de verrouillage de votre appareil, ce qui permet de rester connecté à la messagerie Infomaniak avec votre compte utilisateur mais d'empêcher l'accès à Infomaniak Mail par un tiers lorsque l'app n'est plus dans les applications ouvertes.

Si votre appareil possède un lecteur d'empreinte, vous pouvez utiliser cette méthode pour activer le verrou. Idem pour le Face ID sur iOS.

Lors de la réouverture de l'application, une authentification sera demandée.

d. Notifications sur l'appareil

Vous pouvez configurer les notifications pour chacune des adresses mail rattachées dans l'application.

e. Synchronisation des contacts & calendriers

Pour l'instant cette synchronisation est gérée de façon externe ; prenez connaissance de l'assistant https://config.infomaniak.com/.

f. Contenu externe

Cette rubrique permet de choisir s'il faut afficher automatiquement tout contenu externe présent au sein d'un e-mail entrant que vous lisez, ou si vous préférez le masquer et ne l'afficher que sur demande.

g. Avance automatique

Cette rubrique permet de choisir l'action qui doit être faite après l'archivage ou la suppression d'un e-mail: ouvrir le message suivant, ou le précédent, ou revenir à la liste des messages.

h. Densité de la liste de conversion

Le mode d'affichage peut être compact, normal, ou large.

i. Thème

Le thème permet de choisir un affichage type dark mode (sombre) ou à l'inverse, un affichage lumineux noir sur blanc. Cet affichage peut également être défini en fonction du thème de l'appareil (permettant ainsi de reprendre un éventuel réglage système qui ferait varier l'affichage en fonction de l'heure).

j. Couleur d'accentuation

La couleur d'accentuation est soit le bleu soit le rose.

k. Actions de balayage

Les actions de balayage permettent de définir quelle opération Infomaniak Mail doit effectuer si vous glissez votre doigt sur un message de la liste de droite à gauche ou de gauche à droite (y compris le “long swipe” sur iOS):

Les actions possibles sont:

• supprimer le message (il va dans la corbeille)
• archiver le message (il va dans un dossier d'archive)
• le rendre lu ou non lu
• déplacer le message (et dans ce cas la liste des dossiers s'affiche après un balayage)
• favoris (afin d'activer un suivi sur le message)
• signaler comme spam
• menu d'actions rapides (accessible également depuis la lecture du message et qui propose d'écrire une réponse, d'effectuer un transfert, une suppression, une impression, etc.)

et il est possible également de choisir "aucune" afin d'éviter des opérations qui ne seraient pas souhaitées si votre appareil n'est pas adapté au balayage:

l. Mode d'affichage des messages

Choisissez entre un affichage individuel des messages ou un mode “discussion” / “conversation”, mode qui permet de regrouper vos e-mails par sujets/expéditeurs, c'est-à-dire grouper les e-mails reçus en fonction du sujet de la discussion, ainsi l'affichage de la boite de réception est plus léger et le suivi des messages des différents intervenants de la conversation est plus facile à faire:

m. Gestion du compte

Permet de supprimer le compte Infomaniak (après confirmation de lecture de l'avertissement important). Prenez également connaissance de 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 modifier les coordonnées liées à un nom de domaine c'est-à-dire les coordonnées “WHOIS” du propriétaire / titulaire / responsable.

Préambule

• La particularité des noms de domaine est qu'ils ont tous un propriétaire dont les coordonnées sont propres au domaine lui-même, indépendantes du compte Infomaniak qui gère le produit.
• Ces coordonnées surnommées WHOIS indiquent des détails comme le prénom, nom, adresse postale, adresse mail, etc. et peuvent être consultées en ligne grâce aux services WHOIS tels que whois.infomaniak.com ou whois.nic.swiss.
• Des coordonnées supplémentaires privées sont souvent existantes hors WHOIS public et ne sont jamais visibles et/ou communiquées par Infomaniak sans authentification préalable !
• Ces coordonnées feront toujours foi en cas de litige au sujet de la titularité d'un nom de domaine, il est donc important de garder ces informations à jour même si vous activez Domain Privacy pour masquer des informations.

Accéder aux différents types de contacts liés aux noms de domaine

Afin d'accéder à ces coordonnées de gestionnaires de domaines :

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 Informations WHOIS dans le menu latéral gauche:
   

Contact Propriétaire

1. Cliquez sur le bouton Changer de propriétaire pour créer une nouvelle fiche contact, ou en choisir une précédemment utilisée sur l'un des autres noms de domaine de l'Organisation, avec la nécessité d'obtenir l'accord des deux parties avant application.
2. Cliquez sur le bouton Modifier pour éditer la langue (de certains envois) ainsi que les coordonnées postales et téléphoniques (un e-mail est envoyé sur l'adresse mail mentionnée pour une demande de confirmation des changements).

Détails plus bas dans ce guide.

Contact Administrateur

1. Cliquez sur le bouton Modifier pour éditer la langue (de certains envois) ainsi que les coordonnées postales et téléphoniques (un e-mail est envoyé sur l'adresse mail mentionnée pour une demande de confirmation des changements).
2. Cliquez sur Autre Contact pour créer une nouvelle fiche contact, ou en choisir une précédemment utilisée sur l'un des autres noms de domaine de l'Organisation, avec la nécessité d'obtenir l'accord des deux parties avant application.

Détails plus bas dans ce guide.

Contact Technique

1. Cliquez sur le bouton Modifier pour éditer la langue (de certains envois) ainsi que les coordonnées postales et téléphoniques (un e-mail est envoyé sur l'adresse mail mentionnée pour une demande de confirmation des changements).
2. Cliquez sur Autre Contact pour créer une nouvelle fiche contact, ou en choisir une précédemment utilisée sur l'un des autres noms de domaine de l'Organisation, avec la nécessité d'obtenir l'accord des deux parties avant application.

Détails plus bas dans ce guide.

Contact Facturation

1. Cliquez sur le bouton Modifier pour éditer la langue (de certains envois) ainsi que les coordonnées postales et téléphoniques (un e-mail est envoyé sur l'adresse mail mentionnée pour une demande de confirmation des changements).
2. Cliquez sur Autre Contact pour créer une nouvelle fiche contact, ou en choisir une précédemment utilisée sur l'un des autres noms de domaine de l'Organisation, avec la nécessité d'obtenir l'accord des deux parties avant application.

Détails plus bas dans ce guide.

Modifier des coordonnées WHOIS

Sans créer de nouvelle fiche contact, vous pouvez modifier:

• l'adresse postale (rue, code postal, pays, etc.)
• le numéro de téléphone
• la langue (de certains envois) 

En créant une nouvelle fiche contact, vous pourrez donc spécifier:

• Type de contact (Société, Individuel, Association, autre)
• Prénom / Nom
• l'adresse mail
• l'adresse postale (rue, code postal, pays, etc.)
• le numéro de téléphone
• la langue (de certains envois) 
   

Toute modification de coordonnées WHOIS devra être validée par le contact actuel. Ce dernier recevra un e-mail avec un lien de validation valable deux jours pour valider les changements:

L'e-mail indique également les autres noms de domaine concernés par l'opération (et quels types de contacts sont concernés par le changement).

En attendant la validation, un message est affiché sur la page de gestion du domaine:

En savoir plus

Vous pouvez également le faire sur plusieurs domaines à la fois : une fiche de contact peut être liée à plusieurs domaines ; la modification d'une fiche se répercutera donc automatiquement sur tous les domaines ayant le même contact WHOIS.

Prenez également connaissance des guides concernant des extensions spécifiques comme le .es ou le .se …

Ce guide pour l'app Web Mail Infomaniak (service en ligne ksuite.infomaniak.com/mail) ou l'app mobile Infomaniak Mail (application pour smartphone ou tablette iOS / Android) explique comment activer le chiffrement pour les e-mails envoyés depuis les services Web et mobile Infomaniak.

Préambule

• Lorsque le chiffrement est activé, les e-mails et pièces jointes sont chiffrés dès leur réception sur les serveurs Infomaniak, via les clés publiques des expéditeurs et destinataires.
  • Chaque adresse mail génère une clé à sa première utilisation, stockée de manière sécurisée dans les datacenters Infomaniak.
• Les clés reposent sur la cryptographie à courbes elliptiques (ECC) et utilisent le standard OpenPGP.
  • Elles sont elles-mêmes chiffrées en AES-256-GCM avec un déchiffrement automatique via l’authentification Infomaniak.
• Dans les résultats de recherche, seul l'objet des messages chiffrés sera visible, tandis que leur contenu restera sécurisé lors du stockage.

Activer le chiffrement des e-mails…

… depuis l'app Web Mail Infomaniak

Afin de chiffrer automatiquement un message envoyé à une adresses mail:

1. Cliquez ici afin d'accéder à l'app Web Mail Infomaniak (service en ligne ksuite.infomaniak.com/mail).
2. Rédigez un nouveau message comme à votre habitude.
3. Cliquez sur l'icône cadenas ‍à gauche du bouton Envoyer pour activer le chiffrement:
   
4. Validez l'action si une fenêtre de confirmation s'affiche.
5. L'icône représente désormais un cadenas fermé et la couleur de l'ensemble est modifiée:
   
6. Appuyez sur le bouton Envoyer.

L'action est à réaliser lors de chaque nouvel envoi.

A. Destinataire dont le mail est géré auprès d'Infomaniak

Si le destinataire du mail chiffré possède une adresse mail gérée auprès d'Infomaniak, le chiffrement se fait de manière totalement transparente pour l'expéditeur comme pour le destinataire. Une mention indiquera le chiffrement du message…

1. … dans la boite de réception du destinataire:
   
2. … à l'ouverture du message reçu:
   
3. … et dans le dossier des messages envoyés par l'expéditeur:
   

B. Destinataire externe

Si le destinataire du mail chiffré possède une adresse mail gérée en dehors des services Infomaniak, le chiffrement est toujours possible, mais il nécessite la définition d’un mot de passe:

1. Cliquez ici afin d'accéder à l'app Mail Infomaniak (service en ligne ksuite.infomaniak.com/mail).
2. Rédigez un nouveau message comme à votre habitude, mais adressé à une adresse mail hors Infomaniak.
3. Cliquez sur l'icône cadenas ‍à gauche du bouton Envoyer pour activer le chiffrement.
4. Une modale s'ouvre pour vous permettre de créer un mot de passe:
   
   • Entrez un mot de passe et copiez-le afin de le faire parvenir par vos propres moyens (kPaste par exemple) au destinataire (vous pouvez convenir d'un mot de passe à l'avance ainsi le destinataire sera déjà informé):
     
5. L'icône représente désormais un cadenas fermé sans puce orange et vous pouvez envoyer l'e-mail comme d'habitude:
   
6. Les destinataires recevront alors un message leur signalant qu’un mail chiffré les attend:
   
   1. En cliquant sur le bouton fourni, ils seront redirigés vers une page Web sécurisée où le mot de passe devra être saisi.
   2. Une fois le mot de passe validé, le message chiffré pourra être consulté sur cette même page valable 30 jours.

… depuis l'app mobile Infomaniak Mail

Afin de chiffrer automatiquement un message envoyé à une adresses mail:

1. Ouvrez l'app mobile Infomaniak Mail (application pour smartphone ou tablette iOS / Android).
2. Rédigez un nouveau message comme à votre habitude.
3. Appuyez sur l'icône cadenas ‍à bas de la fenêtre de rédaction pour activer le chiffrement:
   

A. Destinataire dont le mail est géré auprès d'Infomaniak

Si le destinataire du mail chiffré possède une adresse mail gérée auprès d'Infomaniak, le chiffrement se fait de manière totalement transparente pour l'expéditeur comme pour le destinataire:

1. Des cadenas fermés sont représentés à l'écran.
2. Appuyez sur l'icône d'envoi:
   

B. Destinataire externe

Si le destinataire du mail chiffré possède une adresse mail gérée en dehors des services Infomaniak, le chiffrement est toujours possible, mais il nécessite la définition d’un mot de passe:

1. . L'envoi ne sera pas possible car l'icône d'envoi restera grisée et des symboles apparaitront sur les cadenas:
   
2. Appuyez sur l'icône cadenas.
3. Une modale s'ouvre pour vous permettre de créer un mot de passe.
4. Laissez le mot de passe suggéré ou entrez un nouveau mot de passe et copiez-le afin de le faire parvenir par vos propres moyens (kPaste par exemple) au destinataire (vous pouvez convenir d'un mot de passe à l'avance ainsi le destinataire sera déjà informé).
5. Appuyez sur la croix en haut à gauche si vous avez terminé la gestion du mot de passe.
6. Ca y est, l'envoi peut désormais s'effectuer de façon chiffrée:
   

Ce guide vous aide à comprendre la structure de vos services Infomaniak, l'objectif étant de vous familiariser avec le vocabulaire utilisé et de vous aider à gérer facilement vos interfaces de gestion, principalement lors de l'utilisation de my kSuite.

Préambule

• L'Organisation est le terme qui représente le regroupement des services Infomaniak & utilisateurs (vous et éventuels collaborateurs, membres de la famille, etc.).
• Pour comprendre ce que représente réellement une Organisation, ce guide s'articule autour de plusieurs situations possibles actuellement:
  1. Toute nouvelle inscription pour une adresse gratuite my ksuite (ik.me / etik.com / ikmail.com).
  2. Toute nouvelle inscription pour d'autres services Infomaniak.
  3. Utilisation combinée de my kSuite et des autres services de l'écosystème:
     1. S'inscrire à my kSuite en spécifiant un compte Infomaniak existant
     2. Acquérir des produits Infomaniak en ayant qu'un compte my kSuite

1. Inscription my kSuite (ik.me / etik.com / ikmail.com)

A l'inscription sur welcome.infomaniak.com/signup/myksuite, vous avez choisi la dénomination de votre adresse mail, par exemple anna.a@ik.me puis avez renseigné un numéro de téléphone personnel:

1. Une fois l'inscription validée, vous accédez à votre adresse mail anna.a@ik.me sur l'app Web Mail ksuite.infomaniak.com/mail:
   
2. On peut distinguer:
   
   1. Le logo/type de votre Organisation qui, dans le cas présent, indique qu'il s'agit d'un compte my kSuite.
   2. Le bouton ‍ permet d'accéder au Manager manager.infomaniak.com et aux autres apps / autres services liés à my kSuite:
      
      • Le Manager dans ce cas ne contiendra rien de plus que des informations sur la gestion de votre compte my kSuite:
        
   3. Les initiales sont celles de votre compte Infomaniak (prénom / nom renseignés à l'inscription):
      

Ce compte my kSuite ne pourra pas directement contenir de produits d'hébergement, ou kSuite avec un nom de domaine, etc. La suite de ce guide vous explique comment créer une Organisation plus complète si nécessaire.

A noter qu'il n'est pas possible d'exporter vos services my kSuite vers une autre Organisation.

Pour utiliser votre nouvelle adresse mail my kSuite sur l'app Web Mail prenez connaissance de cet autre guide.

2. Inscription et achat d'hébergement, domaine, etc.

A l'inscription sur welcome.infomaniak.com/signup/, vous avez choisi votre identifiant de connexion, sous la forme d'une adresse mail personnelle, par exemple anna.alpha@orange.fr :

Vous avez ensuite choisi le type d'Organisation que vous souhaitiez créer (personnelle, ou pour une entreprise, association, etc.):

1. Une fois l'inscription validée, vous accédez au Manager manager.infomaniak.com et votre Organisation est encore une “coquille vide” dont vous êtes pour le moment le seul représentant légal:
   
2. On peut distinguer:
   
   1. Le logo/type de votre Organisation qui, dans le cas présent, indique qu'il s'agit d'une Organisation personnelle (nommée automatiquement à la création via le prénom/nom du créateur) ; cela se personnalise.
   2. Le bouton ‍ permet d'accéder à kSuite ksuite.infomaniak.com et aux autres apps / autres services liés à la kSuite gratuite ajoutée à votre nouvelle Organisation:
      
   3. Les initiales sont celles de votre compte Infomaniak (prénom / nom renseignés à l'inscription):
      

3. Utilisation combinée

Que se passe-t-il si vous vous inscrivez à my kSuite en indiquant un compte Infomaniak que vous possédez déjà pour l'utilisation de produits d'hébergement?

Ou comment procéder si vous souhaitez acquérir des produits d'hébergement lorsque vous n'avez qu'un compte my kSuite ?

S'inscrire à my kSuite en spécifiant un compte existant

A l'inscription sur welcome.infomaniak.com/signup/myksuite, vous choisisez de vous connecter avec un compte existant…

1. Evidemment, il ne faut pas renseigner un compte my kSuite (anna.a@ik.me  par exemple) en tant que compte existant, car vous ne pouvez pas avoir plusieurs adresses mail ik.me / etik.com / ikmail.com:
   
2. Renseignez votre compte d'Organisation existant, anna.alpha@orange.fr:
   
3. Ainsi la création d'un compte my kSuite vous est proposée:
   
4. Une fois l'inscription validée, vous accédez au Manager manager.infomaniak.com:
   1. votre Organisation précédente est visible…
   2. séparée de my kSuite actuellement sélectionnée:
      
5. Cliquez sur l'une ou l'autre des Organisations/my kSuite de ce menu (toujours accessible de façon permanente en haut à gauche) pour basculer de l'une à l'autre.

Acquérir des produits en ayant qu'un compte my kSuite

Autre situation: vous souhaitez acquérir sur www.infomaniak.com l'un des services proposés par Infomaniak, par exemple un nom de domaine pour votre futur site / messagerie:

1. Vous serez redirigé vers le Shop Infomaniak ; passez à l'étape suivante:
   
2. A l'étape où vous devez renseigner votre éventuel identifiant Infomaniak existant, vous entrez votre compte my kSuite existant (anna.alpha@ikmail.com dans cet exemple):
   
3. Votre identifiant existant est reconnu, vous devez vous authentifier:
   
4. Puis vous passerez forcément par l'étape de création d'Organisation ; choisissez le type d'Organisation que vous souhaitez créer (personnelle, ou pour une entreprise, association, etc.):
   
5. Pour finaliser l'achat, les coordonnées relatives à l'Organisation seront demandées pour la facturation (elles servent également à générer un titulaire pour le nom de domaine commandé) ; il ne vous reste plus qu'à terminer la commande:
   
6. Une fois la commande complétée, vous accédez au Manager manager.infomaniak.com:
   
   1. votre nouvelle Organisation est visible…
   2. séparée de my kSuite actuellement sélectionnée.
7. Cliquez sur la nouvelle Organisation pour basculer vers celle-ci et gérer vos produits commandés:
   
8. Pour basculer de l'une à l'autre des Organisations/my kSuite cliquez sur ce menu (toujours accessible de façon permanente en haut à gauche):
   1. Une première fois pour arriver sur la page principale du Manager,
   2. puis sur le chevron ‍ permettant le choix de la destination:
      
9. Vous retrouverez ainsi votre adresse mail my kSuite.

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