Infisical is the open-source platform for securing secrets, certificates, access, and AI Agents.
TypeScript acmeagentsai-agentscertificate-managementdevsecopsenvironment-variableskubernetesopen-sourcepampkipostgresprivate-caprivileged-access-managementsecret-managementsecret-managersecretssecrets-managementsecuritysecurity-toolsvault
docs(gateways): correct what works without a gateway, and relay health
bernie-g55ad74a00a9f
diff --git a/docs/docs.json b/docs/docs.jsonindex 8cfaf59f58..f1c7f154b5 100644--- a/docs/docs.json+++ b/docs/docs.json@@ -1068,10 +1068,10 @@"icon": "network-wired","pages": ["documentation/platform/gateways/overview",+ "documentation/setup/networking",{"group": "Gateways","pages": [- "documentation/setup/networking","documentation/platform/gateways/network-architecture","documentation/platform/gateways/gateway-deployment","documentation/platform/gateways/gateway-pools",diff --git a/docs/documentation/platform/gateways/overview.mdx b/docs/documentation/platform/gateways/overview.mdxindex 71e5915e81..a7b8d75763 100644--- a/docs/documentation/platform/gateways/overview.mdx+++ b/docs/documentation/platform/gateways/overview.mdx@@ -16,7 +16,7 @@ Some of the systems Infisical connects to aren't reachable from the internet: a</Card></CardGroup>-If the target is already reachable and you would rather not run a gateway, you can instead allow [Infisical's IP addresses](/documentation/setup/networking) through your firewall.+If a target is reachable from the internet, app connections and dynamic secrets can reach it without a gateway by allowing [Infisical Cloud's IP addresses](/documentation/setup/networking) through your firewall. PAM always requires a gateway, as do HSM, ADCS, and discovery.<Info>Gateway is a paid feature available under the Enterprise Tier for Infisical@@ -50,7 +50,11 @@ Infisical connects to the gateway, so there's no relay in the path. Available on## Health checks-Gateways send a heartbeat every 3 minutes, each carrying a TTL that says how long the gateway should be treated as healthy. If no heartbeat arrives before the TTL expires, the gateway is marked unhealthy. Relays send hourly heartbeats and are marked unhealthy if one is missed.+Gateways send a heartbeat every 3 minutes, each carrying a TTL that says how long the gateway should be treated as healthy. If no heartbeat arrives before the TTL expires, the gateway is marked unhealthy.++A gateway running both modes is probed on each transport separately, so it stays healthy while either one works. Its detail page shows the two transports individually, which is how you tell a relay outage from a direct listen one.++Relays send a heartbeat every 30 minutes and are marked unhealthy after an hour without one.Infisical notifies all organization admins of unhealthy gateways and relays by email and in-app notification.diff --git a/docs/documentation/setup/networking.mdx b/docs/documentation/setup/networking.mdxindex 1c25f8b9f9..825d7c6987 100644--- a/docs/documentation/setup/networking.mdx+++ b/docs/documentation/setup/networking.mdx@@ -1,5 +1,5 @@----title: "Networking"+title: "Infisical IP addresses"sidebarTitle: "Infisical IP addresses"description: "Network configuration details for Infisical Cloud"---@@ -34,6 +34,8 @@ Infisical Cloud operates from multiple regions. If your infrastructure has stricThese IP addresses are static and managed by Infisical. Any changes will be communicated with 60-day advance notice.</Warning>-## What these IP addresses are used for+## What connects from these addresses-These IP addresses represent the source IPs you'll see when Infisical Cloud makes connections to your infrastructure. All outbound traffic from Infisical Cloud originates from these IP addresses, ensuring predictable source IP addresses for your firewall rules.+Anything Infisical Cloud reaches over the internet: app connections, dynamic secrets, secret rotation, and secret syncs. Allowing these addresses is what lets those features reach a target that would otherwise refuse the connection.++Features that run work on your side of the network need a [gateway](/documentation/platform/gateways/overview) instead, and allowing these addresses does nothing for them. That covers PAM sessions, HSM, ADCS, and discovery.