KanBo Modern Webpart Installation

1. Locate your KanBo appsettings.json 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"
         }
        ]
       ]
      },

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

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

8. Open the XML file with a file editor.
9. 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:

10. Save the file.
11. Replace the old file in the zip with the new file.
12. Change the extension from.zip back to .sppkg.
13. 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:
14. Click on “Open” in the Apps section.

15. Go to the app catalog.

16. Click on “Distribute Apps for Sharepoint”.

17. Drag in the .sppkg package into Sharepoint.

18. Click on “Deploy”.

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

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