EasyUC pour Microsoft Teams
Activer le SBC Teams et définir les paramètres réseau
Activer le Session Border Controller intégré et définir l’adresse IP, les ports et la méthode de certificat.
Dans EasyUC : EasyUC Teams → Teams → SBC Setup
Les images proviennent du lab EasyUC. Les noms et valeurs sont des exemples. Toute différence de langue de l’interface est indiquée à côté de l’image.
À quoi cela sert
Microsoft Teams Direct Routing relie un tenant Teams à un Session Border Controller (SBC) par un trunk SIP. EasyUC inclut ce SBC. Il s’exécute sur le serveur EasyUC, accepte le trunk de Microsoft via TLS et transmet les appels aux scripts EasyUC (ACD, IVR, poste opérateur). Aucun PBX supplémentaire ni SBC tiers n’est nécessaire.
Sur cette page, vous définissez ce qui s’applique au SBC dans son ensemble : l’adresse publique par laquelle Microsoft le joint, les ports qu’il utilise et la méthode par laquelle EasyUC commande les certificats auprès de Let’s Encrypt. Les noms d’hôte et les certificats eux-mêmes relèvent de chaque tenant et y sont configurés.
La signalisation vers Microsoft passe uniquement par TLS, avec vérification mutuelle des certificats. L’audio circule uniquement chiffré en SRTP. Le media bypass n’est pas utilisé. Le SBC accepte les connexions des seuls réseaux Microsoft.
Prérequis
- Module de licence
teams. Sans ce module, l’espace de travail EasyUC Teams n’apparaît pas. - Rôle EasyUC Teams (
ROLE_APP_TEAMS_WORKSPACE) avec les sous-droits SBC (ROLE_APP_TEAMS_SBC) pour la lecture et SBC bearbeiten (ROLE_APP_TEAMS_SBC_EDIT) pour la modification. - Une adresse IPv4 publique par laquelle le serveur EasyUC est joignable depuis Internet. Derrière un NAT 1:1, il s’agit de l’adresse externe.
- Des règles de pare-feu pour le port TLS et la plage RTP. Les ports exacts figurent dans le chapitre « DNS, adresse IP publique et pare-feu pour le SBC ».
- Une adresse e-mail pour le compte Let’s Encrypt. Les avertissements d’expiration y sont envoyés.
Pas à pas : activer le SBC pour la première fois
Pas à pas : modifier les réglages ultérieurement
Champs et options
| Champ / action | Signification et utilisation |
|---|---|
| Default domain (optional) | Suggestion pour le nom d’hôte des nouveaux tenants, par exemple sbc.example.com. Chaque tenant peut utiliser son propre nom d’hôte dans le domaine du client. |
| Public IP | Adresse à laquelle Microsoft se connecte. Obligatoire : sans elle, le SBC ne démarre pas. Les plages privées et réservées sont refusées. |
| Media IP | Adresse locale pour le RTP. Derrière un NAT 1:1, saisissez ici l’adresse interne du serveur et l’adresse externe sous Public IP. |
| First TLS port | Valeur de départ pour l’attribution des ports, 5061 par défaut. Chaque tenant reçoit le prochain port libre. Les ports 8021, 9060, 15060 et 15080 sont utilisés en interne. |
| RTP from / RTP to | Plage UDP pour l’audio, 20000 à 20999 par défaut, valeur de départ minimale 1024. La plage ne doit pas chevaucher l’UDP 16384 à 19999 (ports CTI de l’ACD) ni 24000 à 24999 (exécution des scripts pour les appels Teams). |
| Contact e-mail | Adresse du compte Let’s Encrypt. Sans elle, aucun certificat ne peut être commandé. |
| Environment | Production délivre un certificat reconnu publiquement. Staging sert uniquement aux essais ; Microsoft n’accepte pas le trunk avec lui. En production, les limites de Let’s Encrypt s’appliquent : cinq certificats identiques par semaine, cinq validations échouées par heure. |
| Validation | DNS-01 prouve le nom d’hôte par un enregistrement TXT, le port 80 reste fermé. HTTP-01 peut être sélectionné, mais cette version ne demande les certificats que par DNS-01. |
| DNS provider (optional) | Nom du fournisseur pour le renouvellement automatique. cloudflare est implémenté. Pour les autres fournisseurs, la méthode manuelle reste disponible. |
| DNS credentials (optional) | Pour Cloudflare, une ligne CF_API_TOKEN=…. Avec des identifiants, EasyUC définit lui-même l’enregistrement TXT et renouvelle sans intervention. Sans eux, la page du tenant affiche l’enregistrement que vous devez créer. |
| Disable | Met le SBC hors service. Les réglages des tenants sont conservés, les trunks sont ensuite hors ligne. Une invite de confirmation apparaît d’abord. |
| Teams Tenants / Manage tenants | Ouvre la liste des tenants. |
Vérifier le résultat et circonscrire les erreurs
- Succès : l’en-tête affiche SBC service avec un numéro de version et last seen avec une heure récente. En dessous figurent le domaine par défaut, le nombre de tenants, les appels en cours et l’adresse IP publique.
- “The SBC service has not reported in yet. Settings are stored and will be picked up as soon as it runs.” Le service ne fonctionne pas ou ne joint pas l’administration. Vérifiez dans EasyUC Manager que le module Teams est activé et que le service SBC fonctionne. Sans signe de vie, le service est considéré hors ligne au bout de 90 secondes.
- Un message indiquant qu’aucune adresse IP publique n’est enregistrée et que le SBC ne démarre pas sans elle : saisissez l’adresse sous Edit.
- „Die öffentliche IP muss aus dem Internet erreichbar sein; … liegt in einem privaten oder reservierten Bereich.“ Vous avez saisi l’adresse interne. L’adresse externe va dans Public IP, l’adresse interne dans Media IP.
- „Der RTP-Bereich … überschneidet sich mit …“ ou „Der RTP-Bereich … enthält Port …“ Choisissez une plage en dehors des ports cités dans le message ; 20000 à 20999 est la valeur habituelle.
- „Für Let’s Encrypt wird eine gültige E-Mail-Adresse benötigt.“ Corrigez le Contact e-mail.
- “Certificates from the staging environment are NOT publicly trusted. Microsoft will not accept the trunk with them.” Réglez Environment sur production et demandez de nouveau les certificats des tenants.
- Un service SBC en fonctionnement ne dit rien d’un trunk particulier. Contrôlez le certificat, le trunk et les OPTIONS par tenant.