Prérequis et procédure d’activation de SCOPLINK UPA

1. Objectif

Ce document présente les prérequis techniques et les paramètres requis pour activer l’application de collaboration SCOPLINK UPA sur une plateforme SCOPTEL.

SCOPLINK UPA utilise notamment les protocoles PJSIP, WebRTC, DTLS, ainsi que les services HTTP et HTTPS du module de téléphonie. Tous les éléments décrits ci-dessous doivent être configurés avant le déploiement de l’application auprès des utilisateurs.

2. Prérequis système

La plateforme doit respecter les exigences minimales suivantes :

Composant	Exigence minimale
Système d’exploitation	Rocky Linux 8
Protocole de téléphonie	PJSIP activé
API V3	Version 8.0.47 ou plus récente
API Event	Version 8.0.0.18 ou plus récente

Il est recommandé de confirmer que le système est à jour et que les versions installées correspondent aux exigences indiquées avant de poursuivre la configuration.

3. Activation du protocole PJSIP

Le protocole PJSIP doit être activé sur la plateforme SCOPTEL.

SCOPLINK UPA s’appuie sur PJSIP pour établir et gérer les communications téléphoniques. Une configuration utilisant uniquement l’ancien pilote SIP ne permettra pas le fonctionnement complet de l’application.

https://service.scopserv.com/portal/en/kb/articles/pjsip-configuration

Après l’activation de PJSIP, vérifier que les services de téléphonie sont correctement démarrés et qu’aucune erreur n’est présente dans les journaux du système.

4. Vérification des API

API V3

La version minimale requise de l’API V3 est : 8.0.47

Une version plus récente peut être utilisée.

API Event

La version minimale requise de l’API Event est : 8.0.0.18

Après l’installation ou la mise à jour de l’API Event, il est essentiel de vérifier que son service est démarré et configuré pour se lancer automatiquement au démarrage du serveur.

Le service doit demeurer actif afin que SCOPLINK UPA puisse recevoir les événements de téléphonie en temps réel, notamment les changements d’état, les appels entrants et sortants ainsi que les événements associés aux extensions.

5. Configuration du pare-feu

Dans la configuration du pare-feu SCOPTEL, accéder à l’option :

VoIP — SIP/IAX/MGCP

Ajouter ou autoriser les ports TCP suivants :

Port	Protocole	Utilisation
8088	TCP	Connexions HTTP et WebSocket
8089	TCP	Connexions HTTPS et WebSocket sécurisé

Le port 8089/TCP est particulièrement important pour les communications WebRTC sécurisées utilisant WSS et DTLS.

Les règles doivent permettre les connexions provenant des réseaux ou des adresses IP utilisés par les postes de travail exécutant SCOPLINK UPA.

Lorsque l’application est utilisée à distance, les règles de pare-feu, les redirections NAT et les politiques de sécurité périphériques doivent également permettre l’accès à ces ports.

6. Configuration des extensions

Pour chaque extension devant utiliser SCOPLINK UPA :

1. Accéder à la configuration de l’extension.

2. Activer l’option WebRTC.

3. Activer l’option DTLS Encryption.

4. Activer l’option Use received media transport.

5. Activer l’option WebRTC.

6. Enregistrer les changements.

7. Appliquer ou recharger la configuration de téléphonie.

WebRTC

L’option WebRTC permet à l’application d’établir des communications audio directement à partir de son interface, par l’intermédiaire d’une connexion WebSocket.

DTLS Encryption

L’option DTLS Encryption active le chiffrement requis pour sécuriser les communications WebRTC et la négociation des médias.

Ces deux options doivent être activées sur toutes les extensions utilisées avec SCOPLINK UPA.

7. Activation des services HTTP et HTTPS

Dans l’interface d’administration SCOPTEL :

1. Accéder à l’onglet Telephony Module.

2. Repérer les paramètres du serveur HTTP.

3. Activer l’option HTTP Server.

4. Activer l’option HTTPS.

5. Enregistrer les changements.

6. Redémarrer ou recharger les services concernés, lorsque requis.

Le serveur HTTP permet à Asterisk et à SCOPLINK UPA d’utiliser les connexions WebSocket nécessaires au fonctionnement de WebRTC.

