Ce guide explique comment protéger par mot de passe des vidéos importées sur un service VOD Infomaniak.

Préambule

• La lecture d'une vidéo au sein d'un Player configuré sur le service VOD demandera un mot de passe sans lequel le visionnage ne sera pas possible.
• Il n'est pas possible de spécifier plusieurs mots de passe différents pour la même vidéo.
• D'autres restrictions d'accès peuvent être activées et concernent l'accès au fichier: token | geoip

Protéger une vidéo par mot de passe

La protection par mot de passe peut être configurée de différentes façons.

1. Mot de passe au niveau du dossier d'importation

Si 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 mot de passe à leur lecture. Il est malgré tout possible de modifier la visibilité de chaque vidéo individuellement (lire plus bas).

Pour configurer ce dossier:

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 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. Choisissez les règles d'encodage pour les vidéos qui seront importées puis passez à l'étape suivante.
10. Configurez les options du dossier à l'étape 2 puis passez à l'étape suivante.
11. Définissez le mot de passe qui devra être entré pour voir une vidéo protégée:
    
12. Cliquez sur le bouton bleu une fois les différentes restrictions souhaitées configurées.
13. Téléversez des nouvelles vidéos dans ce dossier pour qu'elles soient protégées par mot de passe lors de leur lecture.

2. Mot de passe défini manuellement sur chaque vidéo

Pour modifier la visibilité d'une vidéo sur un service VOD:

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 Médias dans le menu latéral gauche.
4. Cliquez sur Gestion des médias dans le menu latéral gauche.
5. Cliquez sur la vidéo concernée:
   
6. Cliquez sur Modifier dans la partie Statut.
7. Cliquez sur Mot de passe pour définir un mot de passe.
8. Cliquez sur le bouton bleu pour Modifier le statut:
   
9. La vidéo devient protégée par mot de passe:
   

Ce guide concerne les jetons d'authentification ou tokens Infomaniak, qui servent à vérifier l'identité de l'application et à lui accorder des autorisations spécifiques pour interagir avec les fonctionnalités et les données de l'API Infomaniak de manière sécurisée.

Préambule

• Les jetons d'authentification ou tokens servent à vérifier l'identité de l'application et à lui accorder des autorisations spécifiques pour interagir avec les fonctionnalités et les données de l'API Infomaniak de manière sécurisée.
• Il n'y a pas de limite quant au nombre de token que vous pouvez créer.
• La durée dun token d'accès est "illimitée" par défaut mais il est possible de définir une durée personnalisée à sa création.
• Attention, si aucun appel n'est fait avec le token pendant une année, il est automatiquement désactivé ; il sera alors nécessaire d'en générer un nouveau.

Gérer les tokens API Infomaniak

Au moment de la création d'un token API, il vous sera possible de choisir l'application et le scope accessible par le token (afin de correspondre à votre besoin et projet actuel).

Pour cela:

1. Cliquez ici afin d'accéder à la gestion de votre produit sur le Manager Infomaniak (besoin d'aide ?).
2. Cliquez le bouton bleu Créer un token.
3. Choisissez dans le menu déroulant le produit adéquat selon votre besoin et projet actuel.
4. Choisissez une durée de validité.
5. Cliquez sur le bouton bleu Créer un token.
6. Entrez le mot de passe de connexion au Manager comme demandé.
7. Copiez le token en lieu sûr - il ne sera plus accessible après cela.

Exemple d'application: token pour l'API Newsletter

Ce guide explique comment ajouter des sous-titres sur les médias de votre espace VOD Infomaniak.

Préambule

