Microsoft Teams-Integration einrichten (Private Cloud)

Diese Funktion ist verfügbar mit:

Du weißt nicht, welches Modul du verwendest? Lies mehr hier.

  • Engage - Intranet & Employee App
  • Microsoft 365 Integration

Wir haben eine neue MS Teams-App! Die Anweisungen in diesem Artikel gelten für die Konfiguration der neuen MS Teams-App. 

Möchtest du von einer alten zur neuen App wechseln? Lies unsere empfohlenen Schritte für einen erfolgreichen Übergang in diesem Artikel.

Benutzer können ihre Haiilo-Plattform und deren Inhalte ganz einfach direkt in MS Teams erkunden! Du hast die Wahl, ihnen die volle Erfahrung innerhalb von Teams zu bieten oder nur eine Ansicht deiner Startseiten. Wenn du dich für die volle Erfahrung entscheidest, können Benutzer alles direkt in Teams sehen und damit interagieren. Wenn du dich für die Ansicht nur mit Startseiten entscheidest, können sie Inhalte weiterhin liken und kommentieren, aber durch Klicken auf einen Link wird die Haiilo-Plattform in einem neuen Browser-Tab geöffnet.

Außerdem bekommen die Benutzer Benachrichtigungen über neue Blog-Beiträge, Studio-Beiträge, Erwähnungen, Community-Einladungen und Event-Einladungen. Wenn du auf eine Benachrichtigung klickst, kommst du zum entsprechenden Inhalt auf der Haiilo-Plattform, wo du den ganzen Beitrag sehen kannst. Der Inhalt wird in der Registerkarte „Home“ für Teams-Apps mit Vollansicht oder in einem neuen Browser-Tab für Apps mit nur Startseiten-Ansicht geöffnet. Wenn neue Benachrichtigungen verfügbar sind, wird in der App in Teams eine Zahl angezeigt, die dich darauf hinweist, dass du sie überprüfen solltest.

Um die Funktionalitäten der Microsoft Teams-Integration zu nutzen, musst du zuerst einen OpenID-Authentifizierungsanbieter einrichten und das Microsoft-Add-On aktivieren. Bitte schließe die Microsoft-Authentifizierungseinrichtung und die Add-On-Aktivierung ab, bevor du mit diesen Einrichtungsanweisungen fortfährst.

1. Aktualisiere deine Entra ID-App

