Versions Compared

Key

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

...

Note
Note: Microsoft uses the word connection to refer to a connector and an index within Microsoft Search.
  1. Login to Microsoft Azure with the tenant admin credentialAdmin Center https://aad.portal.azure.com/
  2. Click on 'Azure Active Directory'->'App Registrations'
  3. In the 'App Registrations' menu, click on Create a 'New registration' & copy the application (client) id
  4. Follow the Wizard instructions.  
  5. Once your app has been registered. Click on the name of your app. It will display the credentials you need.
  6. Copy the Application (client) ID. 
  7. Click on 'Certificates & secrets' and Under 'Clients & certificates' create a 'new client secret' & copy
  8. Copy the 'client secret'value' of the secret.
  9. Under 'API permissions' -> 'Add a permission' -> Select 'Microsoft Graph' -> Select 'Application permissions' -> search for & add 'ExternalItem.ReadWrite.All'
  10. Grant admin consent by clicking the 'Grant admin consent for <tenant>'

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.


Setting up a Search Engine Results Page (SERP)

There are a few additional steps to setup Microsoft Search SERP before you can search for the ingested content.

  • Create a SharePoint site collection with a modern search page.
  • Import SharePoint module in PowerShell:

    Code Block
    languagetext
    themeFadeToGrey
    Install-Module -Name Microsoft.Online.SharePoint.PowerShell
  • Set up SERP using this PowerShell script:

    Code Block
    languagetext
    themeFadeToGrey
    $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.


Windows or Linux

...

The Microsoft Search publisher run on either Windows or LinuxThe publisher component can be used on any installation of Aspire as long as it has internet access to communicate with the Microsoft Search service.