KanBo Modern Webpart Installation

Table of Contents

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.

  1. Locate your KanBo web.config and open it with any text editor.
  2. 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"
          }
         ]
        ]
       },

  3. 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"
          }
         ]
        ]
       },

  1. Save the web.config.
  2. Locate the .sppkg package (SharePoint hosted App) you have downloaded from the link we sent you.

  1. Change the extension of the file from .sppkg to .zip.
  2. 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.

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

  • 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:

  1. Save the file.
  2. Replace the old file in the zip with the new file.
  3. Change the extension from.zip back to .sppkg.
  4. 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:
  5. Click on “Open” in the Apps section.

  1. Go to the app catalog.

  1. Click on “Distribute Apps for Sharepoint”.

  1. Drag in the .sppkg package into Sharepoint.

  1. Click on “Deploy”.

  1. KanBo Modern Webpart is Now Available in your tenant.

You can learn how to use it by reading this article.

Was this article helpful?

Please, contact us if you have any additional questions.