AWS Lambda
AWS Lambda source for walkerOS. Works across API Gateway REST (v1), API Gateway HTTP (v2), Lambda Function URLs, and direct invocation. Auto-detects the API Gateway version, supports optional pixel tracking with a 1x1 GIF response, and exposes a built-in health check endpoint.
The AWS Lambda source is a server source in the walkerOS flow:
It receives events via HTTP and forwards them to your destinations.
Installation
- Integrated
- Bundled
Add to your flow.json sources:
Server sources require platform-specific handlers. For containerized deployments, see Docker.
Configuration
This source uses the standard source config wrapper (consent, data, env, id, ...). For the shared fields see source configuration. Package-specific fields live under config.settings and are listed below.
Settings
| Property | Type | Description | More |
|---|---|---|---|
cors | boolean | object | CORS configuration: false = disabled, true = allow all origins, object = custom configuration | |
timeout | integer | Request timeout in milliseconds (max: 900000 for Lambda) | |
enablePixelTracking | boolean | Enable GET requests with 1x1 transparent GIF response for pixel tracking | |
healthPath | string | Health check endpoint path (e.g., /health) |
Mapping
This package does not define custom rule-level settings. For the standard rule fields (consent, condition, data, batch, name, policy) see mapping.
Examples
API Gateway v1 POST
A REST API Gateway v1 POST request with a JSON body is converted into a walker elb event.
Lambda GET
An API Gateway v2 HTTP GET with query parameters is parsed into an elb event payload.
Lambda POST
An API Gateway v2 HTTP POST with a JSON body is converted into a walker elb event.
Ingest metadata
Extract request metadata from Lambda events and forward it through the pipeline.
Available ingest paths
API Gateway v1 (REST API):
| Path | Description |
|---|---|
requestContext.identity.sourceIp | Client IP address |
requestContext.identity.userAgent | User agent string |
headers.* | HTTP headers |
httpMethod | HTTP method |
API Gateway v2 (HTTP API) / Function URLs:
| Path | Description |
|---|---|
requestContext.http.sourceIp | Client IP address |
requestContext.http.userAgent | User agent string |
requestContext.http.method | HTTP method |
headers.* | HTTP headers |
Supported platforms
| Platform | Status |
|---|---|
| API Gateway REST API (v1) | Supported |
| API Gateway HTTP API (v2) | Supported |
| Lambda Function URLs | Supported |
| Direct Lambda invocation | Supported |