Skip to content

Commit 52ad390

Browse files
committed
docs: Add documentation for LANGFUSE_WEBHOOK_WHITELISTED_* environment variables
1 parent f5e890a commit 52ad390

File tree

2 files changed

+15
-0
lines changed

2 files changed

+15
-0
lines changed

pages/docs/prompt-management/features/webhooks-slack-integrations.mdx

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -218,3 +218,15 @@ export function verifyLangfuseSignature(
218218
</Tab>
219219

220220
</Tabs>
221+
222+
223+
# Troubleshooting
224+
225+
For security reasons, langfuse will by default not allow users to make webhook requests to local ips oder internal hostnames.
226+
If you try, you might get one of these error messages:
227+
228+
- `Blocked hostname detected`
229+
- `Blocked IP address detected: <some ip>`
230+
- `DNS lookup failed for <some hostname>`
231+
232+
To resolve this problem set one of the corresponding `LANGFUSE_WEBHOOK_WHITELISTED_*` environment variables for the langfuse server. See [Configuration](/self-hosting/configuration) for details.

pages/self-hosting/configuration/index.mdx

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -70,6 +70,9 @@ Langfuse (self-hosted) has extensive configuration options via environment varia
7070
| `LANGFUSE_LOG_LEVEL` | `info` | Set the log level for the application. Possible values are `trace`, `debug`, `info`, `warn`, `error`, `fatal`. |
7171
| `LANGFUSE_LOG_FORMAT` | `text` | Set the log format for the application. Possible values are `text`, `json`. |
7272
| `LANGFUSE_LOG_PROPAGATED_HEADERS` | | Comma-separated list of HTTP header names to propagate through logs via OpenTelemetry baggage. Header names are case-insensitive and will be normalized to lowercase. Useful for debugging and observability. Example: `x-request-id,x-user-id`. |
73+
| `LANGFUSE_WEBHOOK_WHITELISTED_HOST` | `""` | Comma-separated list of webhook hosts, that will not be validated. Use this for accessing local webhook servers.
74+
| `LANGFUSE_WEBHOOK_WHITELISTED_IPS` | `""` | Comma-separated list of webhook resolved ips, that will not be validated. Use this for accessing local webhook servers.
75+
| `LANGFUSE_WEBHOOK_WHITELISTED_IP_SEGMENTS` | `""` | Comma-separated list of local ip ranges, that are allowed to be used as webhook destinations, eventhough they would normally be forbidden by the security policy. Use CIDR syntax for specifying the ranges.
7376

7477
### Additional Features
7578

0 commit comments

Comments
 (0)