Du benötigst Administratorrechte in deinem Microsoft Entra ID-Konto, um diese Schritte abzuschließen.

  1. Melde dich beim Microsoft Azure-Portal an.
  2. Gehe zu Microsoft Entra ID > App-Registrierungen > wähle die App aus, die du erstellt hast, als du die Microsoft-Authentifizierung und das Add-On für Haiilo eingerichtet hast.
  • 1. Manifest aktualisieren
    1. Gehe zu Manifest.
    2. Setze das Attribut "requestedAccessTokenVersion" auf 2. In einigen Versionen ist der Standardwert null und sollte auf 2 gesetzt werden.ms graph manifest token.png
  • 2. API-Berechtigungen definieren
    1. Gehe zu API-Berechtigungen.
    2. Berechtigungen hinzufügen > Microsoft Graph > Anwendungsrechte.
    3. Füge die folgenden API-Berechtigungen hinzu oder überprüfe, ob sie bereits hinzugefügt sind:
      • TeamsAppInstallation.ReadWriteSelfForUser.All
      • AppCatalog.Read.All
      • User.Read.All
    4. Wähle Admin-Einwilligung für app_name erteilen für die hinzugefügten Berechtigungen und stelle sicher, dass der Status für alle Berechtigungen als Erteilt für deinen_mandanten markiert ist.api permissions ms graph for teams.png
  • 3. Einen Bereich hinzufügen
    1. Gehe zu API veröffentlichen > Bereich hinzufügen
    2. Im Feld Anwendungs-ID-URI füge deine Plattform-Domain und die Microsoft-Anwendungs-ID in diesem Format hinzu:
      • api://deine_plattform-domain/applicationId . Beispiel: api://example.haiilo.app/e7d2fcb0-4c19-43a8-8ccc-2605be203fac
    3. Wähle Speichern und Fortfahren.
    4. Wenn das Anwendungs-ID-URI erfolgreich aktualisiert wurde, erscheint ein weiteres Pop-up. Fülle die Felder wie folgt aus:
      • Bereichsname: access_as_user
      • Wer kann zustimmen: Nur Admins
      • Admin-Einwilligungsanzeigename: access_as_user
      • Admin-Einwilligungsbeschreibung: access_as_user
      • Status: Aktiviert
    5. Wähle Bereich hinzufügen 
    6. Bestätige, dass das neue Anwendungs-ID-URI hinzugefügt wurde (diese URL wird immer als api://deine_plattform-domain/applicationId erstellt).
  • 4. Eine Client-Anwendung hinzufügen
    1. Wähle im gleichen Abschnitt wie oben (API veröffentlichen) Eine Client-Anwendung hinzufügen.
    2. Füge beide diese Client-IDs nacheinander hinzu:
      • 1fec8e78-bce4-4aaf-ab1b-5451cc387264 (Für die mobile und Desktop MS Teams App)
      • 5e3ce6c0-2b1f-4285-8d4b-75ee78787346 (Für die Browser MS Teams App)
    3. Wähle das Kontrollkästchen, um die Client-ID für den von dir erstellten Bereich zu autorisieren
    4. Wähle Anwendung hinzufügen
    5. Wiederhole dies für die andere Client-ID. Beide sind erforderlich.

Mach weiter mit den nächsten Schritten.

2. Erstelle einen MS Teams Bot

Um diese Schritte abzuschließen, brauchst du Zugriff auf dein Azure-Abonnement und die Berechtigung, Azure Bot-Ressourcen zu erstellen.

  • 1. Überprüfe die Microsoft Entra App-Registrierung
    1. Gehe in deiner App, die du im vorherigen Schritt erstellt hast, zur Übersichtsseite.
    2. Kopiere die folgenden Werte für die spätere Verwendung:
      • Application-(Client-)ID
      • Directory (tenant) ID
  • 2. Erstelle die Azure Bot-Ressource
    1. Suche in Azure in der Suchleiste nach Azure Bot und wähle es aus (Filter: Marketplace).azure bot.webp
    2. Wähle Erstellen.
    3. Konfiguriere die Ressource:
      • Bot-Name: Gib einen Namen für den Bot ein, zum Beispiel Haiilo Notifications.
      • Abonnement: Wähle das Azure-Abonnement aus, in dem der Bot erstellt werden soll.
      • Ressourcengruppe: Wähle eine Ressourcengruppe aus.
      • Preisstufe: Wähle die Stufe, die den Anforderungen deiner Organisation entspricht.
      • App-Typ Microsoft App ID: Wähle Single Tenant.
      • Erstellungstyp: Wähle Vorhandene App-Registrierung verwenden.
      • App-ID: Gib die Anwendungs-(Client-)ID der Microsoft Entra App-Registrierung ein, die du zuvor kopiert hast.
      • Mandanten-ID: Gib die Directory (tenant) ID deines Microsoft Entra-Mandanten ein, die du zuvor kopiert hast.
    4. Wähle Überprüfen + erstellen.
    5. Nach erfolgreicher Validierung wähle Erstellen.
    6. Wenn die Bereitstellung abgeschlossen ist, wähle Zur Ressource wechseln.
  • 3. Konfiguriere den Messaging-Endpunkt
    1. Gehe in der Azure Bot-Ressource zu Einstellungen > Konfiguration.
    2. Gib im Feld Messaging-Endpunkt deine Haiilo Plattform-URL gefolgt von /web/content-teams-bot/api/messages ein. Zum Beispiel: https://example.haiilo.app/web/content-teams-bot/api/messages
    3. Wähle Anwenden.
  • 4. Aktiviere den Microsoft Teams Kanal
    1. Gehe in der Azure Bot-Ressource zu Einstellungen > Kanäle.
    2. Wähle Microsoft Teams aus.
    3. Akzeptiere die Microsoft-Nutzungsbedingungen, falls du dazu aufgefordert wirst.
    4. Klicke auf Speichern oder Anwenden.

  • 5. Erstelle ein Client-Geheimnis für den Bot

    Wir empfehlen, ein eigenes Client-Geheimnis für den Bot zu erstellen, auch wenn die App-Registrierung bereits eines für die Authentifizierung hat.

    1. Gehe in der Azure Bot-Ressource zu Einstellungen > Konfiguration.
    2. Klicke neben der Microsoft App ID auf Passwort verwalten. Dadurch öffnet sich die Seite Client-Geheimnisse der zugehörigen Microsoft Entra App-Registrierung.manage password azure bot.webp
    3. Wähle Neues Client-Geheimnis aus.
    4. Gib einen aussagekräftigen Namen ein, zum Beispiel Haiilo Teams Bot.
    5. Wähle eine Ablaufzeit entsprechend der Sicherheitsrichtlinie deiner Organisation.
    6. Klicke auf Hinzufügen.
    7. Kopiere sofort den geheimen Wert und speichere ihn sicher. Der Wert kann später nicht mehr abgerufen werden.
      • Nach Ablauf des Geheimnisses musst du ein neues erstellen und es Haiilo bereitstellen, damit die Bot-Integration weiterhin funktioniert. Wir empfehlen, eine Erinnerung vor dem Ablaufdatum einzurichten.
  • 6. Gib die Bot-Informationen an Haiilo weiter
    1. Öffne ein Ticket in unserem Service Desk und gib folgende Informationen an:
      • Die Application (Client) ID der Microsoft Entra App-Registrierung
      • Den neu erstellten geheimen Wert. Teile das Client-Geheimnis nur über einen von deiner Organisation genehmigten sicheren Kanal.
      • Die Directory (tenant) ID

Haiilo wird den Bot für deine Private-Cloud-Umgebung konfigurieren. Sobald Haiilo bestätigt, dass die Konfiguration abgeschlossen ist, kannst du mit den nächsten Schritten fortfahren.

3. Lade Haiilos Teams-App-Manifest herunter

Du benötigst die Berechtigung "Integrationen verwalten", um diese Schritte abzuschließen.

  1. Gehe in Haiilo zu Administration > Integrationen > MS Teams.
  2. Aktiviere die MS Teams-Einstellungen.
  3. Scrolle nach unten und finde deinen Haiilo-Authentifizierungsanbieter, der mit deiner Entra-ID-App übereinstimmt. Wenn du mehrere Authentifizierungsanbieter hast, musst du die Teams-App für jeden separat einrichten.
  4. Wähle Herunterladen neben dem Authentifizierungsanbieter aus, um das Manifest herunterzuladen.
  5. Unter , aktiviere die MS Teams-App. Du kannst dies auch später tun, aber wir empfehlen, es jetzt zu erledigen, damit du es nicht vergisst. Dadurch wird sichergestellt, dass deine Teams-App aktiv ist, sobald sie veröffentlicht wird.
  6. Wähle das Plattformerlebnis für deine Teams-App(s) aus. Alle deine Apps werden dieselbe Ansicht verwenden. Du kannst die Ansicht später ändern, und sie wird sich auf bereits installierte MS Teams-Apps auswirken:
    • Haiilo gesamt: Deine Benutzer können das gesamte Haiilo-Plattform innerhalb der Teams-App erleben.
    • Nur Homepages: Deine Benutzer können nur die Startseiten innerhalb der Teams-App anzeigen. Sie können Beiträge auf der Timeline liken und kommentieren, aber die Auswahl eines anderen Elements öffnet die Plattform in einem Browser.
  7. Fahre mit den nächsten Schritten fort.

MS Teams-App in der Administration.png

Aus technischen Gründen im Zusammenhang damit, wie Microsoft Teams derzeit externe Integrationen behandelt, wird die Haiilo-Integration als iFrame eingebettet. Diese architektonische Einschränkung kann gelegentlich das Haiilo-Plattformerlebnis innerhalb von Teams beeinträchtigen. Dadurch können bestimmte Bereiche und Funktionen möglicherweise nicht genau so erscheinen oder funktionieren wie in der vollständigen Browser-Version von Haiilo.

4. Importiere die Teams-App

Du benötigst Administratorrechte in deinem Microsoft Teams Entwicklerportal, um diese Schritte abzuschließen.

  1. Melde dich im Entwicklerportal in Microsoft Teams an.
  2. Gehe zu Apps > App importieren und wähle das kürzlich heruntergeladene Manifest (.zip-Datei) aus. Screenshot 2023-12-15 um 14.48.41.png

  3. Haiilo füllt die App-Informationen basierend auf Informationen von deiner Haiilo-Plattform, deinem Microsoft-Authentifizierungsanbieter und deinem benutzerdefinierten Bot vor. Du kannst einige Informationen optional bearbeiten, einschließlich des App-Namens, der Beschreibung, des Brandings usw., um die App für deine Organisation anzupassen.

    • Bitte ändere nicht die folgenden Einstellungen. Sie sind vorkonfiguriert basierend auf deiner Microsoft-App und Haiilo-Authentifizierungsanbieter und sind notwendig, damit die App korrekt funktioniert.

      • Anwendungs (Client) ID
      • App Funktionen
      • Domänen
      • Single Sign-On
  4. Nachdem du die App konfiguriert hast, kannst du sie testen, indem du Vorschau in Teams auswählst und dann die App zu Teams hinzufügst.
  5. Wenn die App wie erwartet funktioniert, kannst du sie gemäß den Richtlinien deines Unternehmens an deine Organisation veröffentlichen.

Sobald veröffentlicht, können deine Benutzer die App in MS Teams öffnen! 

 

Nur Homepages-Erfahrung ⬇️

MS Teams Startseite gif.gif

Haiilo gesamt-Erfahrung ⬇️

MS Teams Startseiten Vollansicht.png

Neue Blog- und Studio-Benachrichtigungen ⬇️

Blog- und Studio-Benachrichtigungen in MS Teams.png

War dieser Beitrag hilfreich?

0 von 0 fanden dies hilfreich