Skip to content

Proxying

GIFramework Maps has an in-built proxy based on Microsoft's YARP. This can be used when layers can't be used with CORS, which is required for rendering layers and making metadata and feature requests.

The proxy can be enabled for specific layers or web service definitions. Read the documentation on those features to see how to enable the proxy.

The proxy directs requests via the application, so an allow list is used to make sure only domains you want to proxy are proxied.

Warning

Proxying requests can reduce performance and may even be blocked by the service provider. If in doubt, check with the service provider.

Relevant tables

Table Name Description
ProxyAllowedHosts Contains a list of allowed hosts that can use the proxy capabilities. Anything not in this list will be rejected by the proxy

ProxyAllowedHosts

This table contains a simple list of all allowed 'hosts'. The host portion includes the domain and any sub-domains, but not the protocol or anything after the domain name.

Example

✅ Good

  • environment.data.gov.uk
  • map.bgs.ac.uk

⚠ Invalid

  • https://mapservice.example.com
  • mapservice.example.com/services/wms