VoIP Telefonie/vPBX/Anbindung MS Teams an vPBX: Unterschied zwischen den Versionen

Zurück zur Versionsgeschichte
Versionsgeschichte interaktiv durchsuchen
← Zum vorherigen Versionsunterschied
VisuellWikitext
Marc Senti (Diskussion | Beiträge)
340 Bearbeitungen
Keine Bearbeitungszusammenfassung
Jan Wild (Diskussion | Beiträge)
750 Bearbeitungen
KKeine Bearbeitungszusammenfassung
Markierung: Quelltext-Bearbeitung 2017
 
(17 dazwischenliegende Versionen von 2 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
<div class="ac-layout">
<div class="ac-layout">
 
=== Anleitung von Hersteller wwcom ===
{{Layout}}
https://doku.wwcom.ch/books/ms-teams/page/ms-teams<div class="ac-layout-section two_equal">
<div class="ac-layout-section two_equal">


<div class="ac-layout-cell">
<div class="ac-layout-cell">


<span id="voraussetzungen-vpbxteams"></span>
=== Voraussetzungen für Anbindung von MS Teams an die vPBX ===
= <span>Voraussetzungen vPBX+Teams</span> =


{{Note
==== Erstens: Die richtige Telefon-Lizenz für jeden User, welcher "in die weite Welt" telefonieren will ====
|icon = false
|title = Lizenzen
|body =  
 
* Microsoft 365 E5 Lizenz oder
* Microsoft 365 E3, mit &quot;Phone System&quot; (und optional &quot;Audio conferencing&quot;) Lizenz pro User oder
* Microsoft 365 E1, mit &quot;Phone System&quot; (und optional &quot;Audio conferencing&quot;) Lizenz pro User oder
* Microsoft 365 Business Basic/Standard/Premium, mit &quot;Phone System&quot; Lizenz pro User, welcher telefonieren können soll


{{Textbox
|boxtype=tip
|header=Lizenzen
|text=
Lizenz "Microsoft Teams Telefon Standard" pro User oder eine Lizenz, welche diese Option enthält. <br />
<br />
'''iWay AG bietet im Moment keine Microsoft-Lizenzen an.'''
'''iWay AG bietet im Moment keine Microsoft-Lizenzen an.'''
|icon=yes}}


}}
==== Zweitens: Admin-Zugriff auf Microsoft 365 ====
{{Note
|icon = false
|title = Zugriffe/Berechtigungen
|body =  


* Microsoft365 Global Admin User für &quot;Microsoft 365 admin center&quot;, &quot;Microsoft Teams admin center&quot; und Powershell
{{Textbox
|boxtype=tip
|header=Zugriffe/Berechtigungen
|text=


}}
Zugriff auf Microsoft 365 Admin: https://admin.microsoft.com/ <br />
{{Note
Zugriff auf Microsoft 365 Teams Admin: https://admin.teams.microsoft.com/ <br />
|icon = false
|title = vPBX
|body =


* Richtige Hypervisor-Umgebung sein, die vPBX-Version ab KVM304v3 und Menü &quot;PBX Einstellungen&quot; sichtbar: Kontaktieren Sie hierzu den iWay-VoIP-Support: 0435001111 oder [mailto:voip@iway.ch voip@iway.ch]
|icon=yes}}


}}
=== Vorbemerkungen zur MS Teams Domain ===


<span id="vorbemerkungen-zur-ms-teams-domain"></span>
{{Textbox
= Vorbemerkungen zur MS Teams Domain =
|boxtype=tip
 
|header=
{{Info
|text=
|body =  
 
Es wird davon ausgegangen, dass Sie die Domain &quot;ihredomain.ch&quot; schon in MS Teams verwenden. Es werden nun folgende 5 DNS-Einträge hinzugefügt: 4 Einträge für &quot;Skype for Business&quot; und A-Record von teams.ihredomain.ch auf Ihre vPBX xyz.vpbx.iway.ch.


Es wird davon ausgegangen, dass Sie die Domain "ihredomain.ch" schon in MS Teams verwenden. Es werden nun folgende 5 DNS-Einträge hinzugefügt: 4 Einträge für "Skype for Business" und A-Record von teams.ihredomain.ch auf Ihre vPBX xyz.vpbx.iway.ch. <br />
<br />
Nach der Umstellung wird Ihre vPBX nur noch unter https://teams.ihredomain.ch erreichbar sein, da nicht zwei SSL-Zertifikate auf eine vPBX zeigen können. Ihre zuvor angemeldeten Telefone/CTI-Clients müssen entsprechend umkonfiguriert/neu provisioniert werden. Ebenfalls müssen die Teilnehmer-Logins den MS-Teams-Usern angeglichen werden, d. h. die Teilnehmer-Logins auf der vPBX müssen ebenfalls vorname.nachname lauten.
Nach der Umstellung wird Ihre vPBX nur noch unter https://teams.ihredomain.ch erreichbar sein, da nicht zwei SSL-Zertifikate auf eine vPBX zeigen können. Ihre zuvor angemeldeten Telefone/CTI-Clients müssen entsprechend umkonfiguriert/neu provisioniert werden. Ebenfalls müssen die Teilnehmer-Logins den MS-Teams-Usern angeglichen werden, d. h. die Teilnehmer-Logins auf der vPBX müssen ebenfalls vorname.nachname lauten.


}}
|icon=yes}}
 


</div>
</div>
<div class="ac-layout-cell">
<div class="ac-layout-cell">


Inhalt:
'''Inhalt:'''


__TOC__  
__TOC__  


 
</div>


</div>
</div>


</div>
{{Layout}}
{{Layout}}
<div class="ac-layout-section two_equal">
<div class="ac-layout-section single">


<div class="ac-layout-cell">
<div class="ac-layout-cell">


<span id="schritt-1-einrichten-der-domain"></span>
=== Schritt 1: Einrichten der Domain ===
= Schritt 1: Einrichten der Domain =


{{Info
{{Textbox
|body =  
|boxtype=tip
|header=
|text=


Dieser Schritt zeigt das Einrichten der Domain im &quot;Microsoft 365 admin center&quot; unter https://admin.microsoft.com/AdminPortal/Home#/Domains .
Dieser Schritt zeigt das Einrichten der Domain im "Microsoft 365 admin center" unter https://admin.microsoft.com/AdminPortal/Home#/Domains.


}}
|icon=yes}}




Zeile 84: Zeile 75:


<br />
<br />




Zeile 95: Zeile 85:
<div class="ac-layout-cell">
<div class="ac-layout-cell">


<span id="erstellen-der-dns-server-einträge"></span>
==== Erstellen der DNS-Server-Einträge ====
== Erstellen der DNS-Server-Einträge ==




Zeile 103: Zeile 92:
</div>
</div>
{{Layout}}
{{Layout}}
<div class="ac-layout-section two_left_sidebar">
<div class="ac-layout-section two_equal">


<div class="ac-layout-cell">
<div class="ac-layout-cell">


Tragen Sie auf Ihren DNS-Servern folgende Einträge für Ihre Domain &quot;ihredomain.ch&quot; ein:
Tragen Sie auf Ihren DNS-Servern folgende Einträge für Ihre Domain "ihredomain.ch" ein:




Zeile 163: Zeile 152:
</div>
</div>
{{Layout}}
{{Layout}}
<div class="ac-layout-section two_left_sidebar">
<div class="ac-layout-section two_equal">


<div class="ac-layout-cell">
<div class="ac-layout-cell">
Zeile 198: Zeile 187:
</div>
</div>
{{Layout}}
{{Layout}}
<div class="ac-layout-section two_left_sidebar">
<div class="ac-layout-section two_equal">


<div class="ac-layout-cell">
<div class="ac-layout-cell">
Zeile 219: Zeile 208:
<div class="ac-layout-cell">
<div class="ac-layout-cell">


{{Note
{{Textbox
|body =  
|boxtype=tip
|header=
|text=  


Zum Zeitpunkt der Umstellung der vPBX auf Teams muss dieser DNS-Eintrag weltweit verfügbar sein, da sonst das nötige Zertifikat nicht erstellt werden kann.
Zum Zeitpunkt der Umstellung der vPBX auf Teams muss dieser DNS-Eintrag weltweit verfügbar sein, da sonst das nötige Zertifikat nicht erstellt werden kann.


}}
|icon=yes}}




Zeile 235: Zeile 226:
<div class="ac-layout-cell">
<div class="ac-layout-cell">


<span id="aktivierung-ihrer-domain-für-skype-for-business"></span>
==== Aktivierung Ihrer Domain für "Skype for Business" ====
== Aktivierung Ihrer Domain für &quot;Skype for Business&quot; ==




Zeile 243: Zeile 233:
</div>
</div>
{{Layout}}
{{Layout}}
<div class="ac-layout-section two_left_sidebar">
<div class="ac-layout-section two_equal">


<div class="ac-layout-cell">
<div class="ac-layout-cell">
Zeile 249: Zeile 239:
Öffnen Sie https://admin.microsoft.com/AdminPortal/Home#/Domains 
Öffnen Sie https://admin.microsoft.com/AdminPortal/Home#/Domains 


Klicken Sie auf &quot;ihredomain.ch&quot; (jene Domain, welche Sie schon für sich eingerichtet ist):
Klicken Sie auf "ihredomain.ch" (jene Domain, welche Sie schon für sich eingerichtet ist):




Zeile 262: Zeile 252:
</div>
</div>
{{Layout}}
{{Layout}}
<div class="ac-layout-section two_left_sidebar">
<div class="ac-layout-section two_equal">


<div class="ac-layout-cell">
<div class="ac-layout-cell">


Klicken Sie auf &quot;DNS records&quot; und dann auf &quot;Manage DNS&quot;:
Klicken Sie auf "DNS records" und dann auf "Manage DNS":




Zeile 279: Zeile 269:
</div>
</div>
{{Layout}}
{{Layout}}
<div class="ac-layout-section two_left_sidebar">
<div class="ac-layout-section two_equal">


<div class="ac-layout-cell">
<div class="ac-layout-cell">


Klicken Sie unten auf [[File:KB_VoIP_Telefonie_vPBX_Anbindung_MS_Teams_an_vPBXimage2021-3-15_17-30-30.png|x36px|thumb]]:
Klicken Sie unten auf "Continue":
 




Zeile 296: Zeile 287:
</div>
</div>
{{Layout}}
{{Layout}}
<div class="ac-layout-section two_left_sidebar">
<div class="ac-layout-section two_equal">


<div class="ac-layout-cell">
<div class="ac-layout-cell">


Setzen Sie hier das Häkchen unter &quot;Advanced Options&quot; bei &quot;Skype for Business&quot;:
Setzen Sie hier das Häkchen unter "Advanced Options" bei "Skype for Business":




Zeile 327: Zeile 318:


<div class="ac-layout-cell">
<div class="ac-layout-cell">
 
=== Schritt 2: Weisen Sie den MS Teams Usern die richtige Microsoft Lizenz zu ===
<span id="schritt-2-weisen-sie-den-ms-teams-usern-die-richtige-microsoft-lizenz-zu"></span>
{{Textbox
= Schritt 2: Weisen Sie den MS Teams Usern die richtige Microsoft Lizenz zu =
|boxtype=tip
 
|header=
{{Note
|text=
|body =  


'''MS Lizenzen'''
'''MS Lizenzen'''


* Bei Enterprise Lizenzen braucht es entweder eine E5 Lizenz (keine weitere Zusatzlizenz nötig) oder eine E3 Lizenz mit Phone System add-on (und, falls Konferenzen getätigt werden sollen, Audio Conferencing add-on)
* Bei Enterprise Lizenzen braucht es entweder eine E5 Lizenz (keine weitere Zusatzlizenz nötig) oder eine E3 Lizenz mit Phone System add-on (und, falls Konferenzen getätigt werden sollen, Audio Conferencing add-on)
* Bei Microsoft 365 Lizenzen braucht es zusätzlich pro Benutzer die &quot;Phone System&quot;-Lizenz
* Bei Microsoft 365 Lizenzen braucht es zusätzlich pro Benutzer die "Phone System"-Lizenz


}}
|icon=yes}}




Zeile 346: Zeile 336:
</div>
</div>
{{Layout}}
{{Layout}}
<div class="ac-layout-section two_left_sidebar">
<div class="ac-layout-section two_equal">


<div class="ac-layout-cell">
<div class="ac-layout-cell">


Weisen Sie unter &quot;Users&quot; / &quot;Active Users&quot; den MS Teams Usern die richtige Microsoft Linzenz zu:
Weisen Sie unter "Users" / "Active Users" den MS Teams Usern die richtige Microsoft Linzenz zu:




</div>
</div>
<div class="ac-layout-cell">
<div class="ac-layout-cell">[[Datei:Anbindung MS Teams an vPBX 1712913615104.png]]
 
<img src="https://wiki.wwcom.ch/download/attachments/16646679/ms-lizenzen.png?version=1&modificationDate=1598858760000&api=v2" height="600" />




Zeile 367: Zeile 355:
<div class="ac-layout-cell">
<div class="ac-layout-cell">


<span id="schritt-3-auf-vpbx-teams-kompatibilitätsmodus-einschalten-und-domain-ändern"></span>
=== Schritt 3: Auf vPBX "Teams-Kompatibilitätsmodus" einschalten und Domain ändern ===
= Schritt 3: Auf vPBX &quot;Teams-Kompatibilitätsmodus&quot; einschalten und Domain ändern =


{{Textbox
|boxtype=tip
|header=
|text=
Zu diesem Zeitpunkt muss der neue DNS-Eintrag (teams.ihredomain.ch) weltweit verfügbar sein, da sonst das nötige Zertifikat nicht erstellt werden kann.
Nach dieser Umstellung ist Ihre vPBX nur noch unter <span class="nolink">https://teams.ihredomain.ch</span> mit Zertifikat erreichbar. Alle Telefone und CTI-Clients müssen auf die neue Domain umkonfiguriert werden.
|icon=yes}}


</div>
</div>
</div>


</div>
{{Layout}}
{{Layout}}
<div class="ac-layout-section two_left_sidebar">
<div class="ac-layout-section two_equal">


<div class="ac-layout-cell">
<div class="ac-layout-cell">


Auf der vPBX unter &quot;PBX Einstellungen&quot; bei &quot;Teams-Kompatibilitätsmodus&quot; auf &quot;VoIP+Presence&quot; umstellen und auf &quot;Speichern&quot; klicken:
Im Menü "PBX Einstellungen" unter "Allgemeine Einstellungen" den Hostname (z. B. "teams") und die Domain (ihredomain.ch) angeben und auf "Speichern" klicken:
 
 




</div>
</div>
<div class="ac-layout-cell">
<div class="ac-layout-cell">[[Datei:Anbindung MS Teams an vPBX 1713182013963.png|zentriert]]


[[File:KB_VoIP_Telefonie_vPBX_Anbindung_MS_Teams_an_vPBXimage2021-9-21_8-24-32.png]]


</div>


</div>
</div>


</div>
{{Layout}}
{{Layout}}
<div class="ac-layout-section two_left_sidebar">
<div class="ac-layout-section two_equal">


<div class="ac-layout-cell">
<div class="ac-layout-cell">


Im selben Menü unter &quot;Allgemeine Einstellungen&quot; den Hostname (z. B. &quot;teams&quot;) und die Domain (ihredomain.ch) angeben:
Auf der vPBX unter "PBX Einstellungen" bei "Teams-Kompatibilitätsmodus" auf "VoIP+Presence" umstellen und auf "Speichern" klicken:
 
{{Note
|body =
 
Zu diesem Zeitpunkt muss der neue DNS-Eintrag (teams.ihredomain.ch) weltweit verfügbar sein, da sonst das nötige Zertifikat nicht erstellt werden kann.
 
Nach dieser Umstellung ist Ihre vPBX nur noch unter <span class="nolink">https://teams.ihredomain.ch</span> mit Zertifikat erreichbar. Alle Telefone und CTI-Clients müssen auf die neue Domain umkonfiguriert werden.
 
}}




</div>
</div>
<div class="ac-layout-cell">
<div class="ac-layout-cell">[[Datei:Anbindung MS Teams an vPBX 1713182146883.png|zentriert]]
 
[[File:KB_VoIP_Telefonie_vPBX_Anbindung_MS_Teams_an_vPBXimage2021-9-21_8-26-42.png]]




Zeile 418: Zeile 405:
</div>
</div>
{{Layout}}
{{Layout}}
<div class="ac-layout-section single">
<div class="ac-layout-section two_equal">


<div class="ac-layout-cell">
<div class="ac-layout-cell">


<span id="schritt-4-in-azure-wert-schlüssel-paar-erzeugen-und-auf-vpbx-übertragen"></span>
Danach die vPBX neu starten:
= Schritt 4: In Azure Wert-Schlüssel-Paar erzeugen und auf vPBX übertragen =
 


{{Info
|body =


In diesem Schritt wird in Azure ein Wert-Schlüssel-Paar (&quot;Teams app id&quot; / &quot;Teams app key&quot;) erstellt, welches zur Abfrage des Presence-Status von MS Teams nötig ist.


}}
</div>
<div class="ac-layout-cell">[[Datei:Anbindung MS Teams an vPBX 1713182246771.png|zentriert]]




Zeile 440: Zeile 425:


<div class="ac-layout-cell">
<div class="ac-layout-cell">
===Schritt 4 / Variante 1: In Entra Wert-Schlüssel-Paar erzeugen und auf vPBX übertragen===
{{Textbox
|boxtype=tip
|header=
|text= 


<span id="anwendungs-id-client-erstellen"></span>
In diesem Schritt wird in Entra ein Wert-Schlüssel-Paar ("Teams app id" / "Teams app key") erstellt, welches zur Abfrage des Presence-Status von MS Teams nötig ist.
== &quot;Anwendungs-ID (Client)&quot; erstellen ==
 
|icon=yes}}




Zeile 449: Zeile 440:
</div>
</div>
{{Layout}}
{{Layout}}
<div class="ac-layout-section two_left_sidebar">
<div class="ac-layout-section single">


<div class="ac-layout-cell">
<div class="ac-layout-cell">
===="Anwendungs-ID (Client)" erstellen====


<br />


</div>


</div>
{{Layout}}
<div class="ac-layout-section two_equal">


Azure öffnen (https://portal.azure.com/) und dann unter <span>&quot;Azure Active Directory&quot; / &quot;App-Registrierungen&quot; eine '''&quot;Neue Registrierung&quot;''' erstellen:</span>
<div class="ac-layout-cell">


<br />
<br />Entra öffnen (https://portal.Entra.com/) und dann unter <span>"Entra Active Directory" / "App-Registrierungen" eine '''"Neue Registrierung"''' erstellen:</span>






<span>Direktlink: </span>https://portal.azure.com/#blade/Microsoft_AAD_IAM/ActiveDirectoryMenuBlade/RegisteredApps
<span>Direktlink: </span>https://portal.Entra.com/#blade/Microsoft_AAD_IAM/ActiveDirectoryMenuBlade/RegisteredApps




Zeile 476: Zeile 471:
</div>
</div>
{{Layout}}
{{Layout}}
<div class="ac-layout-section two_left_sidebar">
<div class="ac-layout-section two_equal">


<div class="ac-layout-cell">
<div class="ac-layout-cell">


<br />
<br /><span>Unter '''"Name"''' einen frei gewählten Namen angeben, z. B. "iwayteamsbridge" (es kann eine eigene Bezeichnung verwendet werden):</span>
 
 


<br />
<br />
Zeile 488: Zeile 481:




<br />
<span>Bei '''"Unterstützte Kontotypen" "Nur Konten in diesem Organisationsverzeichnis"''' auswählen:</span>
 
 


<br />
<br />
Zeile 498: Zeile 489:
<br />
<br />


<span>Unter '''"Umleitung-URI (optional)"''' die neue URL Ihrer vPBX </span><span class="nolink">https://teams.ihredomain.ch/oauth/</span><span> angeben:</span>


 
<span>Zuunterst auf "Registrieren" klicken.</span>
<br />
 
 
 
<span>Unter '''&quot;Name&quot;''' einen frei gewählten Namen angeben, z. B. &quot;iwayteamsbridge&quot; (es kann eine eigene Bezeichnung verwendet werden):</span>
 
<br />
 
 
 
<br />
 
 
 
<span>Bei '''&quot;Unterstützte Kontotypen&quot; &quot;Nur Konten in diesem Organisationsverzeichnis&quot;''' auswählen:</span>
 
<br />
 
 
 
<br />
 
 
 
<br />
 
 
 
<br />
 
 
 
<br />
 
 
 
<br />
 
 
 
<br />
 
 
 
<br />
 
 
 
<br />
 
<span>Unter '''&quot;Umleitung-URI (optional)&quot;''' die neue URL Ihrer vPBX </span><span class="nolink">https://teams.ihredomain.ch/oauth/</span><span> angeben:</span>
 
<span>Zuunterst auf [[File:KB_VoIP_Telefonie_vPBX_Anbindung_MS_Teams_an_vPBXimage2021-3-18_17-5-9.png|x31px|thumb]]klicken.</span>
 


</div>
</div>
Zeile 565: Zeile 503:
</div>
</div>
{{Layout}}
{{Layout}}
<div class="ac-layout-section two_left_sidebar">
<div class="ac-layout-section two_equal">


<div class="ac-layout-cell">
<div class="ac-layout-cell">


Den Wert hinter '''&quot;Anwendungs-ID (Client)&quot;''' kopieren ....
Den Wert hinter '''"Anwendungs-ID (Client)"''' kopieren ....


<br />
</div>
<div class="ac-layout-cell">


[[File:KB_VoIP_Telefonie_vPBX_Anbindung_MS_Teams_an_vPBXimage2021-3-18_17-8-22.png]]




<br />
</div>


</div>


{{Layout}}
<div class="ac-layout-section two_equal">


<br />
<div class="ac-layout-cell">


... und auf der vPBX in den"PBX Einstellungen" ins Feld '''"Teams app id"''' kopieren:




<br />
</div>
 
<div class="ac-layout-cell">[[Datei:Anbindung MS Teams an vPBX 1713182652488.png|zentriert]]
 
 
<br />
 
 
 
<br />
 
 
 
<br />
 
 
 
<br />
 
 
 
<br />
 
 
 
<br />
 
 
 
<br />
 
 
 
<br />
 
 
 
<br />
 
 
 
<br />
 
 
 
... und auf der vPBX in den&quot;PBX Einstellungen&quot; ins Feld '''&quot;Teams app id&quot;''' kopieren:




</div>
</div>
<div class="ac-layout-cell">
[[File:KB_VoIP_Telefonie_vPBX_Anbindung_MS_Teams_an_vPBXimage2021-3-18_17-8-22.png]]
[[File:KB_VoIP_Telefonie_vPBX_Anbindung_MS_Teams_an_vPBXimage2021-9-21_8-50-25.png]]


</div>
</div>


</div>
{{Layout}}
{{Layout}}
<div class="ac-layout-section single">
<div class="ac-layout-section single">


<div class="ac-layout-cell">
<div class="ac-layout-cell">
 
===="Geheimer Clientschlüssel" erzeugen====
<span id="geheimer-clientschlüssel-erzeugen"></span>
== &quot;Geheimer Clientschlüssel&quot; erzeugen ==




Zeile 654: Zeile 546:
</div>
</div>
{{Layout}}
{{Layout}}
<div class="ac-layout-section two_left_sidebar">
<div class="ac-layout-section two_equal">


<div class="ac-layout-cell">
<div class="ac-layout-cell">


Unter &quot;Zertifikate &amp; Geheimnisse&quot; auf '''&quot;Neuer geheimer Clientschlüssel&quot;''' klicken, ...
Unter "Zertifikate & Geheimnisse" auf '''"Neuer geheimer Clientschlüssel"''' klicken, ...




Zeile 667: Zeile 559:


<br />
<br />




Zeile 674: Zeile 565:
</div>
</div>
{{Layout}}
{{Layout}}
<div class="ac-layout-section two_left_sidebar">
<div class="ac-layout-section two_equal">


<div class="ac-layout-cell">
<div class="ac-layout-cell">


... '''&quot;Geheimen Clientschlüssel hinzufügen&quot;''', ...
... '''"Geheimen Clientschlüssel hinzufügen"''', ...




Zeile 691: Zeile 582:
</div>
</div>
{{Layout}}
{{Layout}}
<div class="ac-layout-section two_left_sidebar">
<div class="ac-layout-section two_equal">


<div class="ac-layout-cell">
<div class="ac-layout-cell">


... diesen auf der vPBX in den &quot;PBX Einstellungen&quot; ins Feld '''&quot;Teams app key&quot;''' kopieren und danach auf &quot;Speichern&quot; klicken.
... diesen auf der vPBX in den "PBX Einstellungen" ins Feld '''"Teams app key"''' kopieren und danach auf "Speichern" klicken.




</div>
</div>
<div class="ac-layout-cell">
<div class="ac-layout-cell">[[Datei:Anbindung MS Teams an vPBX 1713182733607.png|zentriert]]
 
[[File:KB_VoIP_Telefonie_vPBX_Anbindung_MS_Teams_an_vPBXimage2021-9-21_8-57-48.png]]




Zeile 711: Zeile 600:


<div class="ac-layout-cell">
<div class="ac-layout-cell">
 
====API-Berechtigungen====
<span id="api-berechtigungen"></span>
== API-Berechtigungen ==




Zeile 726: Zeile 613:
API-Berechtigungen müssen folgende gesetzt werden:
API-Berechtigungen müssen folgende gesetzt werden:


* User.Read
*User.Read
* Presence.Read
*Presence.Read
* Presence.ReadAll
*Presence.ReadAll




Zeile 738: Zeile 625:


<div class="ac-layout-cell">
<div class="ac-layout-cell">
 
====Authentifizierung der vPBX an Teams====
<span id="authentifizierung-der-vpbx-an-teams"></span>
== Authentifizierung der vPBX an Teams ==




Zeile 751: Zeile 636:
<div class="ac-layout-cell">
<div class="ac-layout-cell">


<span>Zum Abschluss die vPBX an der Microsoft Umgebung anmelden:</span>
Zum Abschluss die vPBX an der Microsoft Umgebung anmelden:


* https://teams.ihredomain.ch/oauth/ im Browser aufrufen
*https://teams.ihredomain.ch/oauth/ im Browser aufrufen
* Zugangsdaten eines berechtigten Users eingeben
*Zugangsdaten eines berechtigten Users eingeben
* Zugriffsrechte bestätigen
*Zugriffsrechte bestätigen




Zeile 766: Zeile 651:
<div class="ac-layout-cell">
<div class="ac-layout-cell">


<span id="schritt-5-aktivieren-von-microsoft-teams-benutzer-und-eintragen-der-ms-teams-telefonnummer-pro-teilnehmer-auf-der-vpbx"></span>
===Schritt 4 / Variante 2: In Entra Zertifikat ===
= Schritt 5: Aktivieren von &quot;Microsoft Teams Benutzer&quot; und Eintragen der &quot;MS Teams Telefonnummer&quot; pro Teilnehmer auf der vPBX =


</div>
</div>
{{Layout}}
{{Layout}}
<div class="ac-layout-section two_left_sidebar">
<div class="ac-layout-section two_left_sidebar">
<div class="ac-layout-cell">
<div class="ac-layout-cell">
 
Das öffentliche Zertifikat von der vPBX herunterladen ...
Alle Benutzer auf der PBX erstellen bzw. entsprechend dieser Regel ändern: Der Benutzername muss identisch sein, wie der Microsoft 365 Benutzername (ohne @Domain). Beispiel: wenn der Microsoft 365 Benutzer [mailto:hans.beispiel@beispielfirma.ch hans.beispiel@beispielfirma.ch] heisst, so muss der Benutzer auf der vPBX '''hans.beispiel''' heissen.
 
Bei jedem Teams Benutzer ist nach dem Erstellen die Option &quot;Microsoft Teams Benutzer&quot; zu aktivieren und die Telefonnummer (Format +41...), mit welcher der Benutzer in der Teams Umgebung verknüpft werden wird, unter &quot;MS Teams Telefonnummer&quot; einzutragen, siehe Screenshot rechts.
 
Update Juli 2021: Als &quot;MS Teams Telefonnummer&quot; muss keine gültige Telefonnummer verwendet werden und auch das Format +41... muss nicht beachtet werden: Es können auch (z. B. vierstellige) interne Telefonnummern verwendet werden, wie z. B. 1000, 1001, 1002 etc. <br />
Das Eintragen von Internen Nummern ins Feld &quot;MS Teams Telefonnummer&quot; scheint nur zuverlässig zu funktionieren wenn alle User ausschliesslich MS Teams verwenden. Ansonsten gibt es Probleme beim Weiterleiten von Anrufen von MS Teams zu Hardware-Telefonen oder CTI-Client. 
 
 
</div>
</div>
<div class="ac-layout-cell">
<div class="ac-layout-cell">
[[Datei:VoIP Telefonie vPBX Anbindung MS Teams an vPBX 1763022457701.png|center]]
</div>
</div>


[[File:KB_VoIP_Telefonie_vPBX_Anbindung_MS_Teams_an_vPBX2021-09-21_09_14_29-172.18.5.89_-_Remotedesktopverbindung.png]]
<br />
 


{{Layout}}
<div class="ac-layout-section two_left_sidebar">
<div class="ac-layout-cell">
... und hier hochladen ...
</div>
</div>
</div>
{{Layout}}
<div class="ac-layout-section single">
<div class="ac-layout-cell">
<div class="ac-layout-cell">
 
[[Datei:VoIP Telefonie vPBX Anbindung MS Teams an vPBX 1763022583511.png|center]]
<span id="schritt-6-in-powershell-an-teams-anmelden"></span>
= <span style="font-size: 24.0px;letter-spacing: -0.01em;">Schritt 6: In Powershell an Teams anmelden</span> =
 
 
</div>
</div>
</div>
</div>
{{Layout}}
<div class="ac-layout-section two_equal">


<div class="ac-layout-cell">
<br />


'''Powershell-Befehle'''
... und zum Abschluss die vPBX an der Microsoft Umgebung anmelden:


*https://teams.ihredomain.ch/oauth/ im Browser aufrufen
*Zugangsdaten eines berechtigten Users eingeben
*Zugriffsrechte bestätigen


===Schritt 5: Aktivieren von "Microsoft Teams Benutzer" und Eintragen der "MS Teams Telefonnummer" pro Teilnehmer auf der vPBX===
</div>
</div>
<div class="ac-layout-cell">
'''Anmerkungen / Screenshots'''


</div>
</div>


</div>
{{Layout}}
{{Layout}}
<div class="ac-layout-section two_equal">
<div class="ac-layout-section two_equal">
Zeile 829: Zeile 693:
<div class="ac-layout-cell">
<div class="ac-layout-cell">


<span id="import-des-microsoftteams-moduls"></span>
Alle Benutzer auf der PBX erstellen bzw. entsprechend dieser Regel ändern: Der Benutzername muss identisch sein, wie der Microsoft 365 Benutzername (ohne @Domain). Beispiel: wenn der Microsoft 365 Benutzer [mailto:hans.beispiel@beispielfirma.ch hans.beispiel@beispielfirma.ch] heisst, so muss der Benutzer auf der vPBX '''hans.beispiel''' heissen.
====== Import des MicrosoftTeams Moduls ======
 
<syntaxhighlight>Import-Module MicrosoftTeams</syntaxhighlight>
<br />


Bei jedem Teams Benutzer ist nach dem Erstellen die Option "Microsoft Teams Benutzer" zu aktivieren und die Telefonnummer (Format +41...), mit welcher der Benutzer in der Teams Umgebung verknüpft werden wird, unter "MS Teams Telefonnummer" einzutragen, siehe Screenshot rechts.


'''Update Juli 2021:''' Als "MS Teams Telefonnummer" muss keine gültige Telefonnummer verwendet werden und auch das Format +41... muss nicht beachtet werden: Es können auch (z. B. vierstellige) interne Telefonnummern verwendet werden, wie z. B. 1000, 1001, 1002 etc. <br />
Das Eintragen von Internen Nummern ins Feld "MS Teams Telefonnummer" scheint nur zuverlässig zu funktionieren wenn alle User ausschliesslich MS Teams verwenden. Ansonsten gibt es Probleme beim Weiterleiten von Anrufen von MS Teams zu Hardware-Telefonen oder CTI-Client. 


<br />
'''Update April 2024:''' Die "MS Teams Telefonnummer" darf keine Leerzeichen/Spaces enthalten.
 




</div>
</div>
<div class="ac-layout-cell">
<div class="ac-layout-cell">[[Datei:KB_VoIP_Telefonie_vPBX_Anbindung_MS_Teams_an_vPBX2021-09-21_09_14_29-172.18.5.89_-_Remotedesktopverbindung.png|center]]
 
</div>
<span>Falls das Modul noch nicht installiert ist, wie folgt installieren:</span>
 
<syntaxhighlight>Find-Module -Name MicrosoftTeams | Install-Module</syntaxhighlight>
Falls keine Rechte für's Ausführen von Scripten:
 
<syntaxhighlight>Set-ExecutionPolicy Unrestricted</syntaxhighlight>
Changelog Microsoft Teams PowerShell: https://docs.microsoft.com/de-de/MicrosoftTeams/teams-powershell-release-notes
 
<span id="modul-upgraden"></span>
====== Modul upgraden ======
 
<syntaxhighlight>Update-Module MicrosoftTeams</syntaxhighlight>
Welche Version vom MicrosoftTeams-Modul ist installiert?
 
<syntaxhighlight>Get-InstalledModule -Name MicrosoftTeams</syntaxhighlight>
 
</div>
</div>


</div>
{{Layout}}
{{Layout}}
<div class="ac-layout-section two_equal">
<div class="ac-layout-section two_left_sidebar">
 
<div class="ac-layout-cell">
<div class="ac-layout-cell">
 
Die "MS Teams UUID" muss hier kopiert werden ...
<span id="credentials-objekt-erstellen-zugangsdaten-eines-office365-admins-werden-benötigt"></span>
====== Credentials-Objekt erstellen (Zugangsdaten eines Office365-Admins werden benötigt) ======
 
<syntaxhighlight>Connect-MicrosoftTeams</syntaxhighlight>
 
</div>
</div>
<div class="ac-layout-cell">
<div class="ac-layout-cell">
 
[[Datei:VoIP Telefonie vPBX Anbindung MS Teams an vPBX 1763022236599.png|center]]
Hier müssen die Zugangsdaten vom Admin-User eingegeben werden.
</div>
 
<br />
 
 
 
</div>
</div>


{{Layout}}
<div class="ac-layout-section two_left_sidebar">
<div class="ac-layout-cell">
... und hier reinkopiert werden:
</div>
</div>
{{Layout}}
<div class="ac-layout-section single">
<div class="ac-layout-cell">
<div class="ac-layout-cell">
 
[[Datei:VoIP Telefonie vPBX Anbindung MS Teams an vPBX 1763022354066.png|center]]
<span id="schritt-7-pstn-gateway-erstellen-einmalig"></span>
</div>
= <span style="color: rgb(23,43,77);">Schritt 7: PSTN-Gateway erstellen </span>(einmalig) =
 
 
</div>
</div>


</div>
{{Layout}}
{{Layout}}
<div class="ac-layout-section two_equal">
<div class="ac-layout-section two_equal">
Zeile 902: Zeile 733:
<div class="ac-layout-cell">
<div class="ac-layout-cell">


MSTEAMS_FQDN = teams.ihredomain.ch
Wenn die Teams-"Anmeldungen" grün sind, stimmen sie:
<br />
 
<span id="gateway-erstellen-und-direct-routing-service-verbinden-msteams_url-wird-ihnen-von-iway-ag-mitgeteilt"></span>
====== Gateway erstellen und Direct Routing Service verbinden (MSTEAMS_URL wird Ihnen von iWay AG mitgeteilt) ======
 
<syntaxhighlight>New-CsOnlinePSTNGateway -Fqdn MSTEAMS_FQDN -MaxConcurrentSessions 100 -Enabled $true -ForwardPai $true -ForwardCallHistory $true</syntaxhighlight>
{{Note
|body =
 
Sie werden nun nach dem SipSignalingPort (PORT_VON_SBC) gefragt. Geben Sie hier 5061 ein.
 
}}




</div>
</div>
<div class="ac-layout-cell">
<div class="ac-layout-cell">[[Datei:Anbindung MS Teams an vPBX 1713958918135.png|zentriert]]


Mit dem folgenden Befehl kann die Konfiguration überprüft werden:


<syntaxhighlight>Get-CsOnlinePSTNGateway</syntaxhighlight>
PSTN-Gateway wieder löschen:


<syntaxhighlight>Remove-CsOnlinePSTNGateway -Identity MSTEAMS_FQDN</syntaxhighlight>


</div>
</div>


</div>
</div>
{{Layout}}
{{Layout}}
<div class="ac-layout-section single">
<div class="ac-layout-section single">


<div class="ac-layout-cell">
<div class="ac-layout-cell">
 
===Schritt 6: Konfiguration Direct Routing Service===
<span id="schritt-8-voice-routing-und-entsprechende-policy-einrichten-einmalig"></span>
= Schritt 8: Voice Routing und entsprechende Policy einrichten (einmalig) =




Zeile 943: Zeile 757:
</div>
</div>
{{Layout}}
{{Layout}}
<div class="ac-layout-section two_equal">
<div class="ac-layout-section two_left_sidebar">


<div class="ac-layout-cell">
<div class="ac-layout-cell">


<span id="pstn-usage-erstellen"></span>
Unter "VoIP" / "Direct Routing" den SBC wie folgt eintragen:
== PSTN-Usage erstellen ==


<syntaxhighlight>Set-CsOnlinePstnUsage -Identity Global -Usage @{Add=&quot;Unrestricted&quot;}</syntaxhighlight>


</div>
</div>
<div class="ac-layout-cell">
<div class="ac-layout-cell">[[Datei:Anbindung MS Teams an vPBX 1712915150240.png]]
</div>
</div>


<br />
===Schritt 7: VoIP-Routingrichtlinie erstellen===
 
 
 
</div>


</div>
{{Layout}}
{{Layout}}
<div class="ac-layout-section two_equal">
<div class="ac-layout-section two_left_sidebar">


<div class="ac-layout-cell">
<div class="ac-layout-cell">


<span id="route-erstellen"></span>
Unter "VoIP" / "VoIP-Routingrichtlinie" die entsprechende VoIP-Routingrichtlinie erstellen: <br />
== Route erstellen ==
<br />
 
Es kann sein, dass man das Menü suchen muss:<br />
<syntaxhighlight>New-CsOnlineVoiceRoute -Identity &quot;Unrestricted&quot; -OnlinePstnGatewayList MSTEAMS_FQDN -Priority 1 -OnlinePstnUsages &quot;Unrestricted&quot; -NumberPattern &quot;.*&quot;</syntaxhighlight>
<br />
[[Datei:VoIP Telefonie vPBX Anbindung MS Teams an vPBX 1763021802621.png|left]]


</div>
<div class="ac-layout-cell">


Überprüfen der Route
</div>[[Datei:Anbindung MS Teams an vPBX 1712915328610.png]]<div class="ac-layout-cell">


<syntaxhighlight>Get-CsOnlineVoiceRoute</syntaxhighlight>
<br />
OnlineVoiceRoute wieder löschen:


<syntaxhighlight>Remove-CsOnlineVoiceRoute -Identity &quot;Unrestricted&quot;</syntaxhighlight>


</div>
</div>
Zeile 986: Zeile 792:
</div>
</div>
{{Layout}}
{{Layout}}
<div class="ac-layout-section two_equal">
<div class="ac-layout-section single">


<div class="ac-layout-cell">
<div class="ac-layout-cell">
===Schritt 8: VoIP-Route erstellen===


<span id="user-routing-policy-erstellen"></span>
== <span>User-Routing-Policy erstellen</span> ==


<syntaxhighlight>New-CsOnlineVoiceRoutingPolicy &quot;Unrestricted&quot; -OnlinePstnUsages &quot;Unrestricted&quot;</syntaxhighlight>
</div>


</div>
</div>
{{Layout}}
<div class="ac-layout-section two_left_sidebar">
<div class="ac-layout-cell">
<div class="ac-layout-cell">


<span>Überprüfen der User-Routing-Policy:</span>
Unter "VoIP" / "Direct Routing" / "VoIP-Routen" die entsprechende Route erstellen:
 
<syntaxhighlight>Get-CsOnlineVoiceRoutingPolicy</syntaxhighlight>
OnlineVoiceRoutingPolicy wieder löschen:
<br />


<syntaxhighlight>Remove-CsOnlineVoiceRoutingPolicy -Identity &quot;Unrestricted&quot;</syntaxhighlight>


</div>
</div>
 
<div class="ac-layout-cell">[[Datei:Anbindung MS Teams an vPBX 1712915511882.png]]
</div>
{{Layout}}
<div class="ac-layout-section single">
 
<div class="ac-layout-cell">
 
<span id="schritt-9-benutzer-aktivieren-und-ms-teams-uuid-auf-vpbx-eintragen-für-jeden-benutzer"></span>
= Schritt 9: Benutzer aktivieren und MS Teams UUID auf vPBX eintragen (für jeden Benutzer) =




Zeile 1'026: Zeile 820:


<div class="ac-layout-cell">
<div class="ac-layout-cell">
 
===Schritt 9: Rufnummern den Benutzern zuweisen===
<span id="powershell-einträge"></span>
== <span style="font-size: 20.0px;letter-spacing: -0.008em;">Powershell-Einträge</span> ==
 
 
</div>
</div>


</div>
</div>
{{Layout}}
{{Layout}}
<div class="ac-layout-section two_equal">
<div class="ac-layout-section two_left_sidebar">


<div class="ac-layout-cell">
<div class="ac-layout-cell">


<span style="letter-spacing: 0.0px;font-size: 16.0px;">Benutzer aktivieren, Telefonnummer und Voicemail Box zuweisen:</span>
Unter "Benutzer" den entsprechenen Benutzer bearbeiten, auf "Bearbeiten" klicken ...
 
{| class="wikitable wrapped"
|-
| OFFICE365_USER
| Username des Microsoft 365-Accounts (z. B.: max.muster@ihredomain.ch)
|-
| RUFNUMMER
| &quot;MS Teams Telefonnummer&quot; der vPBX im Format +41435001111
 
Update 1.7.21: Offensichtlich können dort beliebige Nummern gewählt werden, auch z. B. vierstellige, interne Nummern.


|}
<syntaxhighlight>Set-CsPhoneNumberAssignment -Identity OFFICE365_USER -PhoneNumber RUFNUMMER -PhoneNumberType DirectRouting
Set-CsPhoneNumberAssignment -Identity OFFICE365_USER -EnterpriseVoiceEnabled $true</syntaxhighlight>
<span style="font-size: 16.0px;letter-spacing: -0.006em;">Zuweisen der User-Routing-Policy:</span>
<syntaxhighlight>Grant-CsOnlineVoiceRoutingPolicy -Identity OFFICE365_USER -PolicyName "Unrestricted"</syntaxhighlight>


</div>
</div>
<div class="ac-layout-cell">
<div class="ac-layout-cell">


[[File:KB_VoIP_Telefonie_vPBX_Anbindung_MS_Teams_an_vPBXimage2021-3-18_17-39-38.png]]
[[File:KB_VoIP_Telefonie_Anbindung_MS_Teams_an_Business_Trunk_Anleitung_Anbindung_MS_Teams_an_Business_Trunkimage-2023-10-4_13-21-36.png]]
 
<br />
 




Zeile 1'072: Zeile 842:
</div>
</div>
{{Layout}}
{{Layout}}
<div class="ac-layout-section single">
<div class="ac-layout-section two_left_sidebar">


<div class="ac-layout-cell">
<div class="ac-layout-cell">


<span id="ms-teams-uuid-pro-benutzer-auslesen-und-in-die-vpbx-übertragen"></span>
... und auf der rechten Seite die Telefonnummer im <span style="color: rgb(51,51,51);">im internationalen Format (E.164), z. B. </span>+41435001111 eintragen:
== MS Teams UUID pro Benutzer auslesen und in die vPBX übertragen ==
 
 
</div>
<div class="ac-layout-cell">[[Datei:Anbindung MS Teams an vPBX 1712915704707.png]]




Zeile 1'084: Zeile 857:
</div>
</div>
{{Layout}}
{{Layout}}
<div class="ac-layout-section two_equal">
<div class="ac-layout-section two_left_sidebar">


<div class="ac-layout-cell">
<div class="ac-layout-cell">


Neue PowerShell Session mit dem Azure Active Directory verbinden
Dem User die die <span>VoIP-Routingrichtlinie </span>"Unrestricted" <span style="letter-spacing: 0.0px;">zuweisen:</span>


<syntaxhighlight>Import-Module AzureAD
Connect-AzureAD</syntaxhighlight>


</div>
</div>
<div class="ac-layout-cell">
<div class="ac-layout-cell">


<span>Falls das Modul noch nicht installiert ist, wie folgt installieren:</span>
[[File:KB_VoIP_Telefonie_Anbindung_MS_Teams_an_Business_Trunk_Anleitung_Anbindung_MS_Teams_an_Business_Trunkimage-2023-11-10_15-55-0.png]]


<syntaxhighlight>Find-Module -Name AzureAD | Install-Module</syntaxhighlight>


</div>
</div>
Zeile 1'104: Zeile 874:
</div>
</div>
{{Layout}}
{{Layout}}
<div class="ac-layout-section two_equal">
<div class="ac-layout-section single">


<div class="ac-layout-cell">
<div class="ac-layout-cell">


Pro Benutzer die '''ObjectId''' auslesen...
<syntaxhighlight>Get-AzureADUser -ObjectId "vorname.nachname@ihredomain.ch"</syntaxhighlight>
</div>
<div class="ac-layout-cell">


<span>Ausgabe wie folgt:<br />
-----
</span>


<syntaxhighlight>ObjectId DisplayName UserPrincipalName UserType
-------- ----------- ----------------- --------
abcabcab-abca-abca-abca-abcabcabcabc Hans Beispiel hans.beispiel@ihredomain.ch Member</syntaxhighlight>


</div>
</div>
Zeile 1'126: Zeile 886:
</div>
</div>
{{Layout}}
{{Layout}}
<div class="ac-layout-section two_equal">
<div class="ac-layout-section single">


<div class="ac-layout-cell">
<div class="ac-layout-cell">
===Hinweise zum Status nach der Inbetriebnahme===


...und auf beim vPBX-Teilnehmer im Feld '''&quot;MS Teams UUID&quot;''' auf der vPBX eintragen:
====Ein- und ausgehende Telefonie kann evtl. nicht sofort nach der Inbetriebnahme funktionieren====
 
{{Textbox
<br />
|boxtype=tip
|header=
|text=
Es kann sein, dass die ein- und ausgehende Telefonie erst ein paar Minuten nach der Inbetriebnahme funktioniert.
|icon=yes}}


====Unter "VoIP" / "Direct Routing" können Fehler angezeigt werden====
Es kann sein, dass  unter "VoIP" / "Direct Routing" können Fehler angezeigt werden, wie diese hier:


[[Datei:Anbindung MS Teams an Business Trunk 1711019123117.png]]


</div>
Solange die Telefonie über Ihr Teams läuft, ist alles in Ordnung.
<div class="ac-layout-cell">
 
[[File:KB_VoIP_Telefonie_vPBX_Anbindung_MS_Teams_an_vPBXimage2021-3-18_17-30-31.png]]
 
 
</div>
 
</div>
 
</div>
[[Category:Teams]] [[Category:Vpbx]] [[Category:Microsoft]] [[Category:Ms]]
{{AttachmentsSectionStart}}
* [[Medium:KB_VoIP_Telefonie_vPBX_Anbindung_MS_Teams_an_vPBXimage2021-1-14_16-51-19.png]]
* [[Medium:KB_VoIP_Telefonie_vPBX_Anbindung_MS_Teams_an_vPBXimage2021-1-14_17-4-57.png]]
* [[Medium:KB_VoIP_Telefonie_vPBX_Anbindung_MS_Teams_an_vPBXimage2021-1-14_17-35-19.png]]
* [[Medium:KB_VoIP_Telefonie_vPBX_Anbindung_MS_Teams_an_vPBXimage2021-2-25_14-31-35.png]]
* [[Medium:KB_VoIP_Telefonie_vPBX_Anbindung_MS_Teams_an_vPBXimage2021-2-25_14-32-51.png]]
* [[Medium:KB_VoIP_Telefonie_vPBX_Anbindung_MS_Teams_an_vPBXimage2020-2-18_16-46-51.png]]
* [[Medium:KB_VoIP_Telefonie_vPBX_Anbindung_MS_Teams_an_vPBXimage2021-3-18_16-45-29.png]]
* [[Medium:KB_VoIP_Telefonie_vPBX_Anbindung_MS_Teams_an_vPBXimage2021-3-18_16-46-20.png]]
* [[Medium:KB_VoIP_Telefonie_vPBX_Anbindung_MS_Teams_an_vPBXimage2021-3-18_16-47-6.png]]
* [[Medium:KB_VoIP_Telefonie_vPBX_Anbindung_MS_Teams_an_vPBXimage2021-3-18_16-53-14.png]]
* [[Medium:KB_VoIP_Telefonie_vPBX_Anbindung_MS_Teams_an_vPBXimage2021-3-18_17-10-24.png]]
* [[Medium:KB_VoIP_Telefonie_vPBX_Anbindung_MS_Teams_an_vPBXimage2021-3-18_17-10-43.png]]
* [[Medium:KB_VoIP_Telefonie_vPBX_Anbindung_MS_Teams_an_vPBXimage2021-7-15_13-39-32.png]]
* [[Medium:KB_VoIP_Telefonie_vPBX_Anbindung_MS_Teams_an_vPBXimage2020-2-18_16-46-51.png]]
* [[Medium:KB_VoIP_Telefonie_vPBX_Anbindung_MS_Teams_an_vPBXimage2021-2-25_14-32-51.png]]
* [[Medium:KB_VoIP_Telefonie_vPBX_Anbindung_MS_Teams_an_vPBXimage2021-2-25_14-31-35.png]]
* [[Medium:KB_VoIP_Telefonie_vPBX_Anbindung_MS_Teams_an_vPBXimage2021-3-18_17-10-43.png]]
* [[Medium:KB_VoIP_Telefonie_vPBX_Anbindung_MS_Teams_an_vPBXimage2021-3-18_17-10-24.png]]
* [[Medium:KB_VoIP_Telefonie_vPBX_Anbindung_MS_Teams_an_vPBXimage2021-3-18_16-53-14.png]]
* [[Medium:KB_VoIP_Telefonie_vPBX_Anbindung_MS_Teams_an_vPBXimage2021-3-18_16-47-6.png]]
* [[Medium:KB_VoIP_Telefonie_vPBX_Anbindung_MS_Teams_an_vPBXimage2021-3-18_16-46-20.png]]
* [[Medium:KB_VoIP_Telefonie_vPBX_Anbindung_MS_Teams_an_vPBXimage2021-3-18_16-45-29.png]]
* [[Medium:KB_VoIP_Telefonie_vPBX_Anbindung_MS_Teams_an_vPBXimage2021-1-14_17-4-57.png]]
* [[Medium:KB_VoIP_Telefonie_vPBX_Anbindung_MS_Teams_an_vPBXimage2021-1-14_16-51-19.png]]
* [[Medium:KB_VoIP_Telefonie_vPBX_Anbindung_MS_Teams_an_vPBXimage2021-1-14_17-35-19.png]]
* [[Medium:KB_VoIP_Telefonie_vPBX_Anbindung_MS_Teams_an_vPBXimage2021-7-15_13-39-32.png]]
 
{{AttachmentsSectionEnd}}
 
<!-- From bodyContent 42238058.mraw -->

Aktuelle Version vom 13. November 2025, 10:32 Uhr

Anleitung von Hersteller wwcom

https://doku.wwcom.ch/books/ms-teams/page/ms-teams

Voraussetzungen für Anbindung von MS Teams an die vPBX

Erstens: Die richtige Telefon-Lizenz für jeden User, welcher "in die weite Welt" telefonieren will

LizenzenLizenz "Microsoft Teams Telefon Standard" pro User oder eine Lizenz, welche diese Option enthält.


iWay AG bietet im Moment keine Microsoft-Lizenzen an.


Zweitens: Admin-Zugriff auf Microsoft 365

Zugriffe/BerechtigungenZugriff auf Microsoft 365 Admin: https://admin.microsoft.com/
Zugriff auf Microsoft 365 Teams Admin: https://admin.teams.microsoft.com/


Vorbemerkungen zur MS Teams Domain

Es wird davon ausgegangen, dass Sie die Domain "ihredomain.ch" schon in MS Teams verwenden. Es werden nun folgende 5 DNS-Einträge hinzugefügt: 4 Einträge für "Skype for Business" und A-Record von teams.ihredomain.ch auf Ihre vPBX xyz.vpbx.iway.ch.


Nach der Umstellung wird Ihre vPBX nur noch unter https://teams.ihredomain.ch erreichbar sein, da nicht zwei SSL-Zertifikate auf eine vPBX zeigen können. Ihre zuvor angemeldeten Telefone/CTI-Clients müssen entsprechend umkonfiguriert/neu provisioniert werden. Ebenfalls müssen die Teilnehmer-Logins den MS-Teams-Usern angeglichen werden, d. h. die Teilnehmer-Logins auf der vPBX müssen ebenfalls vorname.nachname lauten.


Inhalt:

Schritt 1: Einrichten der Domain

Dieser Schritt zeigt das Einrichten der Domain im "Microsoft 365 admin center" unter https://admin.microsoft.com/AdminPortal/Home#/Domains.




Erstellen der DNS-Server-Einträge

Tragen Sie auf Ihren DNS-Servern folgende Einträge für Ihre Domain "ihredomain.ch" ein:


Hostname Domain TTL IN Type Prio Content
sip .ihredomain.ch 3600 IN CNAME
sipdir.online.lync.com
lyncdiscover .ihredomain.ch 3600 IN CNAME
webdir.online.lync.com
_sip._tls .ihredomain.ch 3600 IN SRV 100 1 443 sipdir.online.lync.com
_sipfederationtls._tcp .ihredomain.ch 3600 IN SRV 100 1 5061 sipfed.online.lync.com


Erstellen Sie auch noch folgenden A-Eintrag, bei welchem teams.ihredomain.ch auf die IP Ihrer vPBX xyz.vpbx.iway.ch zeigt:


Hostname Domain TTL IN Type Prio Content
teams .ihredomain.ch 3600 IN A
IP.der.iWay.vPBX


Die IP Ihrer vPBX ist unten links zu finden:



Zum Zeitpunkt der Umstellung der vPBX auf Teams muss dieser DNS-Eintrag weltweit verfügbar sein, da sonst das nötige Zertifikat nicht erstellt werden kann.


Aktivierung Ihrer Domain für "Skype for Business"

Öffnen Sie https://admin.microsoft.com/AdminPortal/Home#/Domains 

Klicken Sie auf "ihredomain.ch" (jene Domain, welche Sie schon für sich eingerichtet ist):



Klicken Sie auf "DNS records" und dann auf "Manage DNS":



Klicken Sie unten auf "Continue":



Setzen Sie hier das Häkchen unter "Advanced Options" bei "Skype for Business":



Überprüfen Sie die DNS-Einträge und schliessen Sie diesen Schritt ab.


Schritt 2: Weisen Sie den MS Teams Usern die richtige Microsoft Lizenz zu

MS Lizenzen
  • Bei Enterprise Lizenzen braucht es entweder eine E5 Lizenz (keine weitere Zusatzlizenz nötig) oder eine E3 Lizenz mit Phone System add-on (und, falls Konferenzen getätigt werden sollen, Audio Conferencing add-on)
  • Bei Microsoft 365 Lizenzen braucht es zusätzlich pro Benutzer die "Phone System"-Lizenz


Weisen Sie unter "Users" / "Active Users" den MS Teams Usern die richtige Microsoft Linzenz zu:



Schritt 3: Auf vPBX "Teams-Kompatibilitätsmodus" einschalten und Domain ändern

Zu diesem Zeitpunkt muss der neue DNS-Eintrag (teams.ihredomain.ch) weltweit verfügbar sein, da sonst das nötige Zertifikat nicht erstellt werden kann. Nach dieser Umstellung ist Ihre vPBX nur noch unter https://teams.ihredomain.ch mit Zertifikat erreichbar. Alle Telefone und CTI-Clients müssen auf die neue Domain umkonfiguriert werden.


Im Menü "PBX Einstellungen" unter "Allgemeine Einstellungen" den Hostname (z. B. "teams") und die Domain (ihredomain.ch) angeben und auf "Speichern" klicken:




Auf der vPBX unter "PBX Einstellungen" bei "Teams-Kompatibilitätsmodus" auf "VoIP+Presence" umstellen und auf "Speichern" klicken:



Danach die vPBX neu starten:




Schritt 4 / Variante 1: In Entra Wert-Schlüssel-Paar erzeugen und auf vPBX übertragen

In diesem Schritt wird in Entra ein Wert-Schlüssel-Paar ("Teams app id" / "Teams app key") erstellt, welches zur Abfrage des Presence-Status von MS Teams nötig ist.


"Anwendungs-ID (Client)" erstellen


Entra öffnen (https://portal.Entra.com/) und dann unter "Entra Active Directory" / "App-Registrierungen" eine "Neue Registrierung" erstellen:


Direktlink: https://portal.Entra.com/#blade/Microsoft_AAD_IAM/ActiveDirectoryMenuBlade/RegisteredApps




Unter "Name" einen frei gewählten Namen angeben, z. B. "iwayteamsbridge" (es kann eine eigene Bezeichnung verwendet werden):



Bei "Unterstützte Kontotypen" "Nur Konten in diesem Organisationsverzeichnis" auswählen:




Unter "Umleitung-URI (optional)" die neue URL Ihrer vPBX https://teams.ihredomain.ch/oauth/ angeben:

Zuunterst auf "Registrieren" klicken.


Den Wert hinter "Anwendungs-ID (Client)" kopieren ....


... und auf der vPBX in den"PBX Einstellungen" ins Feld "Teams app id" kopieren:



"Geheimer Clientschlüssel" erzeugen

Unter "Zertifikate & Geheimnisse" auf "Neuer geheimer Clientschlüssel" klicken, ...




... "Geheimen Clientschlüssel hinzufügen", ...



... diesen auf der vPBX in den "PBX Einstellungen" ins Feld "Teams app key" kopieren und danach auf "Speichern" klicken.



API-Berechtigungen

API-Berechtigungen müssen folgende gesetzt werden:

  • User.Read
  • Presence.Read
  • Presence.ReadAll


Authentifizierung der vPBX an Teams

Zum Abschluss die vPBX an der Microsoft Umgebung anmelden:


Schritt 4 / Variante 2: In Entra Zertifikat

Das öffentliche Zertifikat von der vPBX herunterladen ...


... und hier hochladen ...


... und zum Abschluss die vPBX an der Microsoft Umgebung anmelden:

Schritt 5: Aktivieren von "Microsoft Teams Benutzer" und Eintragen der "MS Teams Telefonnummer" pro Teilnehmer auf der vPBX

Alle Benutzer auf der PBX erstellen bzw. entsprechend dieser Regel ändern: Der Benutzername muss identisch sein, wie der Microsoft 365 Benutzername (ohne @Domain). Beispiel: wenn der Microsoft 365 Benutzer hans.beispiel@beispielfirma.ch heisst, so muss der Benutzer auf der vPBX hans.beispiel heissen.

Bei jedem Teams Benutzer ist nach dem Erstellen die Option "Microsoft Teams Benutzer" zu aktivieren und die Telefonnummer (Format +41...), mit welcher der Benutzer in der Teams Umgebung verknüpft werden wird, unter "MS Teams Telefonnummer" einzutragen, siehe Screenshot rechts.

Update Juli 2021: Als "MS Teams Telefonnummer" muss keine gültige Telefonnummer verwendet werden und auch das Format +41... muss nicht beachtet werden: Es können auch (z. B. vierstellige) interne Telefonnummern verwendet werden, wie z. B. 1000, 1001, 1002 etc. 
Das Eintragen von Internen Nummern ins Feld "MS Teams Telefonnummer" scheint nur zuverlässig zu funktionieren wenn alle User ausschliesslich MS Teams verwenden. Ansonsten gibt es Probleme beim Weiterleiten von Anrufen von MS Teams zu Hardware-Telefonen oder CTI-Client. 

Update April 2024: Die "MS Teams Telefonnummer" darf keine Leerzeichen/Spaces enthalten.


Die "MS Teams UUID" muss hier kopiert werden ...

... und hier reinkopiert werden:

Wenn die Teams-"Anmeldungen" grün sind, stimmen sie:




Schritt 6: Konfiguration Direct Routing Service

Unter "VoIP" / "Direct Routing" den SBC wie folgt eintragen:


Schritt 7: VoIP-Routingrichtlinie erstellen

Unter "VoIP" / "VoIP-Routingrichtlinie" die entsprechende VoIP-Routingrichtlinie erstellen:

Es kann sein, dass man das Menü suchen muss:




Schritt 8: VoIP-Route erstellen

Unter "VoIP" / "Direct Routing" / "VoIP-Routen" die entsprechende Route erstellen:



Schritt 9: Rufnummern den Benutzern zuweisen

Unter "Benutzer" den entsprechenen Benutzer bearbeiten, auf "Bearbeiten" klicken ...



... und auf der rechten Seite die Telefonnummer im im internationalen Format (E.164), z. B. +41435001111 eintragen:



Dem User die die VoIP-Routingrichtlinie "Unrestricted" zuweisen:





Hinweise zum Status nach der Inbetriebnahme

Ein- und ausgehende Telefonie kann evtl. nicht sofort nach der Inbetriebnahme funktionieren

Es kann sein, dass die ein- und ausgehende Telefonie erst ein paar Minuten nach der Inbetriebnahme funktioniert.


Unter "VoIP" / "Direct Routing" können Fehler angezeigt werden

Es kann sein, dass unter "VoIP" / "Direct Routing" können Fehler angezeigt werden, wie diese hier:

Solange die Telefonie über Ihr Teams läuft, ist alles in Ordnung.

Von «https://wiki-docker.iway.ch/kb/index.php?title=VoIP_Telefonie/vPBX/Anbindung_MS_Teams_an_vPBX&oldid=4953»