Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

To extract and index documents stored in Microsoft SharePoint, the Locator SharePoint connector needs to be configured with a user that has access to all the documents that are to be extracted. This user is referred to as the index user.

...

Connection Type

Required PermissionCan be indexed by Azure AD Application

Notes

SharePoint AdminSite Collection Administrator on each site collection/OneDrive"Read for index user" custom permission on each site collection"Read for index user" custom permission on site provided in Server Page

Document

Single siteNoNoNoYes

Yes


Index all site collectionsYesNo - but preferredYesYesNo
  • Index user doesn't need "Read for index user" permission level on each site collection it is already site collection administrator
  • You can use Set-AdminOnSites.ps1 script to add index user as secondary site collection administrator to all site collections
Additional site templates*NoNo - but preferredYesYesYes
  • Index user doesn't need "Read for index user permission" level on each site collection it is already site collection administrator
  • You can use Set-AdminOnSites.ps1 script to add index user as secondary site collection administrator to all site collections
User ProfilesNoNoNoYesYes
MySites/OneDriveNoYesNoNoYesYou can use Set-MySiteIndexUser.ps1 script

*This can used when at least on one of these: Include Office 365 Personal Blogs, Include Office 365 Group Sites, Include Office 365 Communication Sites or Include other site templates is selected on Connection Configuration Page.

...

  • If any of the "Include Office 365..."-checkboxes in wizard is used for specific site collection templates
  • If "Include other site templates" is checked in the wizard and some of the templates were selected.

Note 3: Global admins and SharePoint admins don't have automatic access to Group Sites. That means they can not manage permissions inside Group Sites. However global admins still have option to add members and owners to Group Sites.

...

  • Manually editing each user profile using the SharePoint Admin User Interface:
    1. From your browser, navigate to your office 365 SharePoint admin center.
    2. Click on "Admin" from the ribbon bar at the top right and select "SharePoint".
    3. Click on "user profiles" from the list on the left.
    4. Under "People", click on "Manage User Profiles".
    5. The "Total number of profiles" will be displayed. The following steps (#6 through #9) will need to be performed for each of the existing user profiles. 
    6. In the "Find profiles" entry field, type the user name and click the "Find" button.
    7. Position the mouse over the "Account name", right click and select "Manage site collection owners".
    8. In the "site collection owners window, enter the name of the index user in the entry box for "Site Collection Administrators".
    9. Click OK.
  • Running the Set-MySiteIndexUser.ps1 PowerShell script.  This script will read all users from SharePoint online and add the index user to the "Site Collection Administrators" list, for each user's personal site, if it exists.

NOTE: To execute the Set-MySiteIndexUser.ps1 the SharePont Online Client Components SDK is required >> SharePointOnlineClientComponentsSDK

...

NOTE: If your SharePoint Administrator account uses Multi-Factor Authentication then you have to use Set-MySiteIndexUserMFA.ps1 version of the script instead. There are few differences compared to Set-MySiteIndexUser.ps1 script. There is additional prerequisite: you have to install module SharePoint Patterns and Practices PowerShell Cmdlets for SharePoint Online. This script is also slower than Set-MySiteIndexUser.ps1. There are few suggestions on how to use this script:

...

Excerpt

   

Configuring Windows Azure Active Directory

Locator uses the Windows Azure Graph API.  The Office 365 Global Administrator will need to configure an application, called a "service principal" in Windows Azure terminology, to be authorized to read Windows Azure Active Directory information.

Setting up the Windows Azure Graph API for Locator 

Setting up the Windows Azure Graph API for Locator is required in order to configure either an Exchange Online or a SharePoint online connection.  This need only be done one time, as the client ID and secret key obtained through these steps can be used for both the Exchange Online connector and the SharePoint Online connector.


To create and obtain an Azure AD Client App Id and a Client Secret, sign into https://portal.azure.com/#blade/Microsoft_AAD_IAM/ActiveDirectoryMenuBlade/RegisteredApps using the global administrator account for your Office 365 organization and do the steps indicated in red below. The two values that are to be extracted are circled in green:






The screenshot above has the application Id we need. The two menu options that are to be used for creating and obtaining the client secret, are circled in red and will be used in the following screenshots:

Image Modified



Adding Permissions to the Azure AD Application for SharePoint Online indexing

...