---
name: oblien-networking
description: >-
  Oblien workspace networking - firewall rules, private links, public access with preview URLs, dedicated outbound IPs, SSH access, gateway vs direct connections, token management, custom domains, and edge proxy. Workspaces start network-dark; this skill teaches how to open them.
license: MIT
compatibility:
  - claude-code
  - cursor
  - openclaw
  - goose
  - jetbrains-ai
metadata:
  author: oblien
  version: 1.0.0
  source: https://oblien.com/docs
---

# Oblien Workspace Networking

Oblien workspaces start **network-dark** - no inbound traffic is allowed from any source, including other workspaces in the same account. This page teaches you how to:

- Open inbound ports and control the firewall
- Expose ports to the internet with auto-generated HTTPS preview URLs
- Link workspaces together for private workspace-to-workspace communication
- Manage Runtime API tokens (Gateway JWT vs raw connection token)
- Assign dedicated outbound IPs for third-party firewall whitelisting
- Enable SSH access through the Oblien SSH gateway

## Key concepts

- **Inbound is blocked by default.** You must explicitly open `public_access` and/or `ingress_ports`.
- **Private links are one-directional.** A → B allows A to call B, but not the reverse.
- **Gateway JWT** is for external access via `workspace.oblien.com`. **Raw token** is for direct `10.x.x.x:9990` calls from another workspace.
- **Public access** gives each exposed port a unique `https://{hash}.preview.oblien.com` URL.
- **Outbound internet is ON by default** - the `egress` list restricts which hosts are reachable.

---

The reference below covers the networking APIs, conceptual guides, and token management.

## Reference files

Each section below is loaded on demand. Read only what you need for the current task.

- **[Workspace Networking Overview](references/workspace-networking.md)** (194 lines)
- **[Networking Concepts](references/networking.md)** (175 lines)
- **[Edge Proxy](references/edge-proxy.md)** (138 lines)
- **[Network API](references/network.md)** (385 lines)
- **[Public Access API](references/public-access.md)** (249 lines)
- **[Runtime API Access & Tokens](references/runtime-api-access.md)** (293 lines)
- **[SSH API](references/ssh.md)** (298 lines)
- **[Domains API](references/domains.md)** (441 lines)
- **[Edge Proxy API](references/edge-proxy.md)** (149 lines)
- **[Domains Guide](references/domains.md)** (196 lines)

### Quick search

Find specific endpoints, methods, or parameters across all references:

```bash
grep -ri "keyword" references/
```