redirects.cfg

ON THIS PAGE
This feature is not available to users of the Squiz Experience Cloud version of Funnelback.

Name

redirects.cfg

Location

~/conf/

Description

List of domain-level search package redirections.

Since

v14.2

Results pages are tied to a search package which is expected to be passed as a URL parameter (e.g. ...&collection=my-collection...). However, clients can also connect to the root page of a Funnelback server (e.g. http://search.company.com/ ) without specifying a search package.

This is best used in a multi-tenant system where the Funnelback server can be accessed via different domain names. The domain name is then used to identify a collection and the client is redirected to the search page for it, with possible optional parameters (Setting a profile, a form, or any other URL parameter).

Caveats:

  • Each domain name should be present only once. If a domain name is present multiple times, the behaviour is undefined.

  • Only relative URLs are permitted on the right-hand side. Redirecting to absolute URLs is not permitted for security reasons, to prevent malicious exploitation of the service to redirect users to illegitimate websites.

Format

A text file, where each line contains:

  • A domain name (e.g. search.company.com)

  • An equal (=) sign

  • The URL, relative to the Funnelback server, to which clients should be redirected.

Example

search.company.com=/s/search?collection=company-web&profile=web
mobile.search.company.com=/s/search?collection=company-web&form=mobile
api.search.company.com=/s/search.json?collection=company-api

© 2015- Squiz Pty Ltd