# webmeeting - Integrationen

# Videoendpunkt

Vorbereitende Maßnahmen für die Integration eines Videoendpunktes. Z. B. für One Button to Push, Meeting-Kontrollen, Meeting Button und MS Teams Integration.

# Meeting Button

<p class="callout info">Der **Meeting Button** ist ein Button auf dem **Cisco Videoendpunkt** um **direkt** einem webmeeting per **Konferenz-ID beitreten** zu können. *Diese Funktion ist optional.*</p>

![image.png](https://kb.ntcx.eu/uploads/images/gallery/2024-12/scaled-1680-/v7vimage.png)

Dieser Button kann mithilfe des Macros **„Webmeeting Join Button“** hinzugefügt werden.

Die **Konfiguration** des Buttons können Sie [hier](https://kb.ntcx.eu/books/webmeeting-admin/page/panels-and-macros "Panels and macros") finden.

Die genaue **Funktionsweise** des Buttons wird [hier](https://kb.ntcx.eu/books/webmeeting-admin/page/panels-and-macros#bkmrk-join-button) erläutert.

# Meeting Kontrolle

<p class="callout info">Mit der Funktion **"Meeting Kontrolle"** ist es möglich **Moderatoren-Kontroll-Funktionen** für ein Meeting direkt auf dem **Cisco Videoendpunkt** zu nutzen. Beispielsweise das Entsperren des Meetings um Personen in ein gesperrtes Meeting einzulassen, andere Teilnehmer stumm zu schalten oder die Aufzeichnung zu starten/stoppen. *Diese Funktion ist optional.*</p>

[![image.png](https://kb.ntcx.eu/uploads/images/gallery/2025-01/scaled-1680-/image.png)](https://kb.ntcx.eu/uploads/images/gallery/2025-01/image.png)

Dieser Button kann mithilfe des Macros **"webmeeting Meeting Control"** hinzugefügt werden.

Die **Konfiguration** des Buttons können Sie [hier](https://kb.ntcx.eu/books/webmeeting-admin/page/panels-and-macros "Panels and macros") finden.

Die genaue **Funktionsweise** des Buttons wird [hier](https://kb.ntcx.eu/books/webmeeting-admin/page/panels-and-macros#bkmrk-meeting-controls) erläutert.

# One Button to Push (OBTP)

<p class="callout info">Hierbei geht es um die Anbindung des Videoendpunktes an eine Groupware (z. B. Microsoft Exchange) um das Gerät per Groupware einzuladen. Wenn ein Videoendpunkt mit eingeladen wird, erscheint einige Minuten vor dem Meeting dieses auf dem Display des Endgeräts inklusive eines Button, um direkt dem Meeting beizutreten. Diese Funktion ist optional. Mit dieser Funktion ist es ebenfalls möglich an Microsoft Teams Meetings teilzunehmen. Allerdings benötigt dies eine zusätzliche Lizenz.</p>

### Microsoft Exchange Server (on Premise)

#### Schritt 1: Erstellung Raumressource

Stellen Sie sicher, dass jeder **physische Raum**, in dem sich ein **OBTP-Endpunkt** befindet, über eine zugehörige **Raumressource** mit einer **E-Mail-Adresse in Exchange** verfügt. Alternativ können Sie auch dem Videoendpunkt eine eigene Raumressource mit einer E-Mail-Adresse in Exchange erstellen.

#### Schritt 2: Konfiguration der Raumressource

Aktivieren Sie die **automatische Kalenderverarbeitung** (auto calendar processing) für jede **Raumressource**, so dass der Raum automatisch **Besprechungsanfragen annimmt**, wenn er verfügbar ist und automatisch eine **Einladung ablehnt**, wenn er bereits gebucht ist.

##### Kalenderoptionen anpassen

Um die von OBTP angebotene Funktionalität voll auszunutzen, empfehlen wir Ihnen, für die entsprechenden Raum Ressourcen die folgenden **Kalenderbearbeitungsoptionen** gegenüber dem **Standard** zu **ändern**:

Der Text der Besprechungseinladung wird standardmäßig gelöscht. Wenn Sie möchten, dass OBTP die Besprechungsdetails aus dem Textkörper analysiert, müssen Sie die Eigenschaft ***DeleteComments*** auf ***False*** setzen. Wenn Sie diese Eigenschaft auf True setzen, können nur Informationen verwendet werden, die sich in der Kalenderkopfzeilen befinden (da der Textkörper gelöscht wird).  
Wenn eine Besprechungseinladung in einem Ressourcenpostfach eingeht, wird der Betreff der Besprechung standardmäßig gelöscht und durch den Namen des Organisators ersetzt.

Da OBTP auf die Besprechungseinladungen über die **Ressourcenpostfächer** zugreift, bedeutet dieses **Standardverhalten**, dass es keinen Zugriff auf den ursprünglichen Betreff hat. Sie können das Standardverhalten aus Datenschutzgründen beibehalten oder die Kalenderverarbeitungsoptionen für jedes Postfach so ändern, dass der Besprechungsbetreff verfügbar ist und somit auf den Endpunkten des Besprechungsraums angezeigt werden kann.

Das Kennzeichen **„Privat“** ist standardmäßig **deaktiviert**. Wenn Sie möchten, dass Besprechungen, die vom Organisator als privat gekennzeichnet sind, im Raumpostfach als privat gekennzeichnet bleiben, müssen Sie das Kennzeichen ***RemovePrivateProperty*** auf ***False*** setzen.  
Bei Raumressourcen, die mit **PowerShell-Befehlen** erstellt wurden, kann ***AutomateProcessing*** standardmäßig auf ***AutoUpdate*** gesetzt sein. In diesen Fällen sollte es in ***AutoAccept*** geändert werden.  
Wenn der Besprechungsraum die **Einladung** **annimmt**, wird eine Antwort an den **ursprünglichen Anfrager** gesendet (einschließlich Anfrager außerhalb Ihrer Organisation, wenn Sie die Weiterleitung externer Einladungen zugelassen haben). Um Verwirrung darüber zu vermeiden, warum sie eine Antwort von einem Raum erhalten, der nicht in ihrer ursprünglichen Einladung enthalten war, können Sie zusätzlichen **Text konfigurieren**, der an den Anfrager gesendet wird, indem Sie das Flag ***-AddAdditionalResponse*** und die Einstellung -AdditionalResponse verwenden.

Wenn Sie es Benutzern ermöglichen möchten, Einladungen von anderen Organisationen an Ihre OBTP-Raumressourcen weiterzuleiten, müssen Sie das Kennzeichen ***ProcessExternalMeetingMessages*** auf ***True*** setzen.  
-&gt; Dies ist erforderlich, da Sie Microsoft Teams-Einladungen von externen Organisationen erhalten und diese Einladungen an Ihre OBTP-Raumressourcen weiterleiten möchten.

<p class="callout info">**Powershell command:**  
Set-CalendarProcessing -Identity &lt;resource\_email&gt; -DeleteComments $False -DeleteSubject $False -AddOrganizerToSubject $False -RemovePrivateProperty $False -AutomateProcessing "AutoAccept" -AddAdditionalResponse $true -ProcessExternalMeetingMessages $true -AdditionalResponse "Die Teilnehmer können von diesem Raum aus über webmeeting OBTP an der Besprechung teilnehmen."</p>

#### Schritt 3: Erstellen eines Dienstkontos in Exchange

In diesem Schritt erstellen Sie ein **Dienstkonto**, mit dem Sie sich bei Exchange anmelden, um auf die Kalender der Raumressourcen zuzugreifen, die für OBTP verwendet werden. Dieses **Servicekonto** sollte nur für OBTP verwendet werden. Sie können jedoch das gleiche Exchange-Servicekonto für **mehrere OBTP-Integrationen** verwenden.

Sie können ein neues **Dienstkonto** mit **PowerShell** wie folgt **erstellen**:

Mit dem **ersten Befehl** kann der Administrator ein **Kennwort** für das Dienstkonto als **sichere Zeichenfolge** eingeben. Diese Passwortvariable wird dann im **zweiten Befehl** verwendet, um ein **Postfach** für das Servicekonto zu **erstellen**. Der **dritte Befehl** stellt sicher, dass das **Kennwort** des Dienstkontos **nicht abläuft**.

<p class="callout info">**Powershell command:**  
$Passwort = Read-Host „Passwort eingeben“ -AsSecureString  
New-Mailbox -Name „&lt;Kontoname&gt;“ -UserPrincipalName „&lt;UPN&gt;“ -Passwort $password -Alias „&lt;Kontoname Alias&gt;“ -FirstName „&lt;Kontovorname&gt;“ -LastName „&lt;Kontonachname&gt;“ -DisplayName „&lt;Kontoname&gt;“  
Set-ADUser -Identity „&lt;UPN&gt;“ -PasswordNeverExpires $true</p>

<p class="callout info">**Beispiel:**   
New-Mailbox -Name „Webmeeting OBTP Service Account“ -UserPrincipalName webmeeting-obtp-svc@domain.com -Password $password -Alias webmeeting-obtp-svc -FirstName „webmeeting OBTP“ -LastName „Service Account“ -DisplayName „webmeeting OBTP Service Account“  
Set-ADUser -Identity webmeeting-obtp-svc@domain.com -PasswordNeverExpires $true</p>

#### Schritt 4: Konfigurieren der Anwendungs-Impersonation (Impersonation) auf dem Dienstkonto

In diesem Schritt **erstellen** Sie eine neue **Verteilergruppe** und fügen die Räume, die für OBTP verwendet werden sollen, der **Gruppe** hinzu. Anschließend stellen Sie mit PowerShell-Befehlen sicher, dass das Dienstkonto nur die Mitglieder dieser Gruppe impersonieren kann.  
Die Konfiguration der **Anwendungs-Impersonation** auf diese Weise bedeutet, dass, wenn **Räume** zur Gruppe **hinzugefügt** oder aus ihr **entfernt** werden, **automatisch aktualisiert** wird, ob das Dienstkonto sie impersonieren kann oder nicht.

##### Erstellen einer neuen Verteilergruppe

Melden Sie sich in Ihrem Exchange Admin Center als Administrator an und gehen Sie zu **Empfänger -&gt; Gruppen**.  
Wählen Sie das **+-Symbol** und wählen Sie **"eine neue Verteilergruppe hinzufügen"**.  
Fügen Sie die Räume, die Sie impersonieren möchten, der Gruppe hinzu.  
Beachten Sie, dass das Dienstkonto nicht als Mitglied dieser Verteilergruppe hinzugefügt werden sollte. Stattdessen erlaubt dieser Schritt dem Dienstkonto, jedes Mitglied dieser Verteilergruppe zu impersonieren (d.h. jede der Raumressourcen).  
Stellen Sie sicher, dass Sie die Option, den **Gruppenbesitzer zum Gruppenmitglied** zu machen, **deaktivieren**. Andernfalls kann sich das Dienstkonto als Ihr Konto ausgeben.  
Vergewissern Sie sich auch, dass Sie die **Gruppe sperren**, damit sich niemand versehentlich als **Gruppenmitglied hinzufügen** kann. Wählen Sie dazu **"Geschlossen: Mitglieder können nur von den Gruppeneigentümern hinzugefügt oder entfernt werden."**  
Wir empfehlen, dass Sie kombinierte PowerShell-Befehle verwenden, um die Anwendungsvertretung für das Dienstkonto zu konfigurieren. Auf diese Weise können Sie **Variablen** verwenden und so mögliche **Fehler** beim **Kopieren** und **Einfügen** reduzieren.  
Konfigurieren Sie die folgenden Variablen mit den Werten, die Sie tatsächlich verwenden wollen:

<p class="callout info">otj\_group\_id: die E-Mail-Adresse der Verteilerliste, deren Mitglieder Sie impersonieren möchten.  
otj\_service\_account: die E-Mail-Adresse des Dienstkontos, dem Sie die Impersonation gewähren wollen.  
management\_scope\_to\_create: der Name, den der neu erstellte Verwaltungsbereich haben soll.  
impersonation\_role\_name\_to\_create: Der Name, den die neu erstellte Impersonation-Rolle haben soll.</p>

<p class="callout info">**Zum Beispiel:**  
$obtp\_group\_id = „obtprooms@domain.com“  
$obtp\_service\_account = „webmeeting-obtp-svc@domain.com“  
$management\_scope\_to\_create = „OBTP Verwaltungsbereich“  
$impersonation\_role\_name\_to\_create = „OBTP Impersonation“  
Erstellen Sie den Verwaltungsbereich:  
$obtp\_group = Get-DistributionGroup -Identity $obtp\_group\_id  
$obtp\_group\_dn = $obtp\_group.DistinguishedName  
$restriction\_filter = „MemberOfGroup -eq ‚‘$obtp\_group\_dn“"“  
New-ManagementScope -Name $management\_scope\_to\_create -RecipientRestrictionFilter $restriction\_filter</p>

<p class="callout info">**Beispiel für die Ausgabe:**  
Name ScopeRestrictionType Exclusive RecipientRoot RecipientFilter  
-------------------------------------------------------------------------------------------------  
obtp Management Scope RecipientScope False MemberOfGroup -eq 'CN=obtp Rooms2111430164340,OU...  
Richten Sie die Anwendungsimpersonation unter Verwendung des zuvor erstellten Verwaltungsbereichs ein:  
New-ManagementRoleAssignment -Name $impersonation\_role\_name\_to\_create -Role ApplicationImpersonation -User $obtp\_service\_account -CustomRecipientWriteScope $management\_scope\_to\_create</p>

<p class="callout info">**Beispiel für die Ausgabe:** Name Rolle RoleAssigneeName RoleAssigneeType AssignmentMethod EffectiveUserName  
-------------------------------------------------------------------------------------------------  
obtp Impersonation ApplicationImp... webmeeting-obtp-svc User Direct</p>

  
Überprüfen Sie, ob die oben genannten Befehle wie erwartet funktionieren. Ersetzen Sie im folgenden Befehl ***&lt;resource\_email&gt;*** durch die E-Mail der **Mailbox** der Raumressource, die Sie **testen** möchten. Wenn es sich um einen Raum handelt, der Mitglied der **Verteilerliste** ist, sollte er die **OBTP-Impersonation** in den zurückgegebenen Rollen anzeigen. Wenn es sich um einen **anderen Raum** **außerhalb der Verteilerliste** handelt, sollte die OBTP-Impersonation nicht aufgeführt sein, was bedeutet, dass das **OBTP-Servicekonto** **keine Berechtigung** hat, diesen Benutzer zu **impersonieren**.

<p class="callout info">Get-ManagementRoleAssignment -Role ApplicationImpersonation -WritableRecipient "&lt;resource\_email&gt;" | Format-List Name, Role, RoleAssignee, CustomRecipientWriteScope</p>

<p class="callout info">**Beispiel für die Ausgabe:**  
Name: OBTP Impersonation  
Role: ApplicationImpersonation  
RoleAssignee: webmeeting-obtp-svc  
</p>

#### Schritt 5: Firewall-Einstellungen

Die webmeeting Server in unseren Rechenzentren benötigen Zugriff auf den Exchange Server EWS Dienst. Dafür müssen folgende Freischaltungen eingerichtet werden:

<table border="1" id="bkmrk-quelle-name-quelle-i" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 34.3094%;"></col><col style="width: 24.6599%;"></col><col style="width: 19.8947%;"></col><col style="width: 21.2051%;"></col></colgroup><tbody><tr><td>**Quelle Name**</td><td>**Quelle IP-Adresse**</td><td>**Ziel**</td><td>**Port**</td></tr><tr><td>ntcxdc1pxp01.netconnexhost.local </td><td>192.168.12.160</td><td>Exchange EWS</td><td>https (tcp/443)</td></tr><tr><td>ntcxdc1pxp02.netconnexhost.local</td><td>192.168.12.161</td><td>Exchange EWS</td><td>https (tcp/443)</td></tr><tr><td>ntcxdc2pxp02.netconnexhost.local</td><td>192.168.12.162</td><td>Exchange EWS</td><td>https (tcp/443)</td></tr><tr><td>ntcxdc1pxp03.netconnexhost.local</td><td>192.168.12.163</td><td>Exchange EWS</td><td>https (tcp/443)</td></tr><tr><td>ntcxdc2pxp03.netconnexhost.local</td><td>192.168.12.164</td><td>Exchange EWS</td><td>https (tcp/443)</td></tr><tr><td>ntcxdc1pxp05.webmeeting.eu</td><td>192.168.12.167</td><td>Exchange EWS</td><td>https (tcp/443)</td></tr><tr><td>ntcxdc2pxp05.webmeeting.eu</td><td>192.168.12.168</td><td>Exchange EWS</td><td>https (tcp/443)</td></tr></tbody></table>

Die webmeeting Server in unseren Rechenzentren benötigen ebenfalls Zugriff auf die Videoendpunkte um die entsprechenden Informationen zu den Meeting-Details zu senden. Dafür müssen folgende Freischaltungen eingerichtet werden:

<table border="1" id="bkmrk-quelle-name-quelle-i-1" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 34.3094%;"></col><col style="width: 24.6599%;"></col><col style="width: 19.8947%;"></col><col style="width: 21.2051%;"></col></colgroup><tbody><tr><td>**Quelle Name**</td><td>**Quelle IP-Adresse**</td><td>**Ziel**</td><td>**Port**</td></tr><tr><td>ntcxdc1pxp01.netconnexhost.local </td><td>192.168.12.160</td><td>Videoendpunkte</td><td>https (tcp/443)</td></tr><tr><td>ntcxdc1pxp02.netconnexhost.local</td><td>192.168.12.161</td><td>Videoendpunkte</td><td>https (tcp/443)</td></tr><tr><td>ntcxdc2pxp02.netconnexhost.local</td><td>192.168.12.162</td><td>Videoendpunkte</td><td>https (tcp/443)</td></tr><tr><td>ntcxdc1pxp03.netconnexhost.local</td><td>192.168.12.163</td><td>Videoendpunkte</td><td>https (tcp/443)</td></tr><tr><td>ntcxdc2pxp03.netconnexhost.local</td><td>192.168.12.164</td><td>Videoendpunkte</td><td>https (tcp/443)</td></tr><tr><td>ntcxdc1pxp05.webmeeting.eu</td><td>192.168.12.167</td><td>Videoendpunkte</td><td>https (tcp/443)</td></tr><tr><td>ntcxdc2pxp05.webmeeting.eu</td><td>192.168.12.168</td><td>Videoendpunkte</td><td>https (tcp/443)</td></tr></tbody></table>

# Outlook Addin

Konfigurationen für die Verteilung des Outlook Addins für die Erstellung/Änderung von webmeeting Einladungen über Outlook.

# Outlook Addin

<p class="callout info">In diesem Kapitel wird erklärt, wie das Outlook Addin für die Erstellung von Meetings über Outlook eingerichtet werden kann.</p>

#### **Microsoft Exchange Server (on Premise)**

##### Schritt 1: Manifest Datei

Um die benötigte Manifest Datei (xml) zu erhalten, wenden Sie sich bitte an <support.de@erp.ntcx.eu>. Diese wird Ihnen von netconnex zur Verfügung gestellt.

##### Schritt 2: Outlook Addin verteilen

Bitte folgen Sie für die Verteilung des Addins den Anweisungen aus diesem Microsoft-Artikel:

<p class="callout info">[https://learn.microsoft.com/en-us/exchange/install-or-remove-outlook-add-ins-2013-help](https://learn.microsoft.com/en-us/exchange/install-or-remove-outlook-add-ins-2013-help)</p>

#### **Microsoft 365**

##### Schritt 1: Manifest Datei

Um die benötigte Manifest Datei (xml) zu erhalten, wenden Sie sich bitte an <support.de@erp.ntcx.eu>. Diese wird Ihnen von netconnex zur Verfügung gestellt.

##### Schritt 2: Outlook Addin verteilen

Bitte folgen Sie für die Verteilung des Addins den Anweisungen aus diesem Microsoft-Artikel:

<p class="callout info">[https://learn.microsoft.com/en-us/microsoft-365/admin/manage/office-addins?view=o365-worldwide](https://learn.microsoft.com/en-us/microsoft-365/admin/manage/office-addins?view=o365-worldwide)</p>