Report a problem
Go to KanBo Website
EN

KanBo Outlook Add-in Installation (O365 & On-Premise)

Table of Contents

This post is also available in: Deutsch

The Outlook Add-in makes it easy for you transfer information from an email to KanBo.
This App equips you with the ability to convert Emails into KanBo Cards. It is also possible to select an existing KanBo Card and attach information from the email to it.

You can read more about The KanBo Outlook Add-in here.

Install Outlook App in Exchange 2013 or Office 365

To install the Outlook application on Kanbo, you need to have at least Exchange 2013 or Outlook 2013. KanBo won’t work on Outlook 2010, but you can use OWA (Outlook via a browser) to get KanBo Outlook app instead of upgrading to Office 2013/2016.

Get the id of issuers expected from Outlook (On-premise only)

1. First way
  1. Go the metadata file, it should be at location:
    `https://**exchange address**/autodiscover/metadata/json/1`
  2. See the **issuer** field, the example output is: `…@exchange.example.org`
  3. The part after @ is identifying your domain.

  1. Fill the `...` with `00000002-0000-0ff1-ce00-000000000000` - it's the constant identifier for outlook apps.
  2. The result should be:
    `00000002-0000-0ff1-ce00-000000000000@exchange.example.org`

2. Second way
  1. Run the outlook app without providing any issuers (you must apply step 3 - enter the configuration... to run the Outlook app).

Example of configuration in KanBo appsettings.json

{
"type": "outlook-app",
"children": [
{
"type": "issuers",
"children": [
{
"type": "accept",
"id": ""
}
]
}
]
}

  1. See the error - the numbers in the communicate are your Issuer ID.


Modify the appsettings.json of KanBo (On-premise only)

  1. Go to your KanBo appsettings.json and start modifying it by adding the following entry in the "plugins" section and pasting your Issuer ID.

{
"type": "outlook-app",
"children": [
{
"type": "issuers",
"children": [
{
"type": "accept",
"id": "0xxxxxxxxxxxxxxxxxxxxxxxxxxx00@8xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx6"
}
]
}
]
}


Get KanBo Outlook app manifest

  1. Go to this link.

  1. Copy the entire manifest to Notepad or other text editor and save it as manifest.xml.


Add KanBo Outlook Add-in Manifest to Exchange

1. On Premise Exchange deployment
  1. Go to Exchange admin center -> Organization -> Add ins and add this add-in. Use + button and then Add from file.

  1. Use the manifest.xml file which as created earlier.

  1. When the manifest.xml is successfully added, double click on KanBo Outlook App and set it to be Optional, enabled by default and save.


2. Cloud (Office 365/Exchange Online) deployment

  1. Go to Office 365 admin center (https://admin.exchange.microsoft.com/) and click on Organization > Add-ins.

  1. Then click the plus icon and select "Add from file".

  1. Select Your .xml manifest file and click next.

  1. After it is added, You double click on "KanBo Outlook Add-in" and select "Optional, enabled by default" and save.


Add a test mail to KanBo

  1. When all the steps are performed, go to your Outlook (OWA or client) and use KanBo Outlook Add-in.
  2. See how you can use it by reading this article: this article.

#### Constructing the issuers list

To ensure that only allowed exchange servers are using the application, there's a need to provide your list of domains/issuers that will be able to user your application. There are two ways to detect issuers list.

Official MS Description

Was this article helpful?

Please, contact us if you have any additional questions.