KanBo Installation auf Office 365 und Azure (manuell)

Laden Sie das Zertifikat in KanBo hoch

1. Kehren Sie zu Ihrer KanBo Azure Webapp zurück, gehen Sie zu den TLS/SSL-Einstellungen und gehen Sie dann zu Private Key Certificates (.pfx).
2. Klicken Sie auf "Zertifikat hochladen".

3. Geben Sie das Passwort ein und laden Sie es hoch.

4. Kopieren Sie den Fingerabdruck des Zertifikats.

5. Öffnen Sie die Konfiguration, und fügen Sie eine neue Anwendungseinstellung hinzu.

6. Der Name der Einstellung sollte WEBSITE_LOAD_CERTIFICATES lauten. Der Wert sollte der Fingerabdruck des Zertifikats sein.
7. Speichern Sie es.

8. Aktivieren Sie in den Bindungseinstellungen "Nur HTTPS".

KanBo anpassen

Es gibt einige Bereiche, die in der appsettings.json Datei sowohl der KanBo als auch der Ressourcenmanagement-App ausgefüllt werden müssen. Beginnen wir mit KanBo

Fügen Sie die zuvor kopierte ADO.NET Verbindungszeichenfolge anstelle von "FILL-ME" ein, ohne die Anführungszeichen wegzulassen.

Ändern Sie die Zeile, indem Sie das Kennwort eingeben und am Ende der Verbindungszeichenfolge "MultipleActiveResultSets=True;" hinzufügen.

   {
    "type": "set-language-for-new-users",
    "lang": "de-DE"
   },

Hier können Sie die Standardsprache für die neuen KanBo festlegen, indem Sie die Variable "lang" ändern. Mögliche Sprachen sind:

• de-DE - Deutsch
• de-AT - Österreichisches Deutsch
• en-US - Vereinigte Staaten Englisch
• en-DE - Vereinigtes Königreich Englisch
• en-AU - Australisches Englisch
• en-CA - Kanadisches Englisch
• es-ES - Spanisch
• pl-PL - Polnisch

   {
    "type": "server-url",
    "value": "FILL-ME"
   },

