Connecting SharePoint (Online) to Amazon Q Business
Microsoft SharePoint is a collaborative website building service that lets you customize web content and create web pages, web sites, document libraries, and lists. You can connect SharePoint (Online) instance to Amazon Q Business—using either the AWS Management Console or the CreateDataSource API—and create an Amazon Q web experience.
Topics
- Known limitations for the SharePoint (Online) connector
- SharePoint (Online) connector overview
- Prerequisites for connecting Amazon Q Business to SharePoint (Online)
- Connecting Amazon Q Business to SharePoint (Online) using the console
- Connecting Amazon Q Business to SharePoint (Online) using APIs
- Connecting Amazon Q Business to SharePoint (Online) using AWS CloudFormation
- How Amazon Q Business connector crawls SharePoint (Online) ACLs
- SharePoint (Online) data source connector field mappings
- IAM role for SharePoint (Online) connector
- Troubleshooting your SharePoint (Online) connector
Learn more
-
For an overview of the Amazon Q web experience creation process using IAM Identity Center, see Configuring an application using IAM Identity Center.
-
For an overview of the Amazon Q web experience creation process using AWS Identity and Access Management, see Configuring an application using IAM.
-
For an overview of connector features, see Data source connector concepts.
-
For information about connector configuration best practices, see Connector configuration best practices.
Known limitations for the SharePoint (Online) connector
The SharePoint (Online) connector has the following known limitations:
-
The Amazon Q SharePoint (Online) connector supports custom field mappings only for the Files entity.
-
If an entity name has a
%character in its name, the connector will skip these files due to API limitations. -
OneNote can only be crawled by the connector using a Tenant ID, and with OAuth 2.0, OAuth 2.0 refresh token, or SharePoint (Online) App Only authentication activated for SharePoint (Online) Online.
-
The connector crawls the first section of a OneNote document using its default name only, even if the document is renamed.
-
The connector crawls event attachments only when Events is also selected as an entity to be crawled.
-
The User Principal Name in your Azure Portal is a combination of upper case and lower case, the SharePoint (Online) API internally converts it to lower case. Because of this, the Amazon Q SharePoint (Online) connector sets ACL in lower case.
For example, if User principal name is
MaryMajor@domain.comin Azure portal, the ACL token in the SharePoint Connector will bemarymajor@domain.com. -
If you want to crawl nested groups using Identity crawler, you have to activate Local as well as AD Group Crawling.
-
To use Identity Crawler with SharePoint (Online) to crawl nested groups, you have to enable both Local and AD Group Crawling.
-
Query responses based on AD Group ACLs are not supported for SharePoint (Online). You need to add users and groups directly to your document permissions list.
