Aller au contenu principal
Version: 5.6

Intégrer les visioconférences avec Zoom

BlueMind peut être connecté au système de conférence Zoom afin de proposer aux utilisateurs de facilement créer des conférences et les relier à leurs réunions d'agenda.

Installer et administrer Zoom​

Installer les paquets Zoom​

Pour mettre à disposition des utilisateurs les nouvelles fonctionnalités, installer sur le serveur les paquets suivants puis redémarrer BlueMind :

aptitude install bm-plugin-admin-console-videoconferencing-zoom bm-plugin-core-videoconferencing-zoom
bmctl restart

Configurer l'instance Zoom​

La configuration Zoom dans BlueMind passe nécessairement par une authentification OpenID. Cela nécessite une configuration depuis la console d'administration de Zoom afin de donner l’autorisation à BlueMind d'interroger le serveur Zoom pour l'authentification des utilisateurs nécessaire à l'accès aux visioconférences.

Droits requis

La configuration nécessite de disposer des droits d'administration de l'instance Zoom.

  • L'intégration enregistrée chez Zoom nécessite le Scope OpenID suivant : meeting:write
  • Les paramètres Redirect URL for OAuth et OAuth allow list doivent correspondre à l'URL https://<external-url-bluemind>/bm-openid/auth/videoconferencing-zoom.
  • Récupérer les deux paramètres suivants qui seront nécessaires pour la configuration de BlueMind (chapître ci-après) :
    • Application ID
    • Application Secret

Configurer l'authentification OpenID​

Se rendre dans la console d'administration BlueMind dans Gestion du système > Domaines supervisés > choisir le domaine souhaité > onglet OpenID :

Utiliser les valeurs suivantes pour renseigner les données d'authentification OpenID :

  • OpenID Endpoint URL : https://zoom.us/oauth/authorize
  • Application ID : fournie par Zoom, récupérée lors de la configuration de Zoom
  • Application secret : fourni par Zoom, récupéré lors de la configuration de Zoom
  • Token Endpoint URL : https://zoom.us/oauth/token

Configurer le serveur Zoom​

Afin d'activer la visioconférence pour les utilisateurs d'un domaine, paramétrer le patron d'invitation de la ressource associée.

Pour cela, se rendre dans la console d'administration > Gestion du système > Domaines supervisés > choisir le domaine souhaité > onglet Visioconférences :

  • Renseigner le patron d'invitation pour ajouter un texte d'accompagnement au lien d'accès à la visioconférence

    • Sélectionner la langue souhaitée dans la liste déroulante

      ℹ️ Multilingue

      Le contenu des langues est gardé en mémoire, il est possible de basculer de l'une à l'autre sans enregistrer entre chaque modification.
      Pour supprimer une langue, vider le champ de contenu (sélectionner le texte et le supprimer).

      Lors de la création d'un événement, le contenu sera ajouté à l'invitation en fonction de la langue de l'organisateur.

    • Remplir le contenu :

      Le patron peut contenir des variables, qui sont remplacées automatiquement dans le texte par le système :

      • ${NomRessource} : le nom de la ressource telle que définie dans l'annuaire
      • ${Organisateur} : le nom de la personne créant l'évènement dans le Calendrier
      • ${URL} : l'url d'accès à la conférence
      • ${siteURL} : URL propre à l'application

      Lorsqu'un utilisateur ajoute une visioconférence à son événement, le texte définit par le patron est automatiquement ajouté dans l'événement et dans l'e-mail d'invitation envoyé aux participants :

  • Cliquer sur Enregister

⇒ Une ressource nommée "Zoom" est automatiquement créée et ajoutée dans l'annuaire.

Pour que les utilisateurs puissent l'utliser, il faut leur attribuer les droits de partage sur la ressource. Pour plus d'informations sur les droits d'accès et l'utilisation de Zoom, consulter le paragraphe Accéder à la visioconférence

Dissocier le serveur Zoom​

Pour dissocier un serveur Zoom du domaine :

  • se rendre dans la Gestion du système > Domaines supervisés > choisir le domaine souhaité > onglet Visioconférence
  • cliquer sur le bouton "Supprimer la configuration Zoom"
  • valider la demande de confirmation
Prise en compte immédiate

Il est inutile de cliquer sur le bouton "Enregistrer" en bas de page, la demande est effective dès la confirmation.

⇒ La ressource associée est automatiquement supprimée et les partages nettoyés, elle n'apparaît plus dans la gestion des entités et les utilisateurs ne peuvent plus la réserver.

Accéder à la visioconférence​

Lorsqu'un utilisateur utilise pour la première fois la visioconférence Zoom, le protocole OpenID (voir ci-dessus) lui permet de s'authentifier auprès du serveur Zoom et BlueMind va récupérer une clé secrète l'autorisant à créer des visioconférences en son nom.

BlueMind n'a ainsi aucune connaissance des identifiants Zoom des utilisateurs.

Donner les droits aux utilisateurs​

L'accès à la nouvelle fonctionnalité se fait au moyen de la ressource Zoom créée lors de la configuration de BlueMind (voir ci-dessus) :

Cette ressource s'administre comme toute autre ressource, c'est la gestion des partages qui ouvre les droits à la réservation et, de fait, à la génération de liens de visioconférences. Ainsi, il faut donner un droit de réservation (droit de partage "peut réserver la ressource" ou supérieur) aux utilisateurs ou groupes souhaités pour que ceux-ci puissent créer des visioconférences pour leurs événements.

Droit d'accès par défaut

Par défaut, la ressource n'est pas partagée, les utilisateurs ne peuvent pas lier de visioconférence.

Horaires de disponibilité

En tant que ressource, il est possible de lui attribuer des heures ouvrées ou encore une politique de réservation. Cependant le lien généré étant unique, cela n'aura pas d'incidence sur la disponibilité de la visioconférence en elle-même : le lien sera malgré tout actif et disponible en dehors de ces horaires.

Pour plus d'informations sur l'administration des ressources et l'attribution des droits, consulter la page Éditer les ressources.

Utiliser la ressource​

Dès lors que les utilisateurs ont un droit de réservation sur la ressource (voir paragraphe précédent), un bouton est disponible dans l'interface de création des événements :

Pour plus d'informations sur la création de visioconférences ou l'ajout dans des événements d'agenda, consulter les pages suivantes du guide de l'utilisateur :