KanBo Installation für On-Premise SharePoint 2019
1. Voraussetzungen
Wichtig:
- Welche Voraussetzungen für die KanBo On-Premise Installation erfüllt sein müssen, sehen Sie im folgenden Artikel.
- Bitte fordern Sie die aktuellen KanBo unter support@kanboapp.com
2. Registrieren eines neuen App-Bezeichners in SharePoint
Erstellen Sie eine neue App-Registrierung in Sharepoint, indem Sie zu Your-SP-URL/_layouts/15/appregnew.aspx
- Klicken Sie auf Client-ID generieren
- Klicken Sie auf Generate Client secret (Geheimen Clientschlüssel generieren)
- Titel – KanBo
- App Domain – Domain Ihrer KanBo (keine https:// etc.)
- Redirect URI – die URL Ihrer KanBo
- Klicken Sie auf „Erstellen“
3. Registrieren des (selbstsignierten) Zertifikats in SharePoint
Für die Authentifizierung der KanBo-Sharepoint-Kommunikation KanBoist ein selbstsigniertes Zertifikat erforderlich. Um das Zertifikat zu erstellen und in Sharepoint zu registrieren, führen Sie den folgenden Befehl in PowerShell als Administrator aus
$cert = New-SelfSignedCertificate -DnsName "kanbo-cert" -CertStoreLocation "cert:\LocalMachine\My" -NotAfter (Get-Date).AddYears(20)
[System.Convert]::ToBase64String($cert.Export("cert")) > test.cer
$cert = New-Object System.Security.Cryptography.X509Certificates.X509Certificate2(Resolve-Path test.cer)
$realm = Get-SPAuthenticationRealm
New-SPTrustedSecurityTokenIssuer -cert $cert -name kanbo-hightrust -RegisteredIssuerName "kanbo-hightrust@$realm" -IsTrustBroker
New-SPTrustedRootAuthority -Name 'kanbo-cert' -Certificate $cert
Wenn Sie diesen Befehl ausführen, sollten Sie diese Ausgabe erhalten:
Hier gibt es wichtige Ausgaben, die gespeichert werden müssen. Diese sind:
- Der Klopfen des „KanBo“-Zertifikats
- Die ID dieses Zertifikats (vorhanden unter der Variablen „DisplayName“)
Sie kommen im nächsten Schritt zum Einsatz
4. KanBo installieren
"ConnectionStrings": {
"KanBo": "Data Source=IP,1433;Database=DB-NAME;User ID=USERNAME;Password=PASSWORD;Trusted_Connection=False;Encrypt=True;Connection Timeout=30;TrustServerCertificate=true;MultipleActiveResultSets=True"
},
Sie müssen:
- Ändern Sie „IP“ in die IP-Adresse Ihres SQL Servers.
- Ändern von „NAME“ in eine SQL Server-Anmeldung
- Ändern Sie „PASSWORD“ auf das Passwort des verwendeten Logins
- Ändern Sie „DB-NAME“ in den Namen, den Sie für Ihre Datenbank wünschen („KanBo“ wird empfohlen)
"load-packages",
{
"type": "auth-by-login",
"issuer": "sp"
},
{
"type": "package",
"name": "kanbo"
},
"identity-source",
{
"type": "auth.sharepoint",
"client-id": "CLIENT-ID",
"issuer-id": "ISSUER-ID",
"sp-host-url": "SP-URL",
"signer": {
"key": "thumbprint",
"store-location": "localmachine",
"store-name": "my",
"type": "x509-store",
"valid-only": false,
"value": "THUMBPRINT"
}
},
"sp-web",
{
"type": "security-group-sync-target.sharepoint",
"attach-on-group-create": true
},
"security-group-sync-target.sharepoint-external-site-collection",
{
"type": "docsource.sharepoint",
"event-listener": {
"type": "soap11"
}
},
"doc-template-source.sharepoint",
"add-sharepoint-login-to-public-board",
{
"type": "users-source.sharepoint",
"sid-source": {
"type": "ad"
}
},
"setup-permissions.sharepoint",
"website-search.sharepoint",
{
"type": "sp-app",
"url": "sharepoint-appfile"
},
"require-user-account",
"sp-subsite",
"board-installer.sharepoint",
{
"type": "template-files",
"path": "TEMPLATE-PATH"
},
Liste der Werte, die in diesem Abschnitt geändert werden sollen:
- CLIENT-ID – Client-ID der Sharepoint App Registrierung
- ISSUER-ID – muss in die ID geändert werden, die in der Ausgabe der Zertifikaterstellung angezeigt wird.
- SP-URL – Die URL Ihrer Sharepoint-Website
- THUMBPRINT – der Fingerabdruck des erstellten und registrierten Zertifikats
- TEMPLATE-PATH – ein Pfad zu einem Ordner, der temporäre Vorlagendateien enthält
Zwei wichtige Dinge sind hier zu beachten. Zunächst sollte sich der im TEMPLATE-PATH angegebene Ordner nicht im Stammordner der KanBo befinden, sondern außerhalb davon erstellt werden. Zweitens, wenn Sie mit Sharepoint vertraut sind, können Sie eine Sharepoint-Site erstellen, von der aus Sie Ihre KanBo hosten können, und dann die URL dieser Site (z. B. KanBo ) als SP-URL verwenden.
5. Einrichten einer Website in IIS
Öffnen Sie zunächst IIS, gehen Sie zu Sites und klicken Sie auf „Website hinzufügen…“
Nennen Sie die Website „KanBo“ und füllen Sie die restlichen Informationen entsprechend der Einrichtung Ihrer Domain aus.
Nachdem Sie die Website erstellt haben, doppelklicken Sie auf den Namen.
Gehen Sie zu Authentifizierung
Stellen Sie sicher, dass sowohl die „Anonyme Authentifizierung“ als auch die „Windows “ aktiviert sind.
Gehen Sie als Nächstes zu Anwendungspools und suchen Sie den Anwendungspool Ihrer KanBo
Wählen Sie es aus und klicken Sie auf „Erweiterte Einstellungen“
Ändern Sie „Benutzerprofil laden“ aus dem Dropdown-Menü auf „true“ und klicken Sie dann auf das Drei-Punkte-Menü für „Identität“.
Ändern Sie die Identität in „Benutzerdefiniertes Konto“ und verwenden Sie dann den Benutzernamen und das Passwort des Serveradministratorkontos.
Drücken Sie OK, um alle geöffneten Fenster zu speichern.
6. Legen Sie Berechtigungen für das KanBo fest
Die KanBo benötigt Schreibzugriff auf den Ordner, aus dem sie sich selbst hostet. Klicken Sie dazu mit der rechten Maustaste auf den KanBo und gehen Sie zu den Eigenschaften
Klicken Sie auf „Bearbeiten“
Jetzt fügen wir eine neue Berechtigung hinzu
Klicken Sie auf „Standorte“ und ändern Sie den Standort auf Ihren gesamten Server
Geben Sie „IIS AppPool\KanBo“ als Objektnamen ein. Nachdem Sie auf „Namen prüfen“ geklickt haben, können dem Anwendungspool Ihrer KanBo Berechtigungen für diesen Ordner erteilt werden.
Erteilen Sie dem KanBo alle Berechtigungen, und speichern Sie die App.
7. Verteilen der App in SharePoint
Zuerst müssen Sie die Datei „KanBo.app“ abrufen. Gehen Sie zu https://YOURKANBOURL/plugins/sharepoint-appfile/ KanBo.app
Dadurch wird automatisch eine KanBo.app Datei heruntergeladen.
Verteilen Sie als Nächstes KanBo.app auf Ihrer Sharepoint-Website. Gehen Sie zur Website „Ihr App-Katalog“ (in unserem Fall ist es contoso.com/sites/kanboapp)
Klicken Sie auf „App für Sharepoint verteilen“ und laden Sie die KanBo.app Datei hoch
8. Hinzufügen der App zu SharePoint
Nachdem Sie das KanBo.app an Sharepoint verteilt haben, müssen Sie es zu Ihrer Sharepoint-Website hinzufügen. Öffnen Sie Ihre SharePoint-Seite, auf der Sie KanBo hinzufügen möchten (wir verwenden: portal.contoso.com) und klicken Sie auf das Zahnradsymbol oben rechts und wählen Sie „App hinzufügen“ aus.
Unter den verfügbaren Anwendungen sollte die KanBo angezeigt werden, die derzeit nicht hinzugefügt werden kann.
Klicken Sie auf Finden Sie heraus, warum.
Klicken Sie auf Genehmigung anfordern.
Klicken Sie im Popup-Fenster auf die Schaltfläche Anfordern .
Die App-Anforderung ist jetzt ausstehend und muss genehmigt werden
Öffnen Sie Ihren App-Katalog, klicken Sie auf der linken Seite auf „App Request“.
Klicken Sie auf „KanBo“ und genehmigen Sie die App
Die KanBo App ist nun zugelassen.
Gehen Sie zurück zur App zum Menü „App hinzufügen“, klicken Sie auf die „KanBo“-App und klicken Sie auf „Vertrauen“.
9. KanBo aus
Jetzt können wir das KanBo ausführen, indem wir die Seite öffnen: https:// kanbo.kdomain12.local/setupKanBo und den Schritten aus der Einrichtungsanleitung folgen.
10. KanBo konfigurieren
Installieren und konfigurieren Sie Elastic Search, wonach Sie in KanBo eine Verbindung dazu herstellen.
- Installations- und Konfigurationshandbuch unter Windows:
https://help.kanboapp.com/en/devops/installing-and-configuring-elastic-search-on-windows/ - Installations- und Konfigurationshandbuch unter Linu (Debian):
https://help.kanboapp.com/en/devops/installing-and-configuring-elastic-search-on-debian/
11. Konfigurieren des KanBo
Zuerst müssen Sie die Ressourcenverwaltungswebsite in IIS auf die gleiche Weise wie die KanBo einrichten. Suchen Sie danach diesen Abschnitt im KanBo :
/*RESOURCE MANAGEMENT*/
{
"type": "auth.oauth",
"issuer": "rmkanbo",
"children": [
[
"cert",
{
"key": "thumbprint",
"store-location": "localmachine",
"store-name": "my",
"type": "x509-store",
"valid-only": false,
"value": "THUMBPRINT"
}
]/* client will go here */
]
},
{
"type": "resource-mgmt",
"issuer": "rmkanbo",
"rm-uri": "https://RM-URL/api",
"children": [
[
"cert",
{
"key": "thumbprint",
"store-location": "localmachine",
"store-name": "my",
"type": "x509-store",
"valid-only": false,
"value": "THUMBPRINT"
}
]
]
},Ersetzen Sie jeden „FINGERABDRUCK“ durch denselben Zertifikatfingerabdruck, den Sie im Abschnitt „auth.sharepoint“ verwendet haben. Ersetzen Sie „RM-URL“ durch die URL Ihrer Ressourcenmanagement-App.
Starten Sie nach dem Speichern den App-Pool der KanBo neu und gehen Sie dann zu YOURKANBOURL/auth/rmkanbo/newclient
Es wird eine Seite angezeigt, die wie folgt aussieht:
Hier gibt es zwei Teile. Der Teil „Client-Konfiguration“, der in die appsettings.json der KanBo einfließt, 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, müssen Sie die Verbindungszeichenfolge aus Ihrem KanBo in den Resource Management-appsettings.json kopieren. Scrollen Sie anschließend zum Ende der appsettings.json des Ressourcenmanagements und suchen Sie die leeren Variablen „ClientId“ und „ClientSecret“. Fügen Sie die Client-ID „OAuth2 config“ und den Client Secret in Anführungszeichen ein. Stellen Sie außerdem sicher, dass Sie die URLs in die URL Ihrer KanBo ändern.
Nachdem alle appsettings.json Dateien konfiguriert und gespeichert wurden, starten Sie beide Apps neu, beginnend mit der Ressourcenverwaltungs-App
Nachdem beide Apps ausgeführt wurden, gehen Sie zur Einrichtungsseite von Your KanBo. 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!
War dieser Beitrag hilfreich?
Bitte kontaktieren Sie uns, wenn Sie weitere Fragen haben.