Lecteur Markdown

Remote Desktop Documentation Fr

Fonctionnalité : Remote Desktop #

Partage d'écran et contrôle à distance entre utilisateurs, en pair-à-pair via WebRTC. Un utilisateur invite un autre membre connecté, qui voit alors son écran et peut, sur autorisation, prendre le contrôle. La signalisation transite par le serveur ; le flux vidéo est direct entre les deux navigateurs.

Installation et Configuration

Par FTP : Déposer le répertoire remote_desktop/ dans /plugins/, puis importer remote_desktop/sql/remote_desktop.sql.

Par package manager : Sélectionner remote_desktop dans la liste des plugins disponibles.

Chemins :

Plugin principal : /plugins/remote_desktop/remote_desktop.php
Bibliothèque : /plugins/remote_desktop/lib/remote_desktop.lib.inc.php
Handler de signalisation : /plugins/remote_desktop/handlers/remote_desktop.mod.php
CSS / JS : /plugins/remote_desktop/css/, /plugins/remote_desktop/js/

Paramètres de configuration :

| Variable | Valeur par défaut | Description |

|---|---|---|

| $basedatadisplay | 'yes' | Visible dans l'interface de gestion |

| $basedisplevel | BASE_LEVEL_USER | Accessible aux utilisateurs connectés |

| $ftype | 5 | Module applicatif |

| REMOTE_DESKTOP_LEVEL_USER | BASE_LEVEL_USER | Niveau pour utiliser le partage |

| REMOTE_DESKTOP_LEVEL_ADMIN | BASE_LEVEL_ADMIN | Niveau administrateur |

| $rd_ice_servers | STUN Google | Serveurs ICE WebRTC (voir note ci-dessous) |

| $rd_poll_interval | 500 | Intervalle de polling de signalisation (ms), pendant la négociation |

| $rd_max_session_duration | 3600 | Durée maximale d'une session (secondes) |

| $rd_signal_ttl | 300 | Durée de vie des signaux avant nettoyage (secondes) |

> Production : remplacer le serveur STUN Google par un serveur STUN/TURN auto-hébergé (coturn, etc.). Les serveurs Google reçoivent les adresses IP candidates.

Tables SQL utilisées : remote_desktop_session, remote_desktop_signal

Utilisation

La page principale présente deux panneaux :

Utilisateurs — liste des membres connectés disponibles (rafraîchie toutes les 15 s), à inviter.
Sessions — sessions de partage en cours.

Lorsqu'une invitation est reçue, le destinataire la traite via une URL ?respond=ID_session.

Deux modes d'affichage en iframe servent l'interface WebRTC minimale (sans habillage du site) :

mode=sharer — partage son écran.
mode=viewer — visualise l'écran distant, avec une zone de prise de contrôle optionnelle.

La barre d'outils propose plein écran, demande de contrôle et fin de session.

Hooks et Points d'entrée

text

?obj=remote_desktop.php                                — Page principale (utilisateurs + sessions)
?obj=remote_desktop.php&respond=ID_session            — Réponse à une invitation
?obj=remote_desktop.php&mode=sharer&session_id=ID     — Cadre iframe : partage d'écran
?obj=remote_desktop.php&mode=viewer&session_id=ID     — Cadre iframe : visualisation
?obj=remote_desktop.mod                               — Endpoint de signalisation WebRTC

Dépendances

Beamreactor\Database\SQL
Beamreactor\Sanitizer\Parser
Beamreactor\Notifications\Toast
WebRTC (navigateur) + serveur STUN/TURN

Sécurité

Accès réservé aux utilisateurs connectés. La session de partage et la prise de contrôle nécessitent l'acceptation explicite du destinataire. Les sessions ont une durée maximale ($rd_max_session_duration) et les signaux expirent ($rd_signal_ttl) pour limiter la fenêtre de négociation. En production, utiliser un serveur STUN/TURN auto-hébergé afin de ne pas divulguer les adresses IP des participants à un tiers.