Skip to content

Route integration traffic from the Platform through the home-network tunnel #5007

Description

@devantler

🤖 Generated by the Agentic Engineer (interactive Claude Code session)

Evidence

Audience and problem

The maintainer and any integration that needs a home appliance. With the tunnel up but no route through it, an integration on the Platform still cannot reach the appliance, so the bridge does not deliver its purpose.

Hypothesis

If the Platform sends only the traffic that integrations need through the tunnel, integrations can reach the appliances they need, and nothing else on the home network becomes reachable from the Platform by accident.

Success signal

  • An integration on the Platform reaches one named appliance through the tunnel, checked read-only after deployment.
  • Guardrail: a destination on the home network that no integration needs is not reachable from the Platform.

Smallest useful change

Design the onward route for one integration first: which Platform workloads may use the tunnel, how their traffic enters it, and how the allow-list of home destinations is kept. Keep the concrete destinations in the private record #5001 describes, not in this repository.

Acceptance criteria

  • The routing design is decided and recorded, without private network detail in public files.
  • Only workloads that need the bridge can send traffic through it.
  • One integration reaches its appliance through the tunnel after deployment, verified read-only.
  • The VPN design page's status table links this issue.

Size: medium. Depends on #2473 (the tunnel cannot carry traffic until the gateway is a registered peer).

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Fields

    Priority

    None yet

    Start date

    None yet

    Target date

    None yet

    Effort

    None yet

    Projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions