Microsoft Search Calendar

This backend The search engine your SmartHub instance uses to perform queries. SmartHub can be configured to use more than one search engine. was updated in SmartHub 5.6.6 to replace the Microsoft Search Events backend. If you were using this backend in the previous version of SmartHub, you will need to remove it and add the Microsoft Search Calendar backend after upgrading.

About

Microsoft Search Calendar backend uses the Graph API to search for event information in a user’s primary calendar.

Limitations

The following are limitations for the Microsoft Search Calendar backend. If a feature is not supported by the Microsoft Search Graph API, it will also be not supported by a Microsoft Search Graph backend. For more information, refer to the Microsoft Graph API documentation.

  • Refiners are not supported by the Microsoft Search Calendar backend.
  • The Microsoft Search Calendar backend can only return 10 events at a time.
  • If you are upgrading from an older version of SmartHub, the Microsoft Search backends must be removed and re-added. For more information on upgrading, see How to Upgrade SmartHub.

Set Azure Active Directory Authentication

Set authentication to Azure Active Directory in SmartHub as described here: Azure Active Directory Authentication.

Client ID Requirements

Additionally, the Client ID specified in Azure Active Directory Authentication, must belong to an application with the following permissions:

  • Microsoft Graph
    • Calendars.Read

How to Add the Microsoft Search Calendar Backend to SmartHub

Use the following instructions to add the Microsoft Search Calendar backend to SmartHub:

  1. Navigate to the SmartHub Administration page: http(s)://[web-app-url]/_admin
  2. Click Add New Backend.
  3. The Backend Settings dialogue box appears.
  4. Enter a backend name.
  5. Select the backend type "MSSearchCalendarBackend".
  6. Enter Graph Url. For example, https://graph.microsoft.com
  7. Authentication
    1. Impersonate - true
      1. Security trims the results using the current user running the search
    2. Impersonate - false
      1. Client Id: Enter the Application ID from Azure App Registrations.
      2. Client Secret: Enter the Key's value from Azure App Registrations.
      3. Microsoft Login Endpoint: example: https://login.microsoftonline.com
      4. Access Token: Enter the access token from SmartHub's OAuth page.
      5. Refresh Token: Enter the refresh token from SmartHub's OAuth page.

In order to get Access Token and Refresh token, the Authorize button must be clicked, but it needs all above fields to be completed (GraphUrl, ClientId, ClientSecret, MicrosoftLoginEndpoint).

      8. Click OK.

How to Register an App in Azure and Configure It

If you use SmartHub with Azure Active Directory authentication you can reuse the same App and jump to step 5.

  1. Navigate to portal.azure.com and log in.
  2. From the left side menu go to Azure Active Directory > App registrations > New registration.
  3. On the Register an application window, specify the following:
    • Name: Enter the name of the application.
    • Application type: Select Web app / API.
    • Sign-on URL: Enter the SmartHub's URL.
  4. Select API Permissions to open the settings menu panel.
  5. Click Add a Permission.
  6. Select APIs my organization uses and add the following permissions (as you type the name, it appears):
    1. Microsoft Graph
      • Calendars.Read
  7. Click Certificates & secrets > New client secret to generate a client secret key.
  8. In the window that appears (shown below) enter the following information.
    1. Description: Enter a name for the client secret. (Note: The name is your client secret).
    2. Expires: Select the period until expires.
    3. A Value is generated after you click Add.

Metadata

The following metadata is available for your results:

  • rank
  • summary
  • @odata.type
  • hasAttachments
  • isAllDay
  • sensitivity
  • subject
  • type
  • end
  • start