Skip to content

Commit

Permalink
doc: document usage of qusal TCP proxy
Browse files Browse the repository at this point in the history
  • Loading branch information
ben-grande committed Jun 14, 2024
1 parent e1a15d8 commit afcb730
Show file tree
Hide file tree
Showing 2 changed files with 18 additions and 2 deletions.
10 changes: 8 additions & 2 deletions salt/dev/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,8 @@ Development environment in Qubes OS.

Setup a development qube named "dev". Defines the user interactive shell,
installing goodies, applying dotfiles, being client of sys-pgp, sys-git and
sys-ssh-agent.
sys-ssh-agent. The qube has netvm but can reach remote servers if the policy
allows.

## Installation

Expand Down Expand Up @@ -41,4 +42,9 @@ The development qube `dev` can be used for:
- building programs;
- signing commits, tags, pushes and verifying with split-gpg;
- fetching and pushing to and from local qube repository with split-git; and
- fetching and pushing to and from remote repository with split-ssh-agent.
- fetching and pushing to and from remote repository with split-ssh-agent and
without direct network connection, you can open port to the desired SSH or
HTTP server.

As the qube has no netvm, configure the `qusal.ConnectTCP` service to allow
for it to communicate with a remote repository for example.
10 changes: 10 additions & 0 deletions salt/sys-net/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -59,6 +59,16 @@ sudo qubesctl state.apply sys-net.prefs
You might need to install some firmware on the template for your network
drivers. Check files/admin/firmware.txt.

## Access control

_Default policy_: every call is denied.

Qube `dev` can ask to connect to `github.com:22` from `disp-sys-net`:
```qrexecpolicy
qusal.ConnectTCP +github.com+22 dev @default ask target=disp-sys-net
qusal.ConnectTCP * dev @anyvm deny
```

## Usage

A network manager is provided in `sys-net`, from there you can manager Wi-Fi
Expand Down

0 comments on commit afcb730

Please sign in to comment.