Skip to content

docs: Propose device access to Galactic VPC - #926

Closed
mattdjenkinson wants to merge 1 commit into
mainfrom
feat/connector-vpc-access
Closed

mattdjenkinson wants to merge 1 commit into
mainfrom
feat/connector-vpc-access

Conversation

@mattdjenkinson

Copy link
Copy Markdown
Contributor

Summary

Consumers put workloads in a Galactic VPC to keep them off the public internet, but today the only way for an engineer's own phone, laptop or CI job to reach one is to expose it publicly first, and that only works for HTTP. This proposes letting those devices join a VPC directly over an authenticated tunnel, getting a private address inside it, with access granted per network through Datum IAM and revocable within seconds. It builds on the existing Connectors and Galactic MASQUE proposals, reuses the network-in-every-location binding model rather than adding a parallel one, and leaves exactly one decision open for the networking team: MASQUE CONNECT-IP over iroh (recommended after a short iOS spike) or WireGuard as the fallback. It also flags a peer-authorization gap in the current desktop connector client as a blocking prerequisite, and relates to the internal DNS proposal in #922.

Test plan

  • Networking reviews the tunnel protocol choice and the decision criteria for the spike
  • Security reviews the per-session authorization and revocation design before this moves to implementable
  • Galactic and NSO owners confirm the return-path and binding approach fits their current designs
  • Portal and mobile owners review the device list and connect flows in the user stories

Let a consumer's own devices (phones, laptops, CI runners) join a Galactic
VPC over an authenticated tunnel and reach workloads on their private
addresses. Today connectors only carry traffic from the edge to a service
on a device; nothing lets a device reach into a network.

Key points:
- ConnectorAttachment grants a connector access to a network; the
  connector becomes a NetworkBinding consumer, so presence and readiness
  reuse the network-in-every-location machinery
- A new VPC access gateway terminates device tunnels, authorizes the peer
  key and the user per session, bridges into the tenant VRF over SRv6 and
  advertises the device's address back through BGPAdvertisement
- The tunnel protocol is the open decision: MASQUE CONNECT-IP over iroh
  (recommended, spike first) or WireGuard, behind the same API
- Fixing datum-connect's peer authorization is a blocking prerequisite
@mattdjenkinson mattdjenkinson self-assigned this Oct 12, 2026
@mattdjenkinson

Copy link
Copy Markdown
Contributor Author

Closed: device access to Galactic VPC already exists in datum-cloud/connect (managed gateways, per-device network bindings and CONNECT-IP over iroh), so this proposal duplicates shipped work.

@mattdjenkinson
mattdjenkinson deleted the feat/connector-vpc-access branch October 12, 2026 23:00
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant