Intégration Nextcloud

L’app Vuisio pour Nextcloud (identifiant integration_vuisio) embarque une salle de visioconférence Vuisio directement dans Nextcloud. Vos utilisateurs créent et rejoignent des réunions sans quitter leur Nextcloud, avec leur identité Nextcloud.

Périmètre

L’app est publiée sous licence libre (AGPL), au même titre que le cœur de Vuisio. Cette page en décrit l’installation et la configuration.

Ce que ça fait

• Créer et rejoindre des visioconférences Vuisio depuis Nextcloud, sans rien installer d’autre côté navigateur.
• Le participant arrive avec son identité Nextcloud (son nom affiché).
• Le créateur de la salle en est le modérateur ; les personnes qui rejoignent ensuite par le lien partagé y entrent comme participants.
• Dans les conversations Talk, une réunion s’insère sous forme de carte (nom, nombre de participants en direct, bouton pour rejoindre).
• Aucun média ne transite par Nextcloud : la visioconférence se déroule en direct avec le serveur Vuisio.
• L’interface suit la langue de chaque utilisateur dans Nextcloud (français fourni, anglais par défaut pour les autres langues).

Comment ça marche

Quand un utilisateur ouvre une réunion, l’app Nextcloud :

1. appelle l’API du serveur Vuisio (POST /api/rooms, authentifiée par un jeton bearer) pour créer la salle et récupérer son code d’invitation ;

2. forge un jeton de rôle signé (modérateur pour le créateur) ;

3. embarque la page native du client Vuisio (/room/<id>?...) dans une iframe, à l’intérieur de Nextcloud.

Prérequis côté serveur Vuisio

Trois réglages sont nécessaires sur l’instance Vuisio.

Réglage	Rôle
VUISIO_ROOM_API_TOKEN	Active l’API de création de salle et authentifie l’app (jeton bearer). Sans lui, l’API reste désactivée.
VUISIO_ROLE_SIGNING_SECRET	Scelle les rôles côté SFU (HMAC) : le rôle de modérateur ne peut pas être usurpé en modifiant l’URL. Doit être identique des deux côtés.
VUISIO_EMBED_ANCESTORS	Origines autorisées à embarquer le client dans une iframe. Ajoutez-y l’origine de votre Nextcloud (par exemple https://cloud.example.org).

Pour les mettre en place :

1. Le secret de signature des rôles est généré par l’installeur. Récupérez sa valeur avec :

   vuisio secrets show --reveal VUISIO_ROLE_SIGNING_SECRET

2. Le jeton de l’API n’est pas généré automatiquement : choisissez un jeton fort, ajoutez-le à la configuration de l’instance (VUISIO_ROOM_API_TOKEN dans le fichier .env du répertoire d’installation), puis appliquez avec vuisio restart.

   openssl rand -base64 32

3. L’origine du Nextcloud se déclare dans VUISIO_EMBED_ANCESTORS. Le plus simple est de repasser par vuisio reconfigure (qui redemande cette valeur), puis de redémarrer.

HTTPS obligatoire

Le serveur Vuisio doit être joignable en HTTPS, avec un certificat TLS valide et une URL publique. Un navigateur refuse d’embarquer dans une iframe une page servie en HTTP ou avec un certificat invalide, et l’app a besoin d’une URL publique pour construire le lien de la salle.

Installer l’app côté Nextcloud

Depuis l'App Store

1. Connectez-vous à Nextcloud avec un compte administrateur.
2. Ouvrez Applications (menu du compte, en haut à droite).
3. Recherchez « Vuisio » (ou ouvrez directement la fiche de l’app sur l’App Store).
4. Cliquez sur Installer, puis Activer si nécessaire.

Depuis une archive

1. Téléchargez l’archive de l’app (integration_vuisio).

2. Décompressez-la dans le répertoire apps/ de votre Nextcloud.

3. Activez l’app depuis Applications, ou avec :

   sudo -u www-data php occ app:enable integration_vuisio

Configurer l’app

Ouvrez Paramètres → Administration → Vuisio et renseignez :

Champ	Valeur
Server URL	L’URL publique de votre serveur Vuisio (par exemple https://meet.example.org).
Room API token	La valeur de VUISIO_ROOM_API_TOKEN.
Role signing secret	La valeur de VUISIO_ROLE_SIGNING_SECRET.
URL interne (optionnel)	Seulement si Nextcloud joint le serveur Vuisio par une adresse réseau interne, différente de l’URL navigateur.

URL interne

Renseignez l’URL interne uniquement lorsque le serveur Nextcloud et le serveur Vuisio se parlent par un réseau privé. Dans ce cas, l’appel serveur à serveur (POST /api/rooms) emprunte cette adresse interne, tandis que l’iframe du navigateur utilise l’URL publique du champ Server URL.

Utilisation

1. Ouvrez l’app Vuisio dans Nextcloud (section « Réunions »).
2. Créez une salle : vous en devenez le modérateur.
3. Partagez le lien de la salle avec les participants.
4. Rejoignez : la visioconférence s’affiche directement dans Nextcloud.

Dans les conversations Talk

L’app s’intègre aussi à Nextcloud Talk : depuis une conversation, on insère une réunion Vuisio sous forme de carte, sans quitter le fil de discussion.

1. Dans le champ de message, tapez / puis choisissez Réunion Vuisio.
2. Donnez un nom à la réunion, puis validez avec Créer et partager.
3. Une carte apparaît dans la conversation : nom de la réunion, nombre de participants en direct et bouton Rejoindre.

Vous pouvez aussi coller le lien d’une salle Vuisio existante dans un message : il s’affiche automatiquement sous forme de carte.

Note

La carte n’embarque pas la salle dans la conversation : elle sert à créer, partager et rejoindre la réunion, et son compteur de participants se met à jour tout seul. Aucun réglage supplémentaire n’est nécessaire : elle réutilise la configuration de l’app.

Dépannage

Symptôme	À vérifier
L’iframe reste vide	L’origine de votre Nextcloud est bien dans VUISIO_EMBED_ANCESTORS, et le serveur Vuisio répond en HTTPS avec un certificat valide.
Erreur 502 au moment de rejoindre	La valeur de VUISIO_ROOM_API_TOKEN est identique côté serveur et côté app, et Nextcloud atteint bien le serveur Vuisio (renseignez l’URL interne si l’accès passe par un réseau privé).
La carte Talk affiche toujours « En attente de participants »	Le compteur en direct passe par la même API que la création de salle : vérifiez que VUISIO_ROOM_API_TOKEN est bien renseigné côté app et que Nextcloud atteint le serveur Vuisio.