You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/integrations/erp-toolkit/configuration.md
+7-7Lines changed: 7 additions & 7 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -124,7 +124,7 @@ curl -X POST 'https://erp-integration.sls.epilot.io/v1/integrations/{integration
124
124
:::info
125
125
-`file_proxy` — On-demand file serving from external document systems. See the [File Proxy guide](./file-proxy).
126
126
-`managed_call` — Synchronous external API calls with JSONata mapping. See [Managed Call Use Cases](#managed-call-use-cases).
127
-
-`secure_proxy` — Route requests through VPC Lambdas for static IP or VPN access. See [Secure Proxy Use Cases](#secure-proxy-use-cases).
127
+
-`secure_proxy` — Route requests through epilot's secure proxy for static IP or VPN access. See [Secure Proxy Use Cases](#secure-proxy-use-cases).
128
128
:::
129
129
130
130
### Enabling/Disabling a Use Case
@@ -326,7 +326,7 @@ Secrets must use `{{env.KEY}}` references to resolve values from the [Environmen
326
326
327
327
## Secure Proxy Use Cases
328
328
329
-
Secure proxy use cases route HTTP requests through VPC-deployed Lambda functions for static IP egress or VPN access to customer private networks.
329
+
Secure proxy use cases route HTTP requests through epilot's dedicated proxy infrastructure, providing either a static IP for egress or VPN access to customer private networks.
330
330
331
331
### Creating a Secure Proxy Use Case
332
332
@@ -349,9 +349,9 @@ curl -X POST 'https://erp-integration.sls.epilot.io/v1/integrations/{integration
349
349
350
350
| Field | Required | Mutable | Description |
351
351
|-------|----------|---------|-------------|
352
-
|`vpc_mode`| Yes | No (immutable) |`"static_ip"` (NAT Gateway for fixed outbound IP) or `"secure_link"` (VPN for private networks) |
353
-
|`allowed_domains`| No |Admin only | Array of allowed domain patterns. Supports exact match and wildcard prefix (e.g., `*.example.com`). Managed via admin script only. |
354
-
|`allowed_ips`| No |Admin only | Array of allowed IP ranges in CIDR notation (e.g., `10.0.1.0/24`). Required for `secure_link` mode. Managed via admin script only. |
352
+
|`vpc_mode`| Yes | No (immutable) |`"static_ip"` (fixed outbound IP) or `"secure_link"` (VPN for private networks) |
353
+
|`allowed_domains`| No |Read-only | Array of allowed domain patterns. Supports exact match and wildcard prefix (e.g., `*.example.com`). Managed by epilot support. |
354
+
|`allowed_ips`| No |Read-only | Array of allowed IP ranges in CIDR notation (e.g., `10.0.1.0/24`). Required for `secure_link` mode. Managed by epilot support. |
355
355
356
356
### Sending a Proxy Request
357
357
@@ -374,7 +374,7 @@ curl -X POST 'https://erp-integration.sls.epilot.io/v1/secure-proxy' \
374
374
375
375
-**Domain whitelist**: Controls which hostnames the proxy can reach. Wildcard patterns must have at least 2 suffix labels (e.g., `*.example.com` is valid, `*.com` is rejected).
376
376
-**IP allowlist**: Controls which IP addresses are permitted in `secure_link` mode using CIDR notation. Validation is applied both at the URL level (direct IP targets) and DNS level (resolved IPs must match).
377
-
- Both fields are read-only in the API and can only be managed via the admin script (`scripts/manage-secure-proxy-whitelist.ts`).
377
+
- Both fields are read-only in the API. To add, remove, or change allowed domains or IP ranges, contact epilot support.
378
378
379
379
### Security
380
380
@@ -384,7 +384,7 @@ curl -X POST 'https://erp-integration.sls.epilot.io/v1/secure-proxy' \
Copy file name to clipboardExpand all lines: docs/integrations/erp-toolkit/file-proxy.md
+8-8Lines changed: 8 additions & 8 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -283,7 +283,7 @@ If a JSONata expression produces a string result (e.g., for `filename` or `conte
283
283
284
284
## VPC Routing
285
285
286
-
Some external systems require requests to come from known static IPs (IP allowlisting). Set `requires_vpc: true` to route all HTTP requests through a VPC-deployed proxy Lambda with static outbound IPs via NAT gateway.
286
+
Some external systems require requests to come from known static IPs (IP allowlisting). Set `requires_vpc: true` to route all HTTP requests through epilot's secure proxy with a fixed, allowlistable outbound IP.
287
287
288
288
```json
289
289
{
@@ -299,9 +299,9 @@ Some external systems require requests to come from known static IPs (IP allowli
299
299
```
300
300
301
301
When VPC routing is enabled:
302
-
- All step HTTP requests are forwarded to the VPC proxy Lambda
303
-
- The VPC proxy makes the actual outbound call from a static IP
304
-
- Large responses (>4.5 MB) are automatically transferred via S3
302
+
- All step HTTP requests are forwarded through the secure proxy
303
+
- The secure proxy makes the actual outbound call from a static IP
304
+
- Large responses (>4.5 MB) are automatically transferred via a short-lived, presigned download URL
305
305
306
306
## Credentials and Secrets
307
307
@@ -390,11 +390,11 @@ See the [Inbound Mapping Specification](./inbound/mapping#file-proxy-url-mapping
390
390
391
391
## Large File Handling
392
392
393
-
Files larger than 5 MB exceed the Lambda response payload limit. In these cases, the proxy automatically:
393
+
Files larger than 5 MB exceed the inline response payload limit. In these cases, the proxy automatically:
394
394
395
-
1. Uploads the file to a temporary S3 bucket
396
-
2. Returns a `302 Redirect` to a presigned S3 download URL (valid for 5 minutes)
397
-
3. The browser follows the redirect and downloads the file directly from S3
395
+
1. Uploads the file to temporary storage
396
+
2. Returns a `302 Redirect` to a short-lived, presigned download URL (valid for 5 minutes)
397
+
3. The browser follows the redirect and downloads the file directly from the storage location
398
398
399
399
This is transparent to the user and requires no configuration. Temporary files are automatically cleaned up after 24 hours.
|**[Apps](https://marketplace.epilot.cloud/en/apps)**| Custom automation actions and portal extensions for ERP logic | In progress |
@@ -52,7 +52,7 @@ The `/v2/integrations` CRUD API centralizes all integration configuration in one
52
52
-**Inbound use cases** with entity mappings
53
53
-**Outbound use cases** with event mappings
54
54
-**Managed call use cases** for synchronous external API calls (connector integrations)
55
-
-**Secure proxy use cases** for VPC-routed HTTP requests
55
+
-**Secure proxy use cases** for HTTP requests routed through a static IP or VPN
56
56
-**Associated Apps and portal extensions**
57
57
58
58
Integrations support two types: `erp` (default, for standard ERP flows) and `connector` (for complex proxy integrations with external APIs).
@@ -93,16 +93,16 @@ Key capabilities:
93
93
-**Authentication** — OAuth2 client credentials, API key, or bearer token with automatic token management
94
94
-**JSONata mapping** — Transform request and response payloads using JSONata expressions
95
95
-**Inbound routing** — Optionally queue the response to the inbound pipeline for async entity processing
96
-
-**Secure proxy support** — Route calls through static IP or VPN VPCs when needed
96
+
-**Secure proxy support** — Route calls through a static IP or VPN connection when needed
97
97
98
98
See the [Configuration Guide](./configuration#managed-call-use-cases) for setup details.
99
99
100
100
### Secure Proxy
101
101
102
-
The Secure Proxy routes HTTP requests through VPC-deployed Lambda functions, providing either **static IP egress** (for IP-allowlisted external APIs) or **VPN access** (for customer private networks). It acts as the single authenticated gateway between epilot and customer networks.
102
+
The Secure Proxy routes HTTP requests through epilot's dedicated proxy infrastructure, providing either **static IP egress** (for IP-allowlisted external APIs) or **VPN access** (for customer private networks). It acts as the single authenticated gateway between epilot and customer networks.
103
103
104
-
-**Static IP mode** — Routes through a NAT Gateway for a fixed outbound IP address
105
-
-**Secure Link mode** — Routes through a VPN-connected VPC for access to private networks
104
+
-**Static IP mode** — Routes outbound requests from a fixed, allowlistable IP address
105
+
-**Secure Link mode** — Routes through a VPN connection for access to private networks
106
106
- Domain whitelisting and CIDR-based IP allowlisting enforce strict access control
107
107
108
108
See the [Configuration Guide](./configuration#secure-proxy-use-cases) for setup details.
0 commit comments