Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 8 additions & 2 deletions browsers/live-view.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -79,9 +79,15 @@ If your environment restricts outbound traffic, allow the [Live View domains and
If your application uses a **Content Security Policy (CSP)**, you must add the following directives to allow the live view iframe and its WebSocket connection. See [firewall allowlist](/info/network-access#content-security-policy) for the complete firewall and CSP requirements.

```
frame-src https://*.onkernel.com:8443
frame-src https://*.onkernel.com
https://*.kernel.sh
https://*.onkernel.com:8443
https://*.kernel.sh:8443;
connect-src https://*.onkernel.com:8443
connect-src https://*.onkernel.com
wss://*.onkernel.com
https://*.kernel.sh
wss://*.kernel.sh
https://*.onkernel.com:8443
wss://*.onkernel.com:8443
https://*.kernel.sh:8443
wss://*.kernel.sh:8443;
Expand Down
2 changes: 1 addition & 1 deletion browsers/replays.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -249,7 +249,7 @@ Replace `REPLAY_VIEW_URL` with the URL returned by the API:
```html
<meta
http-equiv="Content-Security-Policy"
content="frame-src https://*.kernel.sh:8443 https://*.onkernel.com:8443 https://kernel-api-prod.s3.us-east-1.amazonaws.com;"
content="frame-src https://*.kernel.sh https://*.onkernel.com https://*.kernel.sh:8443 https://*.onkernel.com:8443 https://kernel-api-prod.s3.us-east-1.amazonaws.com;"
>

<div style="width: 100%; aspect-ratio: 16 / 10;">
Expand Down
20 changes: 15 additions & 5 deletions info/network-access.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@ Allow only the destinations used by your integration. Apply the Live View and re
| --- | --- | --- | --- |
| API, SDKs, and authenticated CLI requests | `api.onkernel.com` | `443` | HTTPS |
| CLI authentication (`kernel login`) | `auth.onkernel.com`, `dashboard.onkernel.com` | `443` | HTTPS |
| CDP, WebDriver BiDi, Live View, replays, and app connections | `*.onkernel.com`, `*.kernel.sh` | `8443` | HTTPS and secure WebSocket (WSS) |
| CDP, WebDriver BiDi, Live View, replays, and app connections | `*.onkernel.com`, `*.kernel.sh` | `443`, `8443` | HTTPS and secure WebSocket (WSS) |
| Live View media negotiation | `stun.relay.metered.ca` | `80` | STUN over UDP |
| Live View media relay | `global.relay.metered.ca` | `443` | TURN over UDP or TLS/TCP |
| Replay files | `kernel-api-prod.s3.us-east-1.amazonaws.com` | `443` | HTTPS |
Expand All @@ -23,6 +23,8 @@ Allow only the destinations used by your integration. Apply the Live View and re
Allow both wildcard domains. Don't copy a single hostname from a returned `cdp_ws_url`, `webdriver_ws_url`, or `browser_live_view_url`, because that hostname can change between sessions.
</Note>

Browser URLs are moving to port `443`, which omits `:8443`. Allow both ports during the rollout and use URLs returned by the API without rewriting them.

## Content security policy

A network allowlist permits traffic leaving your environment. A Content Security Policy (CSP) permits content loaded by your web application. If you embed Live View or replays, configure both.
Expand All @@ -32,9 +34,15 @@ A network allowlist permits traffic leaving your environment. A Content Security
Merge these sources into your application's existing CSP:

```text
frame-src https://*.onkernel.com:8443
frame-src https://*.onkernel.com
https://*.kernel.sh
https://*.onkernel.com:8443
https://*.kernel.sh:8443;
connect-src https://*.onkernel.com:8443
connect-src https://*.onkernel.com
wss://*.onkernel.com
https://*.kernel.sh
wss://*.kernel.sh
https://*.onkernel.com:8443
wss://*.onkernel.com:8443
https://*.kernel.sh:8443
wss://*.kernel.sh:8443;
Expand All @@ -45,7 +53,9 @@ connect-src https://*.onkernel.com:8443
Merge these sources into your application's existing `frame-src` directive:

```text
frame-src https://*.onkernel.com:8443
frame-src https://*.onkernel.com
https://*.kernel.sh
https://*.onkernel.com:8443
https://*.kernel.sh:8443
https://kernel-api-prod.s3.us-east-1.amazonaws.com;
```
Expand All @@ -54,6 +64,6 @@ frame-src https://*.onkernel.com:8443

- If API, SDK, or authenticated CLI requests time out, verify access to `api.onkernel.com:443`.
- If `kernel login` doesn't complete, verify access to `auth.onkernel.com:443` and `dashboard.onkernel.com:443`.
- If browser creation succeeds but CDP, WebDriver BiDi, or Live View won't connect, verify access to both wildcard domains on port `8443`.
- If browser creation succeeds but CDP, WebDriver BiDi, or Live View won't connect, verify access to both wildcard domains on ports `443` and `8443`.
- If Live View loads but remains disconnected or doesn't show video, verify access to the STUN and TURN destinations.
- If the replay player loads but a recording doesn't play, verify access to the replay file destination.
2 changes: 1 addition & 1 deletion security-vulnerability-reporting.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -81,7 +81,7 @@ Reports against Tier 1 assets receive the highest bounty consideration and are r
| Asset | Surface |
|---|---|
| `api.onkernel.com` | Control plane REST API: `/browsers`, `/browser_pools`, `/auth/connections`, `/credentials`, `/profiles`, `/proxies`, `/extensions`, `/apps`, `/deployments`, `/invocations`, `/projects`, `/org/*`, `/audit-logs`, `/authmd/*` |
| `*.kernel.sh:8443` | Metro data plane: `/browser/cdp`, `/browser/webdriver/session`, `/browser/live`, `/browser/live/{slug}`, `/browser/replays`, `/browser/kernel/*`, `/apps/*` |
| `*.kernel.sh:443`, `*.kernel.sh:8443` | Metro data plane: `/browser/cdp`, `/browser/webdriver/session`, `/browser/live`, `/browser/live/{slug}`, `/browser/replays`, `/browser/kernel/*`, `/apps/*` |
| Session tokens | Session JWT issuance, validation, scoping, expiry, and revocation |
| **VM and session isolation** | Escape from a browser session VM to the host or hypervisor; cross tenant access between sessions; isolation boundary bypasses; leakage of credentials, cookies, or profile data across session boundaries |
| `dashboard.onkernel.com` | Customer dashboard, org and project authorization boundaries |
Expand Down
Loading