• Les sous-titres de vos vidéos ne sont pas destructifs pour la vidéo elle-même ; celle-ci n'est pas altérée, il s'agit uniquement d'un fichier *.srt chargé par le Player.
• Vous pouvez gérer le démarrage automatique des sous-titres depuis le Player lui-même (onglet #1).

Gérer les sous-titres

Pour accéder à l'outil de création de sous-titres pour vos médias:

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 Médias dans le menu latéral gauche.
4. Cliquez sur Gestion des médias dans le menu latéral gauche.
5. Cliquez sur le média pour lequel des sous-titres doivent être générés.
6. Cliquez sur Modifier.
7. Cliquez sur l'onglet Sous-titres.
8. Cliquez sur le bouton Ajouter une langue pour choisir l'une des 3 méthodes de génération de sous-titrage:
   

A. Création de sous-titres de façon manuelle

Avec ce mode de sous-titrage, vous entrez manuellement chacun des textes qui devront s'afficher au timecode spécifié:

B. Importation d'un fichier de sous-titres

Vous pouvez importer un fichier de type SubRip (*.srt) ou SubViewer (*.sbv and *.sub) pour agrémenter votre vidéo avec les sous-titres préparés à l'avance dans un fichier séparé:

Le bouton à bascule (toggle switch) permet d'activer ou non la publication des sous-titres sur le Player ; cela permet notamment de pouvoir vérifier que le contenu est correct avant publication et partage de la vidéo.

C. Générer des sous-titres automatiquement

Vous pouvez créer des sous-titres directement à partir de l'audio disponible sur votre média. Les textes sont générés grâce à l'intelligence artificielle (IA, ou informatiquement ou équivalent).

Pour générer les sous-titres, cliquez sur le bouton Générer:

Traduire les sous-titres automatiquement

Lorsqu'un sous-titrage existe, vous pouvez ajouter une langue supplémentaire au même endroit, en faisant traduire le texte automatiquement (précisez la langue actuelle), ce qui va générer le sous-titrage adéquat dans la langue désirée:

Sous-titrer automatiquement les nouvelles vidéos

Le dossier Racine ou les sous-dossiers de votre espace VOD peuvent posséder des règles exécutées lors de tout nouvel ajout de média à l'intérieur de ceux-ci. L'une de ces règles donne l'ordre de générer automatiquement les sous-titres avec la méthode C ci-dessus. Pour mettre en place cette règle:

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 Médias dans le menu latéral gauche.
4. Cliquez sur Gestion des médias dans le menu latéral gauche.
5. Cliquez sur Configurer sur la page du dossier Racine ou du dossier de votre choix:
   
6. Cliquez sur l'onglet Traitement des médias.
7. Vérifiez que les traitements ne soient pas configurés pour être hérités du dossier Parent (ou configurez le dossier Parent directement) puis sauvegardez les changements si nécessaire (point 10 ci-dessous).
8. Activez la génération des textes.
9. Configurez ce qui doit être généré (sous-titres, titre de la vidéo, résumé/description, ainsi que les éventuelles traductions en fonction de la langue du visiteur).
10. Sauvegardez les modifications:
    

Ce guide explique comment modifier la vignette (miniature, ou thumbnail / poster) représentant une vidéo sur un service VOD.

Préambule

• L'utilisation de gif animés n'est pas possible.

Modifier la miniature vidéo

Afin d'accéder à un média de l'espace VOD :

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 Médias dans le menu latéral gauche.
4. Cliquez sur Gestion des médias dans le menu latéral gauche.
5. Cliquez sur le média que vous souhaitez remplacer dans le tableau qui s'affiche:
   
6. Cliquez sur le bouton Modifier:
   
    

Deux possibilités s'offrent à vous pour remplacer l'image par défaut de la vidéo à l'arrêt:

1. Sélectionnez une image au sein de la vidéo elle-même (cliquez pour faire défiler la vidéo et appuyez sur le bouton pour extraire l'image que vous pouvez ensuite recadrer/retailler):
   
2. Chargez une image depuis votre disque dur (10 Mo max.) que vous pouvez ensuite recadrer/retailler.

Validez en cliquant sur le bouton bleu Enregistrer:

Ce guide explique comment diffuser en direct une liste de vidéos du service VOD grâce au produit Streaming vidéo.

Préambule

• Cette fonctionnalité permet d’utiliser le service VOD pour créer une playlist de vidéos et d’utiliser ensuite le service Streaming vidéo pour la diffuser en vrai direct, p.ex dans le cadre d'une chaîne de clip musicaux, téléachat, documentaires, etc.
• Il est possible d’y glisser des publicités entre chaque vidéo, manuellement ou via l’utilisation de tag VAST.
• La playlist sera diffusée en boucle à l'infini jusqu’à ce que l’utilisateur la stoppe.

Diffuser une playlist VOD en live streaming

Prérequis

• Posséder un service VOD (au minimum l'espace VOD gratuit avec le service Streaming vidéo).
• Posséder un service Streaming vidéo dans la même Organisation et géré par le même compte.

Afin de constituer la playlist, importez quelques vidéos:

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 Sélectionner (dans la partie Importation rapide).

Une fois les vidéos importées:

1. Cliquez sur Médias dans le menu latéral gauche.
2. Cliquez sur Playlists / WebTV dans le menu latéral gauche.
3. Cliquez sur le bouton pour ajouter une nouvelle playlist.
4. Nommez la playlist et déterminer si celle-ci doit être automatique (liée à un dossier) ou manuelle.
5. Choisissez le dossier ou les vidéos précises à utiliser pour constituer la playlist.
6. Cliquez sur le bouton Créer un direct:
   
7. Choisissez le flux du service de Streaming vidéo qui devra diffuser la playlist et réglez vos préférences:
   

Quelques exemples d'utilisation

La diffusion d'une playlist peut servir comme solution de repli (fallback) dès qu'un live se coupe (volontairement ou involontairement) et dans ce cas prendre le relai à l'antenne. Dès que l’encodeur live repousse un flux, il reprend la main sur la playlist. Cela permet de diffuser un contenu alternatif s'il y a un problème sur le direct ou si l’utilisateur ne diffuse du vrai direct que le soir p.ex, il peut automatiser la diffusion de contenu issu de playlist le reste de la journée.

Il est également possible de programmer la diffusion d’une playlist depuis l’outil de planification du Streaming vidéo. Ainsi on peut choisir des plage de diffusion de playlist unique ou différentes à l’avance, ou de manière récurrente. L’encodeur diffusant en direct sera déconnecté automatiquement et ce pendant toute la durée de diffusion de la playlist ; une fois la plage horaire terminée, l’encodeur se reconnectera et son contenu sera diffusé. 

Ce guide explique comment intégrer dans le Player VOD/AOD qui sert à diffuser votre vidéo, un bouton en surimpression sur la vidéo sur lequel le spectateur pourra cliquer et ainsi partager facilement le lien de la vidéo (ou intégrer la vidéo elle-même).

Préambule

• Un partage automatique est prévu pour Facebook, X (anciennement Twitter), LinkedIn, WhatsApp, mais il est également possible de proposer un code html pour l'intégration du Player à l'emplacement souhaité par le visiteur.
• Un partage peut également être initié au sein de la bibliothèque de médias elle-même.

Ajouter un lien de partage sur le Player

Afin d'accéder à l'espace VOD :

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 Players dans le menu latéral gauche.
4. Cliquez sur l'objet concerné dans le tableau qui s'affiche.
5. Cliquez sur l'onglet Partager.
6. Activez l'un ou l'autre des partages avec les paramètres souhaités, pour voir, sur le Player, une icône représentant la possibilité de partage pour l'utilisateur:
   
   
    
7. N'oubliez pas de sauvegardez vos changements si nécessaire.

Ce guide explique comment obtenir et configurer des notifications en cas d'incident ou de dépassement de consommation de VOD/AOD.

Avertissements par mail

Pour configurer les notifications:

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 Notifications dans le menu latéral gauche.
5. Ajoutez les utilisateurs de l'Organisation devant être notifiés par mail.
6. Configurez les horaires de surveillance (jours de la semaine / heures).
7. Enregistrez les modifications:
   

Ce guide détaille certaines opérations effectuées en arrière-plan par le service VOD / AOD Infomaniak.

Fonctionnement des requêtes SOAP et des callbacks

Dans le service de VOD (vidéo à la demande) et AOD (audio à la demande), certaines opérations comme le téléchargement de fichiers passent par des requêtes SOAP, un protocole qui permet à deux systèmes de communiquer entre eux, souvent utilisé pour échanger des données entre serveurs.

Lorsqu’un fichier est demandé via SOAP, il peut y avoir un délai avant que le serveur réponde. Ce délai dépend de plusieurs facteurs, comme la taille du fichier, la charge du serveur ou encore la qualité de la connexion. Le téléchargement démarre dès que possible, mais il faut savoir qu’il y a une file d’attente : si plusieurs utilisateurs font des demandes en même temps, chacune est traitée dans l’ordre, et chaque utilisateur a une limite de téléchargements simultanés.

Callback : une notification à la fin du téléchargement

Un callback est un système qui permet de notifier le client (par exemple, votre application) une fois que le téléchargement est terminé. Autrement dit, au lieu d’attendre en surveillant le téléchargement, le système vous « appelle » ou vous envoie une réponse quand tout est prêt. C’est utile pour éviter de bloquer votre application pendant que le fichier se télécharge.

Cependant, il existe aussi un délai maximal d’attente, appelé timeout. Si ce délai est atteint avant la fin du téléchargement, une réponse est tout de même envoyée. Cela ne signifie pas que le téléchargement a échoué, mais que la réponse a été donnée avant qu’il soit terminé. Dans ce cas, le traitement continue en arrière-plan.

Les gros fichiers prennent plus de temps

Lorsque le fichier demandé est volumineux (par exemple, plusieurs centaines de mégaoctets ou même plusieurs gigaoctets), le téléchargement peut prendre plusieurs minutes. Ce temps dépend beaucoup du serveur distant : certains sont très rapides, d’autres moins. Le système essaie de gérer cela du mieux possible, mais il faut garder à l’esprit que le temps de réponse ne sera pas toujours immédiat.

Appels bloquants et non bloquants

Par défaut, certains clients SOAP attendent que le serveur ait fini de répondre avant de continuer. On parle alors d’un appel bloquant : votre application est figée jusqu’à ce que la réponse arrive. Cela peut poser problème si la réponse met du temps.

Heureusement, il est souvent possible de configurer le client SOAP pour qu’il ne bloque pas. On parle alors d’un appel non bloquant. Cela permet d’envoyer plusieurs requêtes les unes après les autres sans devoir attendre la réponse de chaque appel. C’est plus rapide et plus efficace, surtout quand vous traitez plusieurs fichiers à la suite.

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. Pour configurer ce dossier:

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 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. Choisissez les règles d'encodage pour les vidéos qui seront importées puis passez à l'étape suivante.
10. Configurez les options du dossier dans cette seconde étape puis passez à l'étape suivante.
11. Activez la restriction par clé unique.
12. Cliquez sur le bouton bleu une fois les différentes restrictions 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 application. Cette étape n'est à faire qu'une seule fois. Le token applicatif sera commun pour l'ensemble des dossiers que vous souhaiterez protéger. Pour créer ce token d'application, 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 intégrer sur des pages Web des fichiers vidéo / audio importés sur un service VOD / AOD Infomaniak.

Préambule

• Ce code d'intégration VOD / AOD est unique et correspond aux paramètres que vous êtes en train de spécifier sur la page.
• Il vous permet d'intégrer une même vidéo avec des configurations d'affichage différentes selon vos besoins.
• Par la suite, vous pourrez modifier les paramètres de cette intégration en les ajustant depuis la page d'historique des intégrations sur le Manager Infomaniak.
• Vous pouvez parallèlement partager un média de différentes manières.

Générer et copier le code d'intégration

Le code d'intégration se trouve sur votre interface VOD ; voici un exemple avec un Player par défaut:

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 Médias dans le menu latéral gauche.
4. Cliquez sur Gestion des médias dans le menu latéral gauche.
5. Cliquez sur le média concerné dans le tableau qui s'affiche.
6. Cliquez sur le bouton bleu Intégrer.
7. Cliquez sur Créer une intégration:
   
8. Personnalisez l'intégration du média (timestamp, lecture en boucle, démarrage automatique, …).
9. Cliquez sur le bouton pour Générer le code d'intégration:
   
10. Copiez le code pour l'intégrer à l'emplacement de votre choix:
    

Le média sera dans ce cas inséré avec le Player par défaut mais vous avez la possibilité de choisir parmi vos Players créés celui devant être proposé lors de l'intégration.

Modifier une précédente intégration

Pour personnaliser à nouveau l'intégration déjà effectuée de votre média, et dans le but de conserver le code correspondant sans devoir l'insérer à nouveau:

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 Médias dans le menu latéral gauche.
4. Cliquez sur Gestion des médias dans le menu latéral gauche.
5. Cliquez sur le média concerné dans le tableau qui s'affiche.
6. Cliquez sur le bouton bleu Intégrer.
7. Cliquez sur Modifier une intégration:
   
8. Cliquez sur le menu d'action ⋮ à droite de l'objet concerné dans le tableau qui s'affiche.
9. Cliquez sur l'élément désiré afin d'obtenir / modifier les codes d'intégration:
   

Coller le code d'intégration…

Sur la page Web de votre choix, collez le code à l'endroit désiré.

… sur Site Creator Infomaniak

• Pour Site Creator, il faut générer un code d'intégration “Fixe” (et non “Réactif”):
  
• Collez ensuite ce code sur Site Creator au sein d'un bloc “Code HTML personnalisé”.

• Voici un exemple de copier-coller depuis la page d'intégration d'un média: