All requests to your API will come from the Sulu Hub Gateway. The gateway acts as a reverse proxy, forwarding requests to your API and returning the response to the client. Our gateway is designed to be fast, secure, and reliable. It is built to be as transparent as possible, so you can focus on building your API.

​
Static IP Addresses

The Sulu Hub Gateway uses a set of static IP addresses to connect to your API.

We recommend whitelisting these IPs in your firewall or security group to ensure that only requests from the Sulu Hub Gateway are allowed, and to prevent services like Cloudflare from blocking our requests.

You will notice that these IPs are regional. This is because we use a global infrastructure to bring your API closer to your customers. As we grow, we will add more regions and IPs to our gateway. We recommend whitelisting all the IPs to ensure that your API is accessible from all regions. If there is a regional outage, we will automatically route traffic to the next closest region.

RegionIP
europe-west104.199.53.178
asia-east35.201.167.86
us coming sooncoming-soon

This document will be updated regularly with the latest IPs and regions.

For programmatic access, we recommend using the Sulu Hub API to get the latest IPs.

GET https://sparkhub.sulu.sh/api/proxy

{
    "ip_list":{
        "asia-east1":"35.201.167.86",
        "europe-west1":"104.199.53.178"
    }
}

​
Special Headers

The Sulu Hub Gateway adds a few special headers to the requests it forwards to your API backend. These can be useful for authentication, debugging, and monitoring your API.

We are transitioning from Sparkhub to Sulu Hub. During the process, every new header will use Suluhub instead of Sparkhub. Headers like X-Sparkhub-Secret will be replaced by X-Suluhub-Secret, but both will be supported for a while. Please make sure to update your code to use the new headers.

  • X-Sparkhub-Secret: This header contains a secret key that you can use to authenticate requests from the Sulu Hub Gateway.
  • X-Suluhub-Userid: This header contains a unique anonymized user ID that you can use to track requests from the Sulu Hub Gateway. For example, it can be used to monitor the usage of your API by different customers.
WalkthroughProducer Dashboard