KanBo Modern Webpart Installation

Table of Contents

This post is also available in: Deutsch

You can install KanBo Modern Webpart in both on-premises and cloud environments.

Before you start, make sure you have the right permissions to access the SharePoint Admin Center of your Office 365 tenant – to do so try to open this link.

Follow this guide to install KanBo Modern Webpart.

Locate your KanBo appsettings.json and open it with any text editor.

Anywhere in the "plugins" section, add these lines:

{
    "type": "auth.app",
    "issuer": "ISSUER",
    "children": [
     {
      "type": "signature",
      "algo": "hs256",
      "password": "PASSWORD"
     },
     [
      "mapper",
      {
       "type": "login",
       "roles": "external-services"
      }
     ]
    ]
   },

Replace the ISSUER with the issuer name You want to use and replace PASSWORD with a secure password.

Example:

{
    "type": "auth.app",
    "issuer": "KanBoWebPart",
    "children": [
     {
      "type": "signature",
      "algo": "hs256",
      "password": "Sup3rPa$word"
     },
     [
      "mapper",
      {
       "type": "login",
       "roles": "external-services"
      }
     ]
    ]
   },

Save the appsettings.json file and restart KanBo.
Locate the .sppkg package (SharePoint hosted App) you have downloaded from the link we sent you.

Change the extension of the file from .sppkg to .zip.
Open the .zip file, go to the folder named “1c14dbb2-0965-4ae3-98da-6133ccf74bbe” and unpack the “WebPart_1c14dbb2-0965-4ae3-98da-6133ccf74bbe.xml” file to another folder.

Open the XML file with a file editor.
We will have to find and change 3 values:

Search for {kanbo-url} and replace kanbo-url with the URL of Your KanBo, like https://mykanbo.com.

Then search for {password} and replace it with the password You’ve set in the webconfig in step 2.

Lastly, look for {issuer-name} and replace it with the issuer name set in step 2.

After all that is done, the exerpt from the .xml file should look like this:

Save the file.
Replace the old file in the zip with the new file.
Change the extension from.zip back to .sppkg.
Now we need to add this package as an App for SharePoint. Go to the SharePoint Admin Center by opening this link in the browser you are signed in as SharePoint Admin:
Click on “Open” in the Apps section.