L’utilisation d’un serveur STUN ou TURN nécessite une configuration spécifique dans Portal sur les différents composants :
- Wazo Mobile
- Wazo Web/Desktop et Extensions
- Wazo EUC Stack
Avec ajout d’un lien plus vers description plus technique sur ce qu’est le ICE avec schéma et tout
Wazo Mobile
La complexité du réseau mobile et les multiples NAT qui le compose, rend obligatoire l’utilisation d’un service TURN pour le bon fonctionnement des communications de l’application. Autrement, le RTP (la voix) risque de ne pas se rendre à destination.
Pour configurer l’application mobile à l’utilisation de d’un serveur TURN :
-
Aller dans : Settings → Applications → Apps Configuration
-
Cliquer sur +CREATE et choisir l’application de type Wazo Mobile
-
Dans l’onglet Communication ajouter votre serveur TURN
-
Cliquer sur + CREATE pour sauvegarder la configuration
Wazo Web/Desktop et Extensions
La présence d’un NAT dans la quasi-totalité des réseaux, nécessite l’utilisation d’un serveur STUN
-
Aller dans : Settings → Applications → Apps Configuration
-
Cliquer sur + CREATE et choisir l’application de type Wazo Web
-
Dans l’onglet Communication ajouter votre serveur STUN
-
Cliquer sur + CREATE pour sauvegarder la configuration
-
Répéter les étape 1-4 pour les application de type Wazo Desktop / Wazo Chrome Extension / Wazo Softphone (si applicable)
Wazo EUC Stack
Lorsque la Stack est derrière un NAT, celle-ci doit pouvoir fournir son IP publique.
Pour activer le support du ICE par la stack :
- Aller dans: Global Settings → RTP → GENERAL (onglet)
- Activer le bouton Enable ICE Support (défaut: activé) (voir Fonctionnement de ICE pour plus de détails)
- Ajouter votre serveur STUN (défaut: stun.wazo.io:443) (voir configurer votre propre service STUN/TURN)
- Attention: le serveur STUN doit être en dehors du réseau de la stack
Sans serveur STUN
Dans le cas ou le serveur STUN est dans le même réseau que le Stack ou simplement par souci d'optimisation du délai de communication pour éviter une requête vers le serveur STUN, il est possible de configurer manuellement l'adresse IP publique de la Stack:
-
Enlever le serveur STUN de l’étape 3 précédemment configuré
-
Aller dans Global Settings → RTP → ICE Host Candidates (onglet)
-
Ajouter : Adresse IP Locale et Adresse IP Publique
Validation
Pour valider la configuration, il est nécessaire de bien tester chacune des applications en tant qu’émetteur et receveur d’un appel. Pour chacun de ces scénarios, vérifier que :
- Aucun délai lors l’émission d’un appel (> 4 secondes)
- Le téléphone de l’appelé sonne
- On entend la voix dans les deux sens
Problèmes courants
Il y a un délai lorsqu’un appel est émis
- Le serveur STUN est inaccessible
- Vérifier qu’il n’y a pas d’erreur dans l’adresse et port du serveur STUN / TURN
- Vérifier que le serveur STUN / TURN est accessible depuis internet et la stack
Lorsque je décroche via l’application mobile, elle se ferme après quelques secondes
- Le mobile est incapable de communiquer avec votre serveur TURN
- Vérifier qu’il n’y a pas d’erreur dans l’adresse et port du serveur STUN / TURN
- Vérifier que le serveur TURN est accessible depuis votre téléphone
Je n'ai pas de son provenant de mon interlocuteur, mais celui-ci m'entend
- Votre serveur STUN est configuré dans le même réseau que la stack et ne peut pas détecter l'adresse IP publique de la stack
- Vérifier que pour la configuration de Wazo EUC Stack, vous avez configuré votre IP publique manuellement au lieu d’utiliser le serveur STUN
L’application mobile ne sonne pas
- Il est peu probable que cela provienne de votre serveur STUN / TURN
- Vérifier que le téléphone a un accès internet et que les push notifications fonctionnent