Skip to main content

Servers

Link can connect to a server in one of two ways:

  1. Through a BTP destination service
  2. Through a proxy

App Settings​

{
  "Servers": [ 
    {
      "Name": "devecc-principle-propagation",
      "BTP": {
        "DestinationName": "sapecc-dev-principle-propagation" 
      },
      "Headers":
      {
        "HeaderName": "x-sap-security-session",
        "Enabled": false
      }
    },
    {
      "Name": "link-qa",
      "Proxy": {
        "URL": "https://[yourproxyinstance].com"
      },
      "Headers":
      {
        "HeaderName": "x-load-balance-key",
        "Value": "qa-instance-1"
      }
    }
  ]
}

BTP Config Example​

Servers__0__Name: devecc-principle-propagation
Servers__0__BTP__DestinationName: sapecc-dev-principle-propagation
Servers__0__Headers__0__HeaderName: x-sap-security-session
Servers__0__Headers__0__Value: disabled
Servers__0__Headers__0__Enabled: false
Servers__1__Name: link-qa
Servers__1__Proxy__URL: https://[yourproxyinstance].com
Servers__1__Headers__0__HeaderName: x-load-balance-key
Servers__1__Headers__0__Value: qa-instance-1

BTP Destination Configuration​

API Proxy can be configured through a BTP Destination to connect to SAP. This is the preferred method of connecting to a SAP. Destinations used by Link must meet certain requirements. For more information see Destination Configuration.

Proxy Configuration​

Link can be configured through a Proxy to connect to SAP. The proxy is configured by URL and must pass requests through to the SAP system.

Headers​

Link can be configured to add additional headers on every SAP request. This can be used to specify headers on api proxies as api proxy requests only support headers present on the api specification file. If a header is specified as a default and on the request (and defined on the api spec), the value on the individual request will take precedent.

To define a header, a Headers__0__HeaderName and Headers__0__Value must be configured on the server. Multiple headers can be added by incrementing the 0.

  • Servers__0__Headers__0__HeaderName: x-load-balance-key
  • Servers__0__Headers__0__Value: qa-instance-1

By default, a "x-sap-security-session:disabled" header is included in accordance with SAP Note 2754328. This default header can be disabled by setting the following values for the desired server connection:

  • Servers__[Server_Index]__Headers__0__HeaderName: x-sap-security-session
  • Servers__[Server_Index]__Headers__0__Enabled: false