L’utilisation de HTTPS est fortement recommandée et généralement requise pour les connexions WebRTC sécurisées.

8. Validation des services

Avant de procéder à l’activation des utilisateurs, vérifier les éléments suivants :

· Rocky Linux 8 est installé.

· PJSIP est activé et fonctionnel.

· L’API V3 est en version 8.0.47 ou plus récente.

· L’API Event est en version 8.0.0.18 ou plus récente.

· Le service de l’API Event est démarré.

· Le service de l’API Event démarre automatiquement avec le serveur.

· Les ports 8088/TCP et 8089/TCP sont autorisés dans le pare-feu.

· L’option WebRTC est activée sur les extensions.

· L’option DTLS Encryption est activée sur les extensions.

· Le serveur HTTP est activé dans le Telephony Module.

· Le service HTTPS est activé.

· Le certificat HTTPS utilisé est valide et reconnu par les postes clients.

Vérifiez le service http sur Asterisk (asterisk -vr)

http show status
Depuis le PBX, vérifiez que le port HTTPS est à l'écoute : ss -ltnp | grep -E ':8088|:8089'
Depuis un système externe, vérifiez que le port TCP 8089 est accessible: nc -vz your-public-hostname 8089
Vous pouvez également examiner le certificat TLS:
```
openssl s_client -connect 127.0.0.1:8089 \
-servername your.public.hostname </dev/null
```
Vérifiez que les noms figurant dans le certificat incluent le nom d'hôte utilisé par le client :
```
wss://your.public.hostname:8089/ws
```
Un navigateur rejettera la connexion WSS si le certificat est expiré, non approuvé ou émis pour un nom d'hôte différent.

Tester localement
Commande:
```
curl -I http://127.0.0.1:8088/ws
curl -k -I https://127.0.0.1:8089/ws
```
Test depuis l'extérieur
Depuis une machine qui ne se trouve pas sur le réseau local (LAN) du PBX :
```
nc -vz your.public.hostname 8089
```
Ou:
```
openssl s_client -connect your.public.hostname:8089 \
-servername your.public.hostname
```
```
TCP 8089 -> PBX TCP 8089
```

9. Tests recommandés

Une fois la configuration terminée, effectuer les tests suivants avec une extension pilote :

1. Connexion de l’utilisateur à SCOPLINK UPA.

2. Enregistrement de l’extension PJSIP.

3. Validation de l’état de présence de l’extension.

4. Réception d’un appel entrant.

5. Établissement d’un appel sortant.

6. Validation de l’audio bidirectionnel.

7. Test de mise en attente et de reprise d’appel.

8. Test de transfert d’appel.

9. Validation de la reconnexion après la fermeture et la réouverture de l’application.

10. Validation du fonctionnement à partir d’un réseau externe, lorsque l’utilisation à distance est prévue.

10. Points importants

Un certificat HTTPS invalide, expiré ou non reconnu peut empêcher l’établissement de la connexion WebSocket sécurisée.

Les équipements de sécurité situés entre l’utilisateur et le serveur, notamment les pare-feu, les routeurs et les systèmes d’inspection de trafic, ne doivent pas bloquer les connexions WebSocket sur le port 8089/TCP.

Une modification des paramètres PJSIP, WebRTC, DTLS ou du serveur HTTP peut nécessiter un rechargement de la configuration ou un redémarrage des services de téléphonie.

Il est recommandé de tester SCOPLINK UPA avec une seule extension avant de généraliser son activation à l’ensemble des utilisateurs.

11. Résumé de la configuration

Pour activer SCOPLINK UPA, la plateforme doit fonctionner sous Rocky Linux 8 avec PJSIP activé. L’API V3 doit être en version 8.0.47 ou plus récente et l’API Event en version 8.0.0.18 ou plus récente, avec son service démarré.

Les ports 8088/TCP et 8089/TCP doivent être autorisés dans le pare-feu sous l’option VoIP — SIP/IAX/MGCP. Les extensions doivent avoir les options WebRTC et DTLS Encryption activées. Enfin, les services HTTP Server et HTTPS doivent être activés dans l’onglet Telephony Module.