KanBo Modern Web Part Installation

Table of Contents

KanBo modern web part can be installed in both on-premises and cloud environments.

Before you start, make sure that you have the correct permissions to access the SharePoint admin center of your Microsoft 365 tenant. To do so, try opening this link.

To install KanBo modern web part:

Find your KanBo appsettings.json file, and open it with a text editor.

Add these lines anywhere in the "Plugins" section:

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

Replace "ISSUER" with the name of the issuer 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 then restart KanBo.
Locate the .sppkg package (SharePoint-hosted app) that you 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.
You will need to locate and modify three values:

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

Search for {password} and replace it with the password you set in the webconfig in step 2.

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

Once everything is finished, the excerpt from the .xml file should resemble the following:

Save the file.
Replace the old file in the ZIP archive with the new one.
Change the extension from .zip back to .sppkg.

Now, we need to add this package as a SharePoint app.

Go to the SharePoint Admin Center by opening this link in the browser you are signed in as SharePoint Admin:
In the Apps section, select Open.