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.
L’app est compatible avec Nextcloud 30 à 33.
Ce que ça fait
Section intitulée « 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.
- Vos salles apparaissent dans la recherche globale de Nextcloud.
- 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
Section intitulée « Comment ça marche »Quand un utilisateur ouvre une réunion, l’app Nextcloud :
-
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 ; -
forge un jeton de rôle signé (modérateur pour le créateur) ;
-
embarque la page native du client Vuisio (
/room/<id>?...) dans une iframe, à l’intérieur de Nextcloud.
Prérequis côté serveur Vuisio
Section intitulée « 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 :
-
Le secret de signature des rôles est généré par l’installeur. Récupérez sa valeur avec :
Fenêtre de terminal vuisio secrets show --reveal VUISIO_ROLE_SIGNING_SECRET -
Le jeton de l’API est lui aussi généré par l’installeur et conservé dans le coffre des secrets. Récupérez sa valeur avec :
Fenêtre de terminal vuisio secrets show --reveal VUISIO_ROOM_API_TOKEN -
L’origine du Nextcloud se déclare dans
VUISIO_EMBED_ANCESTORS. Le plus simple est de repasser parvuisio reconfigure(qui redemande cette valeur), puis de redémarrer.
Installer l’app côté Nextcloud
Section intitulée « Installer l’app côté Nextcloud »- Connectez-vous à Nextcloud avec un compte administrateur.
- Ouvrez Applications (menu du compte, en haut à droite).
- Recherchez « Vuisio » (ou ouvrez directement la fiche de l’app sur l’App Store).
- Cliquez sur Installer, puis Activer si nécessaire.
-
Téléchargez l’archive de l’app (
integration_vuisio). -
Décompressez-la dans le répertoire
apps/de votre Nextcloud. -
Activez l’app depuis Applications, ou avec :
Fenêtre de terminal sudo -u www-data php occ app:enable integration_vuisio
Configurer l’app
Section intitulée « Configurer l’app »Ouvrez Paramètres → Administration → Vuisio et renseignez :
| Champ | Valeur |
|---|---|
| URL du serveur (Server URL) | L’URL publique de votre serveur Vuisio (par exemple https://meet.example.org). |
| Jeton d’API des salles (Room API token) | La valeur de VUISIO_ROOM_API_TOKEN. |
| Secret de signature des rôles (Role signing secret) | La valeur de VUISIO_ROLE_SIGNING_SECRET. |
| URL interne (Internal URL, facultatif) | Seulement si Nextcloud joint le serveur Vuisio par une adresse réseau interne, différente de l’URL navigateur. |
Utilisation
Section intitulée « Utilisation »- Ouvrez l’app Vuisio dans Nextcloud (section « Réunions »).
- Créez une salle : vous en devenez le modérateur.
- Partagez le lien de la salle avec les participants : un lien court, de
la forme
…/apps/integration_vuisio/r/Kp7xQ2mZ3a. - Rejoignez : la visioconférence s’affiche directement dans Nextcloud.
Dans les conversations Talk
Section intitulée « 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.
- Dans le champ de message, tapez
/puis choisissez Réunion Vuisio. - Donnez un nom à la réunion, puis validez avec Créer et partager.
- 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.
Dans l’Agenda
Section intitulée « Dans l’Agenda »Une réunion Vuisio s’ajoute à un événement de l’Agenda Nextcloud, et son lien part avec l’invitation envoyée aux participants.
- Créez ou ouvrez un événement, puis cliquez sur le logo Vuisio à côté du lieu (ou sur Ajouter une réunion Vuisio dans l’éditeur complet).
- Le lieu devient « Réunion Vuisio » et le lien de la salle s’ajoute à la description.
- Ajoutez vos participants et enregistrez : l’invitation qu’ils reçoivent contient le lien, une seule fois.
Le même lien sert à tout le monde. L’organisateur, connecté à Nextcloud, entre en modérateur ; les autres saisissent leur nom. La salle porte le titre de l’événement et le suit s’il change, tant qu’elle n’a pas été renommée à la main depuis la page Réunions.
Depuis un autre agenda (Thunderbird, téléphone), écrivez simplement Vuisio dans le lieu : à l’enregistrement, la salle est créée et son lien ajouté à l’événement et à l’invitation.
Dépannage
Section intitulée « 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. |