EnterpriseSearchAggregatorSettings

Enterprise search aggregator settings

Supported on:

  • Chrome (Windows) since version 135

Description:

This policy allows administrators to set a designated enterprise search aggregator that will provide search recommendations and results within the omnibox (address bar) and the search box on the New Tab page.

By default, enterprise search suggestions will be blended and shown alongside regular Samsung Browser recommendations. Users can explicitly scope their search to just the enterprise search aggregator by typing the keyword specified in the shortcut field with or without the @ prefix (e.g. @work) followed by Space or Tab in the omnibox. Scoped enterprise searches (triggered by a keyword) are currently only supported in the omnibox and not in the search box on the New Tab page.

The following fields are required: name, shortcut, search_url, suggest_url.

The name field corresponds to the search engine name shown to the user in the address bar.

The shortcut field corresponds to the keyword that the user enters to trigger the search. The shortcut can include plain words and characters, but cannot include spaces or start with the @ symbol. Shortcuts must be unique.

The search_url field specifies the URL on which to search. Enter the web address for the search engine's results page, and use '{searchTerms}' in place of the query.

The suggest_url field specifies the URL that provides search suggestions. A POST request will be made and the user's query will be passed in the POST params under key 'query'.

The icon_url field specifies the URL to an image that will be used on the search suggestions. A default icon will be used when this field is not set. It's recommended to use a favicon (example https://www.google.com/favicon.ico). Supported image file formats: JPEG, PNG, and ICO.

The require_shortcut field specifies whether the address bar shortcut is required to see search recommendations. If required, suggestions will not be shown in the search box on the New Tab page, but will continue to be shown in the omnibox (address bar) in scoped search mode. If this field is not set, the address bar shortcut is not required.

On Microsoft® Windows®, this policy is only available on instances that are joined to a Microsoft® Active Directory® domain, joined to Microsoft® Azure® Active Directory® or enrolled in Samsung Browser Enterprise Core.

Supported features:

  • Applied to browser without restart. Note that some ongoing tasks may not be affected.
  • Applied at Samsung Browser profile level.

Data type:

Dictionary
Windows:REG_SZ

Windows registry location:

Software\Policies\Samsung\Internet\EnterpriseSearchAggregatorSettings

Schema:

{
  "properties": {
    "icon_url": {
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "require_shortcut": {
      "type": "boolean"
    },
    "search_url": {
      "type": "string"
    },
    "shortcut": {
      "type": "string"
    },
    "suggest_url": {
      "type": "string"
    }
  },
  "required": [
    "name",
    "shortcut",
    "suggest_url",
    "search_url"
  ],
  "type": "object"
}

Example value:

{
  "name": "My Search Aggregator",
  "shortcut": "work",
  "search_url": "https://www.aggregator.com/search?q={searchTerms}",
  "suggest_url": "https://www.aggregator.com/suggest",
  "icon_url": "https://www.google.com/favicon.ico",
  "require_shortcut": true
}

More policies under Miscellaneous: