The Aspire Microsoft Graph publisher was created and tested using version 5.0.2.
Before installing the Microsoft Graph publisher, make sure that:
Register your AAD app (as multi-tenant or ask admins to register it as single tenant) and add the permission ExternalItem.ReadWrite.All. This permission requires global admin (or) application admin to consent to the use of app within their tenant. Once consented you would be able to create connections and ingest content.
Microsoft uses the word connection to refer to a connector and an index within Microsoft Graph.
For detailed documentation on application registration, refer: register an app.
For details on tenancy & creating multi-tenant apps, refer: Tenancy in Azure Active Directory.
For details on pre-authorization flow & different ways to consent, refer: Consent to an application.
There are a few additional steps to setup Microsoft Search SERP before you can search for the ingested content.
Import SharePoint module in PowerShell:
$orgName = Read-Host -prompt 'Enter the name of your organization' $userName = Read-Host -prompt 'Enter user name' $userCreds = Get-Credential -UserName $userName -Message "Type the password" Connect-SPOService -Url https://$orgName-admin.sharepoint.com -Credential $userCreds $url = Read-Host -Prompt 'Please enter the site url' $site = Get-SPOSite -Identity $url Set-SPOSite $url -DenyAddAndCustomizePages 0 $pwd = Read-Host -AsSecureString 'type the password' $context = New-Object Microsoft.SharePoint.Client.ClientContext($url) $credential = New-Object Microsoft.SharePoint.Client.SharePointOnlineCredentials($userName, $pwd) $context.Credentials = $credential $web = $context.Web $context.Load($web) $web.AllProperties["AllVerticalContent"] = "Combined" $web.Update() $context.ExecuteQuery() $web.AllProperties["FilesVerticalContent"] = " Combined" $web.Update() $context.ExecuteQuery() Write-Host "Success" -ForegroundColor Cyan Read-Host -Prompt 'Press enter to exit'
Once this has been done, you should be able to search for ingested items.
The Microsoft Graph publisher run on either Windows or Linux.
The publisher component can be used on any installation of Aspire as long as it has internet access to communicate with the Microsoft Graph service.