Erstellen eines Azure-Bots

Besuchen Sie diesen Link, um einen Azure-Bot zu erstellen: https://portal.azure.com/#create/Microsoft.AzureBot

• Wählen Sie einen Namen für Ihr Bot-Handle
• Wählen Sie Ihr Abonnement und die Ressourcengruppe aus, in der sich Ihr KanBo befindet
• Wählen Sie die regionale Datenresidenz und die Region aus, in der sich Ihr KanBo befindet
• Ändern des Tarifs in „Kostenlos“
• Lassen Sie die restlichen Optionen unverändert (Mehrinstanzenfähig, Neue Microsoft-App-ID erstellen)

Nachdem Sie alle oben genannten Schritte ausgeführt haben, klicken Sie auf Überprüfen + erstellen und anschließend auf „Erstellen“.

Wechseln Sie nach Abschluss der Erstellung zum Azure-Bot und zu Einstellungen > Kanäle

Klicken Sie auf „Microsoft Teams“

Akzeptieren Sie die Nutzungsbedingungen. Lassen Sie anschließend „Microsoft Teams Commercial“ ausgewählt und klicken Sie unten auf „Übernehmen“.

Gehen Sie danach auf „Konfiguration“

Füllen Sie den Messaging-Endpunkt mit der URL Ihres KanBo (https:// enthalten), der /plugins/teams-app/bot vorangestellt ist, und klicken Sie auf Übernehmen.

Klicken Sie danach auf „Passwort verwalten“ neben dem Feld „Microsoft App ID“

Entfernen Sie den automatisch erstellten client secret und generieren Sie einen neuen, indem Sie auf „Neuer client secret“ klicken. Wir empfehlen, den neuen für 24 Monate zu generieren und ihn der Übersichtlichkeit halber „KanBo“ zu nennen.

Kopieren Sie den client secret und speichern Sie ihn an einem beliebigen Ort.

Gehen Sie anschließend zu „Übersicht“

Kopieren Sie die Anwendungs-ID (Client) und die Verzeichnis-ID (Mandant) für die spätere Verwendung.

Klicken Sie abschließend auf „Add a Redirect URI“

Klicken Sie auf „Plattform hinzufügen“ und wählen Sie „Web“

Fügen Sie „https://token.botframework.com/.auth/web/redirect“ in den Umleitungs-URI ein, wählen Sie „Zugriffstoken“ und „ID-Token“ aus und klicken Sie auf „Konfigurieren“.

Erteilen von Berechtigungen in Microsoft Entra

Wechseln Sie zu App-Registrierungen – Microsoft Entra Admin Center , suchen Sie die App-Registrierung Ihrer KanBo , öffnen Sie sie, und gehen Sie anschließend zu „API-Berechtigungen“.

Sie können Berechtigungen hinzufügen, indem Sie auf die Schaltfläche „Berechtigung hinzufügen“ klicken und dann auf „Microsoft Graph“ klicken

Sie haben die Möglichkeit, zwischen delegierten Berechtigungen und Anwendungsberechtigungen zu wählen

Die Registrierung sollte über folgende Berechtigungen verfügen:

Liste der delegierten Berechtigungen:

• TeamsActivity.Send

Liste der Anwendungsberechtigungen:

• AppCatalog.Read.All
• TeamsAppInstallation.ReadWriteForUser.All
• ChannelMessage.Read.All

Nachdem Sie alle erforderlichen Berechtigungen hinzugefügt haben, klicken Sie auf „Admin-Zustimmung für KanBo erteilen“

Konfigurieren der KanBo

Gehen Sie zu Ihrem KanBo und stellen Sie sicher, dass diese Linien vorhanden sind:

{
  "type": "teams-app.selfhosted",
  "children": [
    {
      "type": "env",
      "children": [
        {
          "type": "source",
          "content-path": "PATH-HERE"
        },
        {
          "type": "teams-app",
          "app-name": "KanBo.TeamsApp",
		  "bot-app-id": "CLIENT ID",
		  "bot-app-secret": "CLIENT SECRET",
		  "bot-app-tenant-id": "TENANT ID",
		  "bot-app-type": "MultiTenant",
		  "bot-kanbo-connection": "kanbo-connection"
        }
      ]
    }
  ]
},

Ihr KanBo sollte einen Ordner mit dem Namen „KanBo. TeamsAppPlugin“. Kopieren Sie den Pfad dazu und ändern Sie den PATH-HERE im Code in den Pfad zu diesem Ordner.

Denken Sie daran, dass der Pfad entweder Schrägstriche nach vorne oder doppelte Schrägstriche nach hinten haben sollte

Client-ID, Client Secret und Mandanten-ID sind Werte, die Sie während der Erstellung und Konfiguration des Azure-Bots kopiert haben.

Speichern Sie anschließend die appsettings.json und starten Sie Ihre KanBo neu

Einrichtung der Teams-App

Nachdem Ihr KanBo neu gestartet wurde, gehen Sie zu https://yourkanbourl/plugins/teams-app/setup

Sie sollten auf einer Seite wie dieser präsentiert werden:

Nachdem Sie auf den Link „API verfügbar machen“ geklickt haben, fügen Sie einen neuen Anwendungs-ID-URI hinzu

Fügen Sie danach einen neuen Bereich hinzu, und füllen Sie ihn mit den Informationen von der Setup-Seite wie folgt:

Jetzt fügen wir die autorisierten Clientanwendungen von der Setup-Seite hinzu

Gehen Sie nun zurück zur Setup-Seite und aktualisieren Sie die Seite.

Wenn alle vorherigen Schritte korrekt ausgeführt wurden, sollte dies nach dem Aktualisieren der Setup-Seite angezeigt werden:

Ein Klick auf „dies“ startet einen direkten Download einer „KanBo.zip“-Datei. Laden Sie es herunter und gehen Sie zum Microsoft Teams Admin Center

Klicken Sie dort auf Teams-Apps > Apps verwalten > Aktionen > Neue App hochladen

Laden Sie dann Ihre App hoch:

Jetzt können Sie Ihre KanBo in Teams verwenden!