Configuring Teams Connector

To index and archive files, posts, and replies from direct chats, group chats, and channels in Microsoft Teams, you must configure the connector and create the required Index and Archive location in the NetGovern Admin UI. You will create a Live Location, an Instant Messaging Store, and select Teams as the source location. Once you have created the Live Location and completed the configuration of the connector, you must perform User Mapping. Next, indexing and archiving jobs must be set up to crawl and archive the data in Teams. The Live Location and content can then be included in a NetGovern case.

IMPORTANT
When you have created the location and configured the connector, you must ensure that all users are mapped. For more information—see User Mapping. For detailed steps—see Configuring User Mapping
IMPORTANT
Once configured, Teams indexing and archiving jobs must be created in order to process the live data. A Teams Index job must be set up in order to make the live content searchable—see IM Searches. Indexing must be performed prior to archiving if you intend to search the archived data—see Configuring Teams Indexing and Configuring Teams Archiving.

First, you must integrate NetGovern with Office 365. Register the TeamsArchiving application with the Microsoft Identity Platform and grant the permissions required. Once you have completed the prerequisites for configuring the Teams connector, you can create the Live Location in the NetGovern Admin UI.

  • To register the Teams Archiving application in your tenant, enter the following URL in a web browser:
    https://login.microsoftonline.com/common/adminconsent?client_id=7aafc2b9-45fb-4c8d-8845-be4500a6d61c&state=12345&redirect_uri=https://localhost:65010/crawler
  • You should already be logged in to Office 365 with you Global Administrator Account. If not, log in, following any prompts to use the correct credentials.
  • Grant permissions to the application. Click Accept.

  • You will be redirected to the following URL, which indicates successful registration:
    https://localhost:65010/crawler?admin_consent=True&tenant=12cf9842-fb72-4b1d-9f89-6a69e478f803&state=12345
    The page will not resolve and can be closed.

You must have completed the prerequisites for configuring the Teams connector in NetGovern. You can contact your Support Representative for further details on the connector features, system requirements, and pre-configuration process.

Perform the following steps in the NetGovern Admin UI. Administrator rights are required.

  • Log into the NetGovern Admin UI.
  • Select Archiving.
  • Open the Connectors tab.
  • Navigate to the Locations section. Click Add.
  • Click on Live Locations to expand, select Instant Messaging Store.
  • Click Next.
  • Select Teams as the Source Type. Click Next.
  • The Instant Messaging Store window displays.
  • In the Name field, enter a name that is meaningful to the users and reviewers who will be accessing the data. Include the term "Connector" in the name entered.
  • IMPORTANT
    To change a location name, a new location must be created and its data must be reindexed.
  • In the Description field, enter a relevant description.
  • Enter the Office 365 Tenant ID that you want to index.
  • NOTE
    Your O365 Tenant ID is located in the Directory ID box.
  • (Optional) Enable Distribute accounts across all crawler nodes. This is checked by default for a better balancing of the indexing workload.
  • (Optional) Enter the User Group. This represents the users whose Teams content will be indexed and made available in a NetGovern IM Search—see IM Searches.
  • IMPORTANT
    Once the Teams content is indexed, it will not be possible to exclude content from certain users. If you want to control which users' Teams data is indexed, you can create user sub groups. A separate index location must be created for each group.
  • (Optional) Click Test to verify the connection.
  • Click Save.
  • When finished, click Save at the bottom-left of the Connectors tab.
    • IMPORTANT
    When you have created the location and configured the connector, you must ensure that all users are mapped. For more information—see User Mapping. For detailed steps—see Configuring User Mapping
  • IMPORTANT
    Once configured, Teams indexing and archiving jobs must be created in order to process the live data. A Teams Index job must be set up in order to make the live content searchable—see IM Searches. Indexing must be performed prior to archiving if you intend to search the archived data—see Configuring Teams Indexing and Configuring Teams Archiving.