Die Variable "value" sollte die vollständige URL Ihres KanBo enthalten (z. B. https://mykanbo.azurewebsites.com/)

  {
    "type": "package",
    "name": "auth-aad",
    "client-id": "FILL-ME",
    "tenant": "FILL-ME",
    "thumbprint": "FILL-ME",
    "admin-upn": "FILL-ME"
   },

Die "client-id" und "tenant" sollten die Client-ID und die Verzeichnis-ID (Tenant) enthalten, die aus Ihrer Azure Active Directory-App-Registrierung kopiert wurden, "thumbprint" sollte den Fingerabdruck des von Ihnen erstellten Zertifikats enthalten, und "admin-upn" sollte Ihre E-Mail-Adresse in Azure sein (z. B. admin@company.com).

 {
    "type": "package",
    "name": "webjobs",
    "thumbprint": "FILL-ME"
   },

Dies ist erforderlich, damit KanBo Webjobs funktionieren können. Fügen Sie hier denselben Fingerabdruck ein, den Sie für das Paket "auth-aad" verwendet haben.

/*RESOURCE MANAGEMENT*/
   
   {
        "type": "auth.oauth",
        "issuer": "rmkanbo",
        "children": [
          [
            "cert",
            {
              "type": "X509SignerFromFile",
              "file": "C:/home/site/wwwroot/Certificates/CERTNAME",
			  "key": "CERTPASS"
            }
          ]/* client will go here */
        ]
      },
	  {
        "type": "resource-mgmt",
        "issuer": "rmkanbo",
        "rm-uri": "https://RM-APP-URL/api",
        "children": [
          [
            "cert",
            {
              "type": "X509SignerFromFile",
			  "file": "C:/home/site/wwwroot/Certificates/CERTNAME",
			  "key": "CERTPASS"
            }
          ]
        ]
      }, 

Hier konfigurieren wir die zukünftige Anbindung an das Ressourcenmanagement.

Ersetzen Sie "CERTNAME" an beiden Stellen durch den Namen Ihres generierten Zertifikats.

Ersetzen Sie "CERTPASS" an beiden Stellen durch das Passwort Ihres generierten Zertifikats.

Ersetzen Sie "RM-APP-URL" durch die URL der Resource Management-Web-App, die Sie erstellt haben.

Sie können die appsettings.json Datei nun speichern. Öffnen Sie danach die appsettings.json Datei im Resource Management-Paket.

{
  "ConnectionStrings": {
    "Database": "CONNECTION-STRING"
  },

Verwenden Sie hier dieselbe Verbindungszeichenfolge, die Sie für die KanBo verwendet haben

"KanboApi": {
    "Url": "https://KANBO-URL",
    "ClientId": "",
    "ClientSecret": "",
    "CallbackPath": "/oauth/callback",
    "AuthorizationEndpoint": "https://KANBO-URL/auth/rmkanbo/code",
    "TokenEndpoint": "https://KANBO-URL/auth/rmkanbo/token",
    "Scope": "kanbo.id"
  }
}

Ersetzen Sie hier jede KANBO-URL durch die URL der von Ihnen erstellten KanBo .

Hochladen der KanBo

1. Navigieren Sie zur Azure-Website KUDU-Dienst für Ihre KanBo (fügen Sie .scm direkt vor azurewebsites.net hinzu, z. B. https://mykanbo.scm.azurewebsites.net), und wählen Sie dann Debugkonsole –> PowerShell aus.
2. Geben Sie den Ordner "site" ein und erstellen Sie 2 neue Ordner mit den Namen "Zertifikate" und "Vorlagen". Laden Sie die von Ihnen erstellten Zertifikate in den Ordner "Zertifikate" hoch
   
3. Packen Sie alle Ihre KanBo App-Dateien in eine .zip Datei (aber bitte fügen Sie den Ordner nicht hinzu!).
4. Gehen Sie nun in den Ordner "wwwroot" und ziehen Sie Ihr .zip Archiv per Drag & Drop in den rechten oberen Teil des KUDU-Dienstes, um den Inhalt des .zip Archivs zu entpacken.

Hochladen des Ressourcenverwaltungspakets

Ähnlicher Ablauf wie beim Hochladen der KanBo . Packen Sie Ihr Resource Management-Paket in eine .zip Datei. Gehen Sie zu den Kudu-Tools der Resource Management App und laden Sie das Resource Management-Paket hoch, indem Sie es per Drag & Drop auf die rechte Seite ziehen.

Erstellen der Datenbanken

1. Gehen Sie zu https:{your KanBo address}/setup und Sie werden zur KanBo weitergeleitet.
2. Wählen Sie die Option Einfaches Setup starten.

Nachdem Sie auf die Option Automatisches Setup geklickt haben, wird die Installation von KanBo Setup fortgesetzt. Warten Sie ein paar Minuten, bis es fertig ist.

Abrufen des Lizenzschlüssels

1. Um eine KanBo zu erhalten, klicken Sie auf "Erweitertes Setup anzeigen" und dann auf die Schaltfläche "Aktualisieren" in der Nähe des Feldsatzes "Lizenz-ID".
2. Bitte senden Sie die KanBo an support@kanboapp.com,  damit ein Lizenzschlüssel generiert und an Sie gesendet werden kann.

3. Gehen Sie zurück zum appsettings.json und fügen Sie den Lizenzschlüssel in die Variable "LicenseKey" ein.

4. Speichern Sie nach dem Aktualisieren und Einfügen des LicenseKeys die appsettings.json Datei und starten Sie die KanBo neu.

Ihr KanBo wurde erfolgreich installiert, aber es gibt noch einiges zu tun.

Konfigurieren der KanBo - und Ressourcenverwaltungsverbindung

Beginnen Sie zunächst mit einem Neustart der KanBo in Azure

Geben Sie dann, nachdem Ihr KanBo neu gestartet wurde, eine URL wie diese ein: https://YOURKANBOURL/auth/rmkanbo/newclient

Es sollte eine Seite angezeigt werden, die wie folgt aussieht

Hier gibt es zwei Teile. Der Teil "Client-Konfiguration", der in die appsettings.json der KanBo gehört, und die "OAuth2-Konfiguration", die in die appsettings.json der Ressourcenmanagement-App gehört.

Für die KanBo finden Sie diesen Kommentar im appsettings.json:

/* client will go here */

Ersetzen Sie es durch ein Komma, und fügen Sie dann die Clientkonfiguration ein.

Ein paar Dinge, die Sie beachten sollten: Der Name der Variablen "client" muss in "id" geändert werden, der Wert "url" muss die URL Ihrer Ressourcenmanagement-App enthalten, und der Wert "name" muss etwas Identifizierbares enthalten (z. B. "My KanBo Resource Management")

Was die appsettings.json von Resource Management betrifft, können Sie zum Ende scrollen und die leeren Variablen "ClientId" und "ClientSecret" finden. Fügen Sie die Client-ID "OAuth2 config" und den Client Secret in Anführungszeichen ein

Nachdem alle appsettings.json Dateien konfiguriert und gespeichert wurden, starten Sie beide Apps neu, beginnend mit der Ressourcenverwaltungs-App

Verbinden der KanBo mit der Ressourcenmanagement-App

Gehen Sie erneut auf die Einrichtungsseite Ihres KanBo (https://YOURKANBBOURL/setup). Dort finden Sie einen neuen Reiter "Ressourcenmanagement"

Es sollten 4 Prüfungen angezeigt werden, die erfolgreich sind, und eine Prüfung, die fehlschlägt, nämlich die Schemavalidierungsprüfung. Wenn Sie andere Ergebnisse sehen, überprüfen Sie bitte, ob Sie alles richtig eingefügt haben

Klicken Sie anschließend auf "RM-Inhaltsdatenbank initialisieren".

Wenn jede Prüfung als "BESTANDEN" angezeigt wird, haben Sie nun die KanBo App erfolgreich mit der Resource Management App verbunden!

Erstellen von Synchronisierungsaufträgen

Damit KanBo Azure Active Directory-Profile und o365-Gruppen synchronisieren kann, müssen zwei Webjobs erstellt werden. Zusammen mit der web.zip Datei erhalten Sie ein KanBo. JobHost.zip Datei. Es enthält eine eigene appsettings.json, die wir bearbeiten müssen. Es gibt zwei Abschnitte, die geändert werden können:

O365-Gruppensynchronisierung

"ConnectionStrings": {
    "KanBo": "FILL-ME"
  },

Hier müssen Sie dieselbe Verbindungszeichenfolge einfügen, die Sie in Ihrem KanBo verwenden.

{
    "type": "package",
    "name": "auth-aad",
    "client-id": "FILL-ME",
    "tenant": "FILL-ME",
    "thumbprint": "FILL-ME"
   },
   {
    "type": "package",
    "name": "webjob.group-sync",
    "thumbprint": "FILL-ME",
    "kanbo-url": "FILL-ME"
   }

Die Werte hier sollten die gleichen sein, die Sie in der appsettings.json Ihres KanBo verwendet haben.

Legen Sie nach dem Speichern der konfigurierten Datei alle Dateien in einem .zip Ordner ab, und befolgen Sie diese Anweisungen zum Erstellen eines geplanten WebJobs: https://docs.microsoft.com/en-...

Wählen Sie für die o365 Group Sync-Aufträge den Namen "GroupSync" und den CRON-Ausdruck "0 */15 * * * *" aus

O365-Profilsynchronisierung

Um einen Profilsynchronisierungsauftrag einzurichten, verwenden Sie dasselbe Paket, das Sie für den Gruppensynchronisierungsauftrag verwendet haben.

Eine vollständige Erklärung zur Konfiguration der Profilsynchronisierung finden Sie hier: Erstellen und Anpassen des Profilsynchronisierungs-Webjobs

Verwenden Sie es

1. Erstellen Sie Boards.
2. Während der Erstellung des Boards können Sie auswählen, ob Sie eine neue Office 365-Gruppe erstellen oder die vorhandene Gruppe unter dem Board verwenden möchten.

3. Gruppenmitgliedschaften werden synchronisiert.

Außerdem werden die Benutzerinformationen aus AAD entnommen und in KanBo übertragen.

KanBo konfigurieren

1. Konfigurieren von E-Mail-Benachrichtigungen

Befolgen Sie diese Anweisung, um E-Mail-Benachrichtigungen zu konfigurieren.

2. KanBo konfigurieren

Befolgen Sie diese Anweisungen , um Search for KanBo (Elastic Search) zu konfigurieren.

3. KanBo Teams App konfigurieren

Folgen In diesem Artikel erfahren Sie, wie Sie KanBo Teams-App konfigurieren

4. Konfigurieren der KanBo in Azure

Sobald Ihr KanBo installiert ist, passen Sie bitte die Dimensionierung Ihrer Datenbank entsprechend an

Für eine gute Performance der KanBo Content Database, die während der Setup-Installation erstellt wurde, kann eine Änderung erforderlich sein.

In der folgenden Tabelle sehen Sie die Abhängigkeiten:

Anzahl der Benutzer auf Ihrer KanBo	Empfohlener Tarif für KanBo
20+ Benutzer	Standard 10 DTUs 250GB
50+ Benutzer	Standard 20 DTUs 250GB
100+ Benutzer	Standard 50 DTUs